Upgrading Liberator

The page provides instructions on upgrading an existing installation of Liberator, and should be read in conjunction with Installing Liberator.

These instructions are not suitable for upgrading from Liberator 6.x to Liberator 7. For more information, see Upgrading to Caplin Platform 7.

Contents:

Requirements

Liberator 6.2 must be deployed on Deployment Framework 6.2.

Liberator 7 must be deployed on Deployment Framework 7.

Upgrade instructions

Note: you cannot use these instructions to upgrade from Liberator 6.x to Liberator 7. See Upgrading to Caplin Platform 7.

To upgrade an existing installation of Liberator, follow the instructions below.

  1. Stop all components running under the Deployment Framework:
    1. ./dfw stop
  2. Copy the Liberator installation file to <Framework-root>/kits
  3. Deploy the new version of Liberator:
    1. ./dfw deploy
    2. As part of deployment, the Deployment Framework copies configuration-override files for the new version of Liberator to the <Framework-root>/global_config/overrides/Liberator directory. Existing configuration-override files are not overwritten. When a file cannot be copied because an older version of the file already exists in the <Framework-root>/global_config/overrides/Liberator directory, the Deployment Framework prints a warning to the console.
  4. Confirm the new version of Liberator has deployed correctly:
    1. ./dfw versions
  5. If any configuration override files failed to copy in step 3 above, compare the current override files with the override files from the newly deployed Liberator, and manually update the current configuration override files.
    1. See the release notes for the new version of Liberator to learn about new configuration items included in the new version.
    2. The current configuration override files for Liberator can be found at <Framework-root>/global_config/overrides/servers/Liberator
    3. The configuration override files for the newly deployed Liberator can be found at <Framework-root>/kits/Liberator/Latest/etc/overrides
  6. Restart the Deployment Framework
    1. ./dfw start
  7. Test your upgraded installation of Liberator. See Installing Liberator: Test your installation.