Upgrading to the Current Release

If you are upgrading from a previous release of ActiveSpaces to the current release, there are several steps to perform to upgrade ActiveSpaces.

The following procedure covers all the steps that might be necessary to upgrade to the current release of ActiveSpaces. Depending upon the version of ActiveSpaces you are upgrading from, some of the steps might be optional. Prior to performing the upgrade procedure, review the Migration and Compatibility section of the Release Notes which contains information on which steps are optional for upgrading from your specific version to the current version. The Migration and Compatibility section of the Release Notes also identifies whether your whole cluster needs to be upgraded at once or whether individual nodes can be upgraded separately.

Perform the following steps on each ActiveSpaces node:

Procedure

  1. Stop all ActiveSpaces processes.
  2. Run the TIBCO Universal Installer and install ActiveSpaces <version>. See Installing in GUI Mode.
  3. If you have enabled shared-nothing persistence, run the as-convert utility to convert the node's shared-nothing persistence files to the format required for the new release. This step may not be required when upgrading from your previous ActiveSpaces version to the current version. See TIBCO ActiveSpaces Release Notes for information on whether this step is required for your specific version. For more information on the as-convert utility, see TIBCO ActiveSpaces Administration Guide.
  4. Update your custom processes to reflect any ActiveSpaces API changes. For this step, review the Release Notes for changes to the TIBCO ActiveSpaces API which might affect your custom ActiveSpaces processes.
  5. Update your custom processes to reflect any ActiveSpaces changes in functionality or deprecated features. For this step, review the Release Notes for Deprecated Features or Changes in Functionality which might affect your ActiveSpaces processes.
  6. After all the nodes in your cluster have been upgraded, perform the following steps:
    1. Restart your ActiveSpaces processes on each node.
    2. If using shared-nothing persistence, recover your data using as-admin. See the recover metaspace command in TIBCO ActiveSpaces Administration Guide.
    If the current version of ActiveSpaces allows nodes to be upgraded individually, after performing steps 1 through 5, you can restart the ActiveSpaces processes on the node that was just upgraded and ActiveSpaces will automatically redistribute the data in your cluster to the newly upgraded node. Since your entire cluster was not shutdown, there is no need to recover any persisted data.