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


Default Value 




Comma-separated list of redirect provider names or classes that implement the 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 interface.


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


Where nodename is the name of the node as it exists in This attribute is required for nodename to be used by the redirect server.


If true, then nodename is configured to use legacy SSL. See Overview of Using TLS and Legacy SSL in Instant Messaging for more information.



Name and location of the redirect database. 



Name and location of the redirect partitions file. 



The maximum number of users in a partition. 



Name and location of the redirect partitions file. 



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.

ProcedureTo 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.

  1. Gather the information in Table 7–1 above.

  2. Open iim.conf.

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

  3. 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 corresponding to the redirect server parameters you need to modify.

  4. Save your changes and close iim.conf.

  5. Refresh the configuration on the redirect server.

    imadmin refresh server
  6. Configure clients to connect to the redirect server instead of the multiplexor.