Fran├žais English
Installation 1.5

Prerequisite

Get Maven 2 and install it.

Configure

Edit:
openim-server/src/main/resources/META-INF/plexus/components.xml
And set the appropriate hostname.

Build

Lauch maven using command line: mvn install

Run

Use run.sh shell script.



Installation Legacy version (1.2.x)


You can download PDF install guide

Prerequisite

For version 1.2 get last Merlin 3.2 binary version
For version 1.2.2 get Merlin 3.3.x
Unzip the archive.


Setup

Set your env variable
JAVA_HOME to jdk folder
MERLIN_HOME to Merlin folder
OPENIM_HOME to OpenIM folder


The hostname value should the same you use with a client software when setting up the user jabber id (server name). You can use localhost if you are running the server on your workstation.

If you are behind a firewall (using http proxy) configure merlin
$OPENIM_HOME/conf/kernel.xml
If you are using Merlin 3.3.0 check this info page.


Config file

Edit the conf/config.xml file and set the hostname. The hostname value should the same you use with a client software when setting up the user jabber id (server name). You can use localhost if you are running the server on your workstation.


Use SSL

You can generate your own SSL key if required.

Go to keystore folder
# cd openim/sockets/manager/conf/

Use keytool to generate a keystore file (default password is set to "openim" in impl/conf/block.xml file)
# keytool -genkey -keyalg RSA -alias openimRSA -keystore keystore