Install the patch

This section describes how to install patches.

Before installing the patch

  1. To prevent loss of files that were added or changed as a result of hot fixes or customization:

    • All files, except for files with a .class extension, that were added or changed under the <Deployment folder>\webapps\qcbin folder should be copied to the <Deployment folder>\application\qcbin.war folder, including the folder tree hierarchy.

      • Note: Do not copy over .class files from the qcbin folder as these files use a different codebase from the patch.

    • Any file added or changed under the <ALM File repository folder>\sa folder should be copied to the <ALM File repository folder>\customerData folder, including the folder tree hierarchy.

      • After installing the patch and updating the deployment with the changes, the deployment process copies your files back to the qcbin and the sa folders.

      Note: If user avatars are lost after a server upgrade, see this KB article.

  2. Make sure that all users are logged out. You can check active connections from Site Administration, in the Site Connections tab.

  3. Check the Release Notes for the patch to see if it contains changes to project database schemas. If so:

    1. Back up all projects.

    2. Set project update priorities (optional).

  4. Stop the ALM server.

    OS Steps
    Windows

    In the system tray, right-click the OpenText Application Quality Management icon and choose Stop Application Lifecycle Management. Close the tray icon utility by right-clicking the icon and selecting Exit

    There may be multiple system tray icon processes running on the server machine. After stopping the server, ensure that all system tray icon processes are terminated before installation. System tray processes can also be terminated in Windows Task Manager.
    Linux Navigate to the <Deployment path>/wrapper directory, and run the following command: HPALM stop.

Caution: If the patch includes an automatic upgrade, be aware that the upgraded site administration schema refers to the projects in production.

Note: Before the patch installation (either full or incremental), you do not need to deactivate existing projects.

Installing the patch

There is no need to uninstall any patch before installing a new patch.

Install the patch by performing the following steps on your server machine.

OS  
Windows Run the ALM_Installer EXE file. Alternatively you can install the patch from the command line. The installation structure is mandatory for proper execution of the OpenText Application Quality Management EXE installer. The directory structure must be kept as is.
Linux In the command prompt, type: ./ALM_installer.bin.

Follow the installation and deployment instructions.

Patch installation automatically identifies the installation, deployment, and repository paths from the properties file that was created during the first installation. The file is saved in the following path

OS Path
Windows C:\ProgramData\Micro Focus\ALM\conf\qcConfigFile.properties
Linux /var/opt/ALM/conf/qcConfigFile.properties

If the installation fails, you receive an error message with the cause of the failure and the path to the log file.

After the patch is installed, the next time users log in, new files are downloaded and installed on the client machines. If file downloads are prohibited through your browser, you can install these files through the OpenText Application Quality Management Client MSI Generator add-in, available on Marketplace.

Uninstalling the Patch

For instructions on uninstalling a patch, see Uninstall.