Sun Java System Instant Messaging 7 2006Q1 Administration Guide

Configuring Server-to-Server Communication Between Instant Messaging Servers in a Server Pool

This section describes how to enable communication between two Instant Messaging servers, or peers, in a server pool. You must configure all servers in the pool with information about all other servers in the pool.

Table 5–1 lists the parameters in iim.conf and their values used to set up communication for two example Instant Messaging servers in a server pool; iimA.siroe.com and iimB.siroe.com.

For more information on the configuration parameters, see Appendix A, Instant Messaging Configuration Parameters in iim.conf.

Table 5–1 Example Configuration Information for Two Instant Messaging Servers in a Server Pool


Parameter in `iim.conf`	Value for Server A	Value for Server B	Notes
`iim_server.serverid`	`iimA.siroe.com`	`iimB.siroe.com`	In a server pool, this ID is used to support the dialback mechanism and is not used for authentication. This value should be unique within the server pool.
`iim_server.password`	`secretforiimA`	`secret4iimB`
`iim_server.coservers`	`coserver1`	`coserver1`	Each Instant Messaging server is identified by its symbolic name. The symbolic name of the server is added in the `iim_server.coservers` parameter in `iim.conf`. This parameter may contain multiple, comma-separated values.
`iim_server.domainname`	`siroe.com`	`siroe.com`	Peer servers within a server pool share the same default domain.
`iim_server.coserver1.host`	`iimB.siroe.com:9919`	`iimA.siroe.com:9919`
`iim_server.coserver1.serverid`	`siroe.com`	`siroe.com`
`iim_server.coserver1.password`	`secret4iimB`	`secretforiimA`
`iim_server.coserver1.domain`	`siroe.com`	`siroe.com`	Peer servers within a server pool share the same default domain.

To Set Up Communication Between Two Instant Messaging Servers in a Server Pool

Steps

Gather the information listed in Table 5–1.

Change to im_cfg_base on the server iimA.siroe.com.

See Instant Messaging Server Directory Structure for instructions on locating im_cfg_base.

Open iim.conf.

See iim.conf File Syntax for instructions on locating and modifying iim.conf.

Note –
The iim.conf file should be owned by the Instant Messaging server account you created during installation. If the iim.conf file cannot be read by the Instant Messaging server account, the server and multiplexor will be unable to read the configuration. Additionally, you might lose the ability to edit iim.conf.

Modify the parameter values to match your deployment.

Table 6–1 lists the parameters you need to modify. If the parameters do not exist in iim.conf, add them. The following example shows the section of iim.conf on iimA.siroe.com corresponding to the server-to-server communications that you need to modify:

iim_server.serverid=iimA.siroe.com
iim_server.password=secretforiimA
iim_server.domain=siroe.com
iim_server.coservers=coserver1
iim_server.coserver1.host=iimB.siroe.com:9919
iim_server.coserver1.serverid=iimB.siroe.com
iim_server.coserver1.password=secret4iimB
iim_server.coserver1.domain=siroe.com

Follow steps 2 through 4 for the iim.conf file on server iimB.siroe.com.

The following example shows the section of iim.conf on iimB.siroe.com corresponding to the server-to-server communications that you need to modify:

iim_server.serverid=iimB.siroe.com
iim_server.password=secret4iimB
iim_server.domain=siroe.com
iim_server.coservers=coserver1
iim_server.coserver1.host=iimA.siroe.com:9919
iim_server.coserver1.serverid=iimA.siroe.com
iim_server.coserver1.password=secretforiimA
iim_server.coserver1.domain=siroe.com

Save the changes and close iim.conf.

Refresh the configuration on both servers.
imadmin refresh server
Caution –
Do not use the imadmin start, imadmin stop, or imadmin refresh commands in an HA environment with Sun Cluster. Instead, use the Sun Cluster administrative utilities.