Upgrading the server in interactive mode#

To upgrade the server, stop the server and run the new installation program.

Before you begin

Depending on the version of HCL™ Launch you are upgrading, be sure to address these build-specific considerations.

Affected Build Consideration
7.0.5 Upgrading to 7.0.5 enables compression of new VC entries that reduces the vc_persistent_record table growth rate. If you are using MySQL or MariaDB, then the upgrade may take longer due to the vc_persistent_record table changes. To avoid the delay on MySQL 5.6 or MariaDB 10.0 or later, run the following SQL statement before starting the upgrade: ALTER TABLE vc_persistent_record MODIFY persistent_data longtext null, ADD compressed_data longblob null, lock=none Note that you can run this command without shutting down the HCL Launch server. Attention: If the command fails, proceed with the upgrade and let the upgrade script make these changes. In such case, the upgrade requires downtime. It is recommended to run the command on a cloned HCL Launch database to get an estimate of downtime duration.

About this task

This task applies to upgrades of versions 7.0.x or later. Contact HCL Launch support for all other versions.

Note:

During the upgrade, the contents of the appdata/patches directory (including all .jar files) will be appended with .off, preventing the existing test fixes from being loaded once the Server is started post-installation. All UI test fixes applied to the Tomcat directory will be wiped by the upgrade and will not be recoverable.

If a text fix received for a reported defect is not fixed in the upgraded version, you may need to open a support case to request a new build.

Note: Setting com.urbancode.ds.cleanup.sourceConfig.fullCleanupSkip to True is only effective upon upgrade. After upgrading, component version import logs are automatically cleaned up after 24 hours by default. Refer to Component versions.

Procedure

  1. If you have added custom keystores, certificates, or any other files to the server_install/opt/tomcat directory, back up those files before you upgrade. If you do not back up files that you have added to the server_install/opt/tomcat directory, those files are removed when the upgrade process runs.

  2. Download and extract the installation files for HCL Launch.

    These files are available for download from the HCL FlexNet Operations portal.

  3. Ensure that no application and generic processes are running.

    Open the Dashboard and confirm that no processes are running. If processes are running, you can wait for them to complete or by clicking Cancel in the same row as each process, cancel them. You can use the Message of the Day feature (Settings > System > General Settings) to notify users of the planned upgrade, and request that they do not start new processes.

  4. Stop the server.

    Warning: If you are upgrading a high-availability installation, stop all of the servers. If any servers are accessing the database when the upgrade happens, the upgrade will cause errors. See Upgrading high-availability installations.

  5. Ensure that the server is stopped:

    1. Check to ensure that there is no file server.pid in the server_install/var folder.

    2. Check for running system processes.

      For example, on Linux™, you can use the netstat or ps commands. For example, if the server is running on port 8443, use the command netstat -nap | grep 8443. You can also run ps -ef | grep server and look for the server system process in the results.

    3. If any server processes are still running, stop them.

    If a server process is still running, when you install the new version, you see an error that says "A previously installed version of HCL Launch is running. Please shutdown the running HCL Launch and start the installation again."

  6. Back up the database.

  7. Optionally, upgrade the version of Java on the server to version 8 or later.

    See Changing or updating the JRE of servers.

  8. From the command line, run the server installer program.

    • On Windows™, run the install-server.bat file.
    • On Linux, run ./install-server.sh.
    • To install a FIPS-compliant server, add the switch -fips to the command, such as install-server.sh -fips.

      Note: If you install a FIPS-compliant server, cloud provisioning is not available. Your JVM connects to only FIPS 140-2 certified IBM providers.

    Depending on your system settings, you might need to run this file as an administrator.

  9. Read the license agreements for the software package. Press Enter to show one page at a time, or press F and then press Enter to show the entire license at once.

  10. If you agree to the terms of all of the license agreements, press Y and then press Enter.

  11. At the prompt that says Enter the directory where the HCL Launch server should be installed., specify the folder of the existing installation and press Enter.

  12. At the prompt that says A previous version exists in the specified directory. Do you want to upgrade the currently installed version? press Y and then press Enter.

  13. Verify that the server is stopped and then press Enter to start the upgrade process.

  14. Start the server and verify that the server has been migrated.

    If you get error Shutdown file is present! Is the server running?, check that you are using Java 11. If so, remove the -Djava.endorsed.dirs=<PATH> from the JAVA_OPTS variable in the set_env file.

  15. Ensure that licensing is set up for the server.

    See Managing licenses.

  16. Optionally, upgrade the encryption key strength.

    See Upgrading encryption key strength.

  17. Upgrade the agents.

    See Upgrading agents. You must upgrade agents that use Java™ plug-ins, including most source configuration plug-ins. If you do not upgrade the agents, they will throw an IllegalCharsetNameException exception that refers to the variable DS_SYSTEM_ENCODING.

What to do next

Upgrade all agent relays to the current version. Agents that connect through relays may not connect successfully until both server and relay are upgraded.

Parent topic: Upgrading the server