Upgrading an OpenShift installation using service template

You can upgrade an OpenShift installation using service template.

Before you begin

Note: Upgrades of OpenShift using a service template will be deprecated in future versions of HCL™ Accelerate.
Note: If you are running an HCL™ Accelerate version prior to 2.4, you need to uninstall the product and perform a full installation of version 2.4.x found here and skipping Steps 5 and 7 because you are not required to uninstall the MongoDB.

HCL™ Accelerate installation properties are stored in the /home/.ucv/settings.json file on the computer where you installed the product. If the user that is upgrading the product is not the user who installed it, ensure that the settings.json file is copied to the upgrading user's /home/.ucv directory before upgrading.

In addition to the requirements for all installation scenarios, you need the following items:

  • Configured OpenShift client instance. This topic uses Minishift for local instance installations.
  • OpenShift command line tool, OC, installed on the client.
  • Access to the PEM-format certificate and private key that you can use to configure OpenShift routes.
  • Master node: 2 vCPU, 8 GB RAM, 30 GB storage.
  • Other nodes: 1vCPU, 8 GB RAM, 15 GB storage.

About this task

When you run the installer, it checks for an existing installation. If the installer finds a previous version, it uses installed properties, such as your product access key, and assumes that you are upgrading the product.

Procedure

  1. Complete installation by responding to the prompts described in the following steps.
    When the script starts, you are prompted to accept the license. You can explicitly accept the license without viewing it by appending the following parameter to the command:
    ./<Accelerate-installation-file> --license=accept
  2. At the Please enter your HCL Accelerate access key prompt, accept the default value.
    The default value is the key you entered when you installed the product. If you are upgrading from the Community Edition, enter your new Standard Edition key.
  3. At the Enter your encryption key or leave blank to use the default. Key must be at least 8 characters prompt, enter your encryption key or leave blank to use the default encryption key.
    Note: The encryption key must be at least 8 characters. Save the encryption key to use for further upgrades.
  4. At the Choose the platform prompt, select OpenShift (DEPRECATED - using OpenShift Template).
  5. At the Enter the location where the HCL™ Accelerate files will be installed prompt, specify where to put the installation files.
  6. At the What version of MongoDB are you using? prompt, use the arrow keys to select the required version and then press enter.
  7. At the What version of OpenShift is being used? Specify in <major_version>.<minor_version> format. prompt, enter the OpenShift version.
  8. At the Openshift Project Name (existing project) Default prompt, enter the OpenShift project name.
  9. At the Name of installation user (existing user) Default prompt, enter the name of the installation user.
  10. At the Enter the application name for HCL™ Accelerate in OpenShift (unique name for the HCL™ Accelerate instance within a project) Default prompt, enter the name of the installation user.
  11. At the Choose one prompt, use the arrow keys to select Upgrade existing instance and then press enter.
  12. At the Should the installer perform the upgrade operations automatically for you at this time? prompt, enter Y.
    Note: The installer verifies server and project space.
  13. At the Is this project you want to use? prompt, use the arrow keys to select Yes and then press enter.
    Note: The installer verifies the HCL™ Accelerate plugin framework and creates the required update files. When the aforementioned process is successfully completed, Installer complete! is displayed on the last line.
  14. At the Press [Enter] to exit prompt, press enter.

What to do next

After the upgrade is complete, open HCL™ Accelerate and verify that the software is upgraded to the required version.