Upgrading to Delegated Administrator 6.4

Communications Suite Release 6 Update 1 includes the same release of Delegated Administrator as Communications Suite Release 5 (6.4), but it incorporates a newer patch version.

If you have the original Communications Suite Release 5 version of Delegated Administrator, you must patch or upgrade to patch -18 or later to operate with the other Communications Suite 6 Update 1 products.

If you are upgrading with the Communication Suite Update 1 download, the included version is patch -19. See Communications Suite Component Patches for the most recent patch numbers.

If you are running Delegated Administrator 6.2 or later, run the commpkg upgrade command to upgrade to the latest version of Delegated Administrator.

For upgrading versions earlier than 6.2, refer to the Sun Java Communications Suite 5 Upgrade Guide, Upgrading Delegated Administrator.

After upgrading (with either patch or commpkg upgrade) Delegated Administrator needs to be re-configured by running config-commda.

Delegated Administrator Client and Server compatibility when upgrading.

The clients (commadmin and DA Console) and server (DA Server) should always be using the same version and patch number. When you upgrade, you should make plans to upgrade all components in one pass. The client-server transactions do not enforce DA-version checking, if you have mismatched versions, you may encounter unexpected failures.

Preserving Customized Data When You Upgrade Delegated Administrator

If you are upgrading to this release of Delegated Administrator from an earlier release, you might have to perform the following tasks before you configure Delegated Administrator with the config-commda program:

• Preserving an Existing Customized Configuration
• Upgrading Customized Service Packages in Delegated Administrator 6.4, (if you are upgrading from Delegated Administrator 6.3)

Preserve an Existing Customized Configuration

This section concerns you only if you previously have installed and configured Delegated Administrator and have customized the Delegated Administrator configuration.

If you have a customized configuration and you rerun the Delegated Administrator configuration program, config-commda, the properties in the configuration files are reset to their default values. These files are listed below, in Delegated Administrator Properties Files.

For information about how you can customize Delegated Administrator, see Customizing Delegated Administrator in the Sun Java System Delegated Administrator 6.4 Administration Guide.

You should preserve your customized configuration before you run Delegated Administrator configuration (config-commda) for any reason, including:

• Upgrade Delegated Administrator
• Patch upgrade of Delegated Administrator
• Rerun the Delegated Administrator configuration program for any other reason.

Delegated Administrator Properties Files

Delegated Administrator installs the following properties files:

• Delegated Administrator utility
  • cli-usrprefs.properties
    Location: da-base/data/config
• Delegated Administrator console
  • daconfig.properties
  • logger.properties
  • Resources.properties
  • Security.properties
    For the default location of the Delegated Administrator console files, see Delegated Administrator Files and Directories in the Sun Java System Delegated Administrator 6.4 Administration Guide.

• Delegated Administrator server
  • resource.properties
    
    For the default location of the resource.properties file, see Delegated Administrator Files and Directories in the Sun Java System Delegated Administrator 6.4 Administration Guide.

To Preserve an Existing Customized Configuration

1. Back up the properties files you have customized.
   For a list of the properties files, see Delegated Administrator Properties Files.
   
   
2. Run the config-commda program, as described in the following sections.
   The remaining steps use the resource.properties file as an example. Repeat these steps for each file you have customized.
   
   
3. Edit the new resource.properties file created by the config-commda program, as follows:
   1. Open the new resource.properties file.
      
   2. Open your back-up copy of the resource.properties file.
   3. Locate the properties that were customized in the back-up copy. Apply the customized values to the corresponding properties in the new resource.properties file.
      Do not simply overwrite the new resource.properties file with the entire back-up copy. The new file may contain new properties created to support this release of Delegated Administrator.
      
      
4. Redeploy the edited resource.properties file to the Web container used by the Delegated Administrator server.
   
   Before the change can take effect, you must run the script that deploys the customized resource.properties file to your Web container.
   
   For instructions on how to deploy a customized properties file to a particular Web container, see To Deploy a Customized Configuration File in the Sun Java System 6.4 Administration Guide.