blojsim - installation

home | download | installation | faq | changelog | upgrading | roadmap | javadocs | Sourceforge

requirements

• Installed instance of blojsom v1.8 or newer
• Account on the IM service(s) you plan to use that blojsim can connect using
• Servlet 2.3 compliant application server (e.g. Jakarta Tomcat 4.1.18)
• Java 1.4.x runtime

installation and default configuration

1. Download blojsim.

2. Unpack blojsim.war using Java's JAR program (jar xvf blojsim.war) into the directory where you unpacked blojsom

3. Configure the /WEB-INF/blojsim.properties file for your Instant Message settings.

Configuration parameter	Default value	Usage
valid-posters		Points to file that contains a list of Instant Message accounts that are allowed to post to this blog. For example: /WEB-INF/valid.posters NOTE: This file contains a single IM id per line.
jabber-userid		The userid to use when connecting to the Jabber server
jabber-password		The password to use when connecting to the Jabber server
jabber-server	jabber.org	The alternate Jabber server to connect to
aim-userid		The userid to use when connecting to the AIM server
aim-password		The password to use when connecting to the AIM server
aim-server	toc.oscar.aol.com	The alternate AIM server to connect to
aim-server-port	9898	The alternate port to use when connecting to the AIM server
msn-userid		The userid to use when connecting to the MSN server
msn-password		The password to use when connecting to the MSN server

4. Add the following to your /WEB-INF/web.xml

    <servlet>
        <servlet-name>blojsim</servlet-name>
        <servlet-class>org.ignition.blojsom.extension.blojsim.BlojsimJabberServlet</servlet-class>
        <init-param>
            <param-name>blog-configuration</param-name>
            <param-value>/WEB-INF/blojsom.properties</param-value>
        </init-param>
        <init-param>
            <param-name>blojsim-configuration</param-name>
            <param-value>/WEB-INF/blojsim.properties</param-value>
        </init-param>
        <load-on-startup>5</load-on-startup>
    </servlet>

5. Edit the contents of your valid poster file (default is /WEB-INF/valid.posters) to enable to can post to your blog. An example file is provided.

6. Restart you application server and IM!