Sun Java System Communications Services 2005Q4 Release Notes

Configuring the HA Environment

The steps you need to perform vary depending on whether or not you are using a local or shared disk for configuration files and binaries.

If you are using a local disk for configuration files and binaries, follow the steps in the following two procedures:

If you are using a shared disk for configuration files and binaries, follow the steps in the following two procedures:

ProcedureTo Configure HA on Node 1 Using a Local Disk for Configuration Files and Binaries

Before You Begin

Fill out the checklists in Chapter 1 of the Sun Java System Instant Messaging 7 2005Q1 Administration Guide and Table 3–8 and have your answers readily available.

  1. Install products and packages using the Java Enterprise System installer.

    See Selecting the Installation Directory (im_svr_base ) for specific instructions on choosing an installation directory.

    See Table 3–9 for a list of required products and packages for HA. Refer to the Sun Java Enterprise System 2005Q4 Installation Guide for specific instructions.

  2. If you are using HAStoragePlus for the runtime files, mount a shared disk to a local directory, otherwise skip to Step 3.

    For example:

    1. Create the mount point (/local/ im/im_runtime_base/) if it does not already exist.

      When prompted during configuration in Step 4 you will specify this directory (/local /im/im_runtime_base/ ) as the Instant Messaging Server Runtime Files Directory.

    2. Use the mount command to mount the disk on /local/im/im_runtime_base.

  3. Run the configure utility.

    See the Sun Java System Instant Messaging 7 2005Q1 Administration Guide for instructions.

  4. When prompted for the Instant Messaging Server Runtime Files Directory, enter one of the following:

    • If you are using an HAStoragePlus for the runtime files, enter /local/im/im_runtime_base /.

    • If you are using a cluster file system for the runtime files, enter /global/im/im_runtime_base /. Where /global/ im is the global directory in the cluster file system.

  5. When prompted for the Instant Messaging host name, enter the logical host.

    Choose to accept the logical host even if the configure utility cannot connect to the specified host. The logical host resource may be offline at the time you run the configure utility.

  6. Do not choose to start Instant Messaging after configuration or on system startup.

    In an HA configuration, the Instant Messaging service also requires the logical host to be online for Instant Messaging to work properly.

  7. If you are using HAStoragePlus for runtime files, unmount the shared disk.

ProcedureTo Configure HA on Node n Using a Local Disk for Configuration Files and Binaries

Before You Begin

Ensure that you have completed HA configuration on Node 1 as described in the previous procedure (To Configure HA on Node 1 Using a Local Disk for Configuration Files and Binaries).

Have your answers for the checklists in Chapter 1 of the Sun Java System Instant Messaging 7 2005Q1 Administration Guide and Table 3–8 readily available.

  1. Install products and packages using the Java Enterprise System installer.

    Choose the same path you used when you installed Instant Messaging on node 1 for each subsequent node in the cluster. See Selecting the Installation Directory (im_svr_base ) for specific instructions.

    See Table 3–9 for a list of required products and packages for HA. Refer to the Sun Java Enterprise System 2005Q4 Installation Guide for specific instructions.

  2. Run the configure utility.

    See Chapter 1 of the Sun Java System Instant Messaging 7 2005Q1 Administration Guide for instructions.

  3. When prompted for the Instant Messaging Server Runtime Files Directory, enter the same value that you provided for Node 1.

  4. When prompted for the Instant Messaging host name, enter the same logical host you provided for Node 1.

    Choose to accept the logical host even if the configure utility cannot connect to the specified host. The logical host resource may be offline at the time you run the configure utility.

  5. When prompted for the user and group, enter the same value that you provided for Node 1.

  6. Do not choose to start Instant Messaging after configuration or on system startup.

    In an HA configuration, the Instant Messaging service also requires the logical host to be online for Instant Messaging to work properly.

ProcedureTo Configure HA on Node 1 Using a Shared Disk for Configuration Files and Binaries

Before You Begin

Fill out the checklists in Chapter 1 of the Sun Java System Instant Messaging 7 2005Q1 Administration Guide and Table 3–8 and have your answers readily available.

You must use a cluster file system if you are using a shared disk for configuration files and binaries, not HAStoragePlus.

  1. Install products and packages in a directory in the cluster file system using the Java Enterprise System installer.

    When you install Instant Messaging, you must specify a directory other than the default directory. See Selecting the Installation Directory (im_svr_base ) for specific instructions.

    See Table 3–9 for a list of required products and packages for HA. Refer to the Sun Java Enterprise System 2005Q4 Installation Guide for specific instructions.

  2. Create a soft link from /etc/opt/SUNWiim that points to /global/im/etc/opt/SUNWiim .

  3. Run the configure utility from the global directory where you installed Instant Messaging (/global/ im/im_svr_base/configure ).

    See Chapter 1 of the Sun Java System Instant Messaging 7 2005Q1 Administration Guide for instructions.

  4. When prompted for the Instant Messaging Server Runtime Files Directory, enter the value for /global/im/ im_runtime_base.

  5. When prompted for the Instant Messaging host name, enter the logical host.

    Choose to accept the logical host even if the configure utility cannot connect to the specified host. The logical host resource may be offline at the time you run the configure utility.

  6. Do not choose to start Instant Messaging after configuration or on system startup.

    In an HA configuration, the Instant Messaging service also requires the logical host to be online for Instant Messaging to work properly.

ProcedureTo Configure HA on Node n Using a Shared Disk for Configuration Files and Binaries

Before You Begin

Ensure that you have completed HA configuration on Node 1 as described in the previous procedure (To Configure HA on Node 1 Using a Shared Disk for Configuration Files and Binaries).

Have your answers for the checklists in Chapter 1 of the Sun Java System Instant Messaging 7 2005Q1 Administration Guide and Table 3–8 readily available.

  1. Create a soft link from /etc/opt/SUNWiim that points to /global/im/etc/opt/SUNWiim .

  2. Create a soft link for the resource type registration (RTR) file:


    ln -s /global/im/
    im_svr_base/cluster/SUNW.iim  \
    /usr/cluster/lib/rgm/rtreg/SUNW.iim