About this task:

Take the following steps to upgrade the cloned environment and update the DNS to use this new, upgraded environment.

  1. After you have created a clone of the production environment, block traffic coming into the production environment.
    Note: By blocking traffic to the service, you are ensuring that no changes to the system database are made during the upgrade process.
  2. According to your database vendor documentation, take a snapshot of the production system database.
  3. According to your database vendor documentation, update the system database clone with the production database snapshot to ensure you have the latest configuration and credential information.
  4. Perform an upgrade on one of the nodes in the cloned environment.
    1. From a command-line prompt, navigate to the directory where you saved the product file. Alternatively, place the product file directory on your path before proceeding to the next step.

      The product file has the format PROGRESS_DATADIRECT_HDP_SERVER_nn_LINUX_64_INSTALL.bin, where nn is the version of the product.

    2. Make the file an executable using the chmod command. Then, press ENTER. For example:

      chmod +x ./PROGRESS_DATADIRECT_HDP_SERVER_nn_LINUX_64_INSTALL.bin

    3. Run the executable.
      • GUI mode

        ./PROGRESS_DATADIRECT_HDP_SERVER_nn_LINUX_64_INSTALL.bin

        Note: If the installer cannot continue with a GUI installation, a message is displayed and the installation continues in console mode
      • Console mode

        ./PROGRESS_DATADIRECT_HDP_SERVER_nn_LINUX_64_INSTALL.bin -i console

    4. When prompted, enter the directory of the installation you want to upgrade.
    5. When prompted, choose an upgrade installation on the existing installation.
    6. When prompted, choose the type of upgrade you want to perform.
      • Select Express to persist established settings.
      • Select Modify settings to change established settings.
    7. Review port numbers and accept or change values as appropriate.
    8. Review the upgrade summary, and proceed with the upgrade.
    Important: If the upgrade fails, you can rollback to the previous version of the service, as described in Rolling back to previous version if upgrade fails.
  5. Perform an Express upgrade on each of the remaining nodes in the cloned environment.
    1. Run the executable.
      • GUI mode

        ./PROGRESS_DATADIRECT_HDP_SERVER_nn_LINUX_64_INSTALL.bin

        Note: If the installer cannot continue with a GUI installation, a message is displayed and the installation continues in console mode
      • Console mode

        ./PROGRESS_DATADIRECT_HDP_SERVER_nn_LINUX_64_INSTALL.bin -i console

    2. When prompted, enter the directory of the installation you want to upgrade.
    3. When prompted, choose an upgrade installation on the existing installation.
    4. When prompted, choose an Express upgrade.
    5. Review the upgrade summary, and proceed with the upgrade.
  6. Test the upgraded, cloned environment to ensure that the upgraded version of the service is performing as expected.
  7. Once you have thoroughly tested the environment to ensure that the upgraded version of the service is performing as expected, update the DNS record of the current production load balancer such that the hostname of the load balancer resolves to the IP address of the load balancer clone. With the DNS record update, the cloned environment becomes your newly upgraded production environment.
    Important: The name of the server hosting the load balancer must remain the same between the upgraded version of the product and the previous version.
  8. Unblock traffic coming into the service.

What to do next:

As a matter of best practices, monitor functionality and performance in the upgraded production environment.

Once you have confirmed that the upgraded production environment is operating as expected, you can free the original production machines.