Parallel upgrade from version 9.5.0.x or 10.x.x to version 10.2.6

About this task

To upgrade your environment using a parallel upgrade procedure, perform the following steps:

  1. Before you start the upgrade, extract the certificate authority and the certificates from the keystore and truststore. For further information see Extract certificates from a previous product version level.
    Certificates are now required when installing or upgrading HCL Workload Automation. You can no longer install nor upgrade HCL Workload Automation without securing your environment with certificates. The required certificates are:
    • ca.crt
    • tls.key
    • tls.crt
    For UNIX systems, ensure that all the files have the ownership of the user who installed the master domain manager and the correct permissions (644).
  2. Upgrading Open Liberty or WebSphere Application Server Liberty Base
  3. Encrypting passwords (optional)
  4. Upgrading the Dynamic Workload Console and its database
  5. Creating the HCL Workload Automation administrative user on the workstations which will host the components at 10.2.6 level.
  6. Upgrading the database for the server components
  7. Installing a new dynamic domain manager configured as a backup
    1. Switching the manager to the upgraded backup
    2. Making the switch permanent
  8. Installing the new master domain manager configured as a backup
    1. Switching the manager to the upgraded backup
    2. Making the switch permanent
  9. Customizing and submitting the optional FINAL job stream
  10. Installing a new backup dynamic domain manager to replace the backup dynamic domain manager which you have switched to become the current dynamic domain manager.
  11. Cleaning up your environment
  12. Optionally dismiss all back-level components
  13. Upgrading agents and domain managers
  14. Optionally install a new backup master domain manager at version 10.2.6 to ensure failover capabilities.
Environment with custom certificates
If you have version 9.5 installed with custom certificates, then after upgrading to 10.2 you must ensure that the parameters and the name of the relevant certificates in the localopts file are correct.
If you have previously used certificates generated with OpenSSL, check the paths in the following section:
  • For Open SSL, check:
    • SSL key
    • SSL certified
    • SSL key pwd
    • SSL CA certified
    • SSL random seed
If you have used GSKit, the relevant parameters are automatically migrated to the new OpenSSL parameters:
  • SSL Version
  • SSL Ciphers
  • CLI SSL Ciphers
  • CLI SSL Version