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 6–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 6–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:5269 |
iimA.siroe.com:5269 |
The hostname and port number of the peer server in the server pool. |
iim_server.coserver1.serverid |
iimB.siroe.com |
iimA.siroe.com |
The server ID (iim_server.serverid) of the peer server in the server pool. |
iim_server.coserver1.password |
secret4iimB |
secretforiimA |
The password (iim_server.password) of the peer server in the server pool. |
iim_server.coserver1.domain |
siroe.com |
siroe.com |
Peer servers within a server pool share the same default domain. |
Gather the information listed in Table 6–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 Appendix A, Instant Messaging Configuration Parameters in iim.conf for instructions on locating and modifying iim.conf.
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 8–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.domainname=siroe.com iim_server.coservers=coserver1 iim_server.coserver1.host=iimB.siroe.com:5269 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.domainname=siroe.com iim_server.coservers=coserver1 iim_server.coserver1.host=iimA.siroe.com:5269 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 |