Upgrading to Instant Messaging 7.3

This section describes how to upgrade Instant Messaging 7.2 to 7.3 using commpkg upgrade. If you are upgrading from 7.1 or earlier, refer to the Chapter 7, Upgrading Instant Messaging of the Sun Java Communications Suite 5 Upgrade Guide to upgrade to 7.2, then return here to upgrade to 7.3.

Note Sun Convergence requires Instant Messaging 7.3.

Before doing an upgrade, install the required Communications Suite 6 software dependencies. See Requirements for Communications Suite 6

This document contains the following sections:

Upgrading Instant Messaging Servers

Use the following procedures to upgrade each Instant Messaging 7.2 host in your system. The process for upgrading multiplexors and servers is the same and should only take a few minutes. Note that this procedure automatically copies the 7.2 configuration and data (example: notifications, alerts, conversations and so on) to the 7.3 version. If Instant Messaging is configured to provide email notifications, Calendar alerts or Access Manager policy features (authenticating or Single-sign on), this configuration data is migrated so that these features remain in upgrading to 7.3.

1. Inform users that server will go down for a specific time period.
2. Stop the IM server
   im_svr_base/sbin/imadmin stop
   
3. Run compkg upgrade
   Make sure to say Yes when the installer asks to upgrade IM API
   
4. Run im_svr_base/html/redeploy
   
5. Restart the server
   im_svr_base/sbin/imadmin start
   
6. Run the configurator.
   For the new features in 7.3 to work you must run the configurator after upgrading. The upgrade process will not enable audio chat, nor will it deploy the IMPS gateway without running the configurator and choosing Client Components. See Instant Messaging 7.3 Initial Configuration .

Note that old configuration files will be backed up in the im_svr_base/config directory, with the name suffixed with -pre73. For example, the old iim.conf will be backed up as iim.conf-pre73. This file can be used to roll back to the previous working version in case of problems.

To Roll Back to the Legacy Instant Messaging Version

If the upgrade fails and you need to go back to the previously working version, use the following procedure.

1. Stop the server
   
2. Get the old configuration files saved when you did the compkg upgrade
   
3. Remove the new (7.3) packages
   commpkg uninstall will uninstall Communications Suite products that are installed.
   To uninstall just the Instant Messaging packages, use the following command:
   commpkg uninstall --components=IM --silent=NONE
4. Install the old (7.2) packages
5. Replace the old configuration files with their correct names (that is, rename iim.conf-pre73 to iim.conf)
   
6. Run im_svr_base/html/redeploy
7. Start the server
   im_svr_base/sbin/imadmin start