Sun Java System Instant Messaging 7.2 Administration Guide

Configuring an Instant Messaging Server Instance as a Redirect Server

To specify that a server instance is a redirect server, you need to provide a value for the iim_server.redirect.provider parameter in iim.conf. Once you have designated the instance as a redirect server, you will need to provide further configuration information by specifying values for additional redirect-specific parameters in iim.conf. Table 7–1 describes the redirect configuration parameters.

Table 7–1 Redirect Server Configuration Parameters in iim.conf


Parameter	Default Value	Description
`iim_server.redirect.provider`	None	Comma-separated list of redirect provider names or classes that implement the `com.sun.im.provider.Redirector` interface. Any value for this parameter defines the server instance as a redirect server. Supported values include `db`, `roundrobin`, `regex`, and class names that implement the `com.sun.im.provider.Redirector` interface.
`iim_server.redirect.to`	None	Comma-separated list of nodes to which this redirect server may redirect client connections. Node names can be any alphanumeric string. This list may be a superset of the hosts defined in `iim_server.redirect.to.nodename.host`.
`iim_server.redirect.to.nodename.host`	None	Where nodename is the name of the node as it exists in `iim_server.redirect.to`. This attribute is required for nodename to be used by the redirect server.
`iim_server.redirect.to.nodename.usessl`	False	If true, then nodename is configured to use legacy SSL. See Overview of Using TLS and Legacy SSL in Instant Messaging for more information.
`iim_server.redirect.db.users`	`im-db-base/redirect.db`	Name and location of the redirect database.
`iim_server.redirect.db.partitions`	`im-cfg-base/redirect.partitions`	Name and location of the redirect partitions file.
`iim_server.redirect.db.partitionsize`	5000	The maximum number of users in a partition.
`iim_server.redirect.roundrobin.partitions`	`im-cfg-base/redirect.partitions`	Name and location of the redirect partitions file.
`iim_server.redirect.pollfrequency`		The interval between connections made by the redirect server to the hosts defined in the `redirect.hosts` file. The redirect server polls these hosts to determine if they are online and able to accept client connections.

To Configure an Instant Messaging Server as a Redirect Server

Before You Begin

You cannot use versions of Instant Messenger older than 2006Q1 with the redirect server. If you use a third party client, ensure that the client supports XMPP redirection.

Gather the information in Table 7–1 above.

Open iim.conf.

See Appendix A, Instant Messaging Configuration Parameters in iim.conf for instructions on locating and modifying this file.

Modify the parameter values to match your deployment.

Table 7–1 lists the parameters for which you need to provide values. If the parameters do not exist in iim.conf, add them. The following example shows the section of iim.conf on iim.siroe.com corresponding to the redirect server parameters you need to modify.

iim_server.redirect.provider=db,roundrobin
iim_server.redirect.to=imserverA,imserverB
iim_server.redirect.to.imserverA.host=iimA.siroe.com
iim_server.redirect.to.imserverB.host=iimB.siroe.com
iim_server.redirect.to.imserverA.usessl=false
iim_server.redirect.to.imserverB.usessl=false

Save your changes and close iim.conf.

Refresh the configuration on the redirect server.
imadmin refresh server

Configure clients to connect to the redirect server instead of the multiplexor.