Managing the HA RTR File for Instant Messaging (Sun Java System Communications Services 2005Q4 Release Notes)

Sun Java System Communications Services 2005Q4 Release Notes

Managing the HA RTR File for Instant Messaging

The resource type registration (RTR) file is an ASCII text file that describes a highly-available resource type that runs under the control of the Resource Group Manager (RGM). The RTR file is used as an input file by the scrgadm command to register the resource type into the cluster configuration. The Instant Messaging RTR file, SUNW.iim, is created when you install the SUNWiimsc package during HA configuration.

This section provides information about managing this file in the following sections:

Instant Messaging RTR File Parameters

The following table lists the extension properties in the Instant Messaging RTR file (SUNW.iim) that are specific to Instant Messaging.

Table 3–10 SUNW.iim Extension Properties


Extension Property	Default	Description
`Server_Root`	If you are using a local disk to store configuration files and binaries: `im_svr_base` If you are using a shared directory to store configuration files and binaries: /`global`/`im`/`im_svr_base`	Defines the absolute path to the Instant Messaging server installation directory. By default, `im_svr_base` is `/opt/SUNWiim` on Solaris.
`Confdir_list`	None	Defines the absolute path to the Instant Messaging configuration. This value is set during the installation of `SUNWiimsc`.
`Monitor_retry_count`	`4`	Defines how many times you want the process monitor facility (PMF) to attempt to restart the fault monitor if it determines it is not running.
`Monitor_retry_interval`	`2` (minutes)	Time, in minutes, between restart attempts made by the PMF on the fault monitor.
`Probe_timeout`	`30` (seconds)	Time, in seconds, that the Sun Cluster probe will wait for a successful connection to Instant Messaging.
`Failover_enabled`	`True`	Determines whether or not to failover to another node if the configured number of retries (`retry_count`) is exceeded during the configured retry interval (`retry_interval`). See the Sun Cluster Reference Manual for Solaris OS for more information on retry and other parameters.

Customizing the RTR File for Instant Messaging

You can modify the values for several of the extension properties in the Instant Messaging RTR file (SUNW.iim) to configure your HA environment. Extension properties are properties that are specific to the resource type. These properties are inherited by every resource of the same type. Instant Messaging extension properties are described in Instant Messaging RTR File Parameters.

See the documentation for rt_reg and property_attributes in the Sun Cluster Reference Manual for Solaris OS for more information on the contents of resource type registration files and instructions on customizing values for extension properties.