Upgrading Each Individual Realm Server Process

To upgrade an individual realm server process, complete this sub-task.

Procedure

  1. Backup the realm server database.

    See --backup_database, or POST server. Alternatively, use your own custom script that calls the tibrealmadmin utility with this command.

  2. Stop the old realm server process.

    See --shutdown, or POST server. Alternatively, use your own custom script that calls the tibrealmadmin utility with this command.

  3. Install the new realm server on the host computer, including executable files, plus library and script support files.

    Install the full TIBCO FTL product. See instructions in TIBCO FTL Installation.

  4. Start the new realm server process using the same command or script that you had used for the old realm server.

    The new realm server loads the existing realm database files, and is ready to serve clients.

    A migration tool automatically transfers historical deployment data from existing realm servers when you upgrade across the divide between Releases 5.1 and 5.2. This tool automatically transfers data for only the most recent 25 deployments. To transfer more than 25, set the environment variable TIB_MAX_DEPLOYMENTS before starting the new realm server.

  5. If the new realm server has satellites or a backup, wait sufficient time for those processes to reestablish contact with the new realm server process.
  6. If the new realm server has a backup, wait sufficient time for clients to migrate from the backup to the new realm server. Then upgrade the backup realm server.