Upgrade the Integration Bridge

When a new ALM Octane version includes a new version of the Integration Bridge, upgrade existing bridges as described in this section.

Manual upgrade on the same server

The following procedure registers the upgraded bridge as an existing bridge.

  1. Uninstall the Integration Bridge, as described in Uninstall/Remove the Integration Bridge. During the uninstall process, do not select Remove credentials.

  2. Download the new version of the Integration Bridge from the Synchronizer > Link Configuration page.

    Select More Actions > Download Integration Bridge, and select the relevant download according to your operating system.

  3. Extract the downloaded zip file (alm-octane-integration-bridge-windows.zip or alm-octane-integration-bridge-linux.zip) to a new folder.

  4. Copy values from the previous installation to the new installation. Do the following:

    1. In the installation directory of the previous version, access the \product\conf\server-connection.bak file. (On a Linux system, reverse the slashes in the path.)

    2. In a parallel window, browse to the server-connection.conf file downloaded with the new version of the Integration Bridge, and open it for editing.

    3. Copy the agent.guid property and its value from the previous installation file, and append it to the new file. Save the new file.

  5. Run the newly downloaded alm-octane-integration-bridge.exe (Windows) or alm-octane-integration-bridge.bin (Linux) to begin the installation.

    During the installation, select the installation folder that was used for the previous version.

    For more details, see Download and install the Integration Bridge Agent.

    Note: If your Integration Bridge connection uses a certificate that is not signed by a well-known Certificate Authority, you need to reinstall the certificate after manually upgrading the bridge. For details, see Connections using a certificate that is not signed by a well-known Certificate Authority.

Back to top

Manual upgrade and installation in a new location

The following procedure installs the upgraded Integration Bridge in a new directory on the same server as the previous version, or on an entirely new machine.

  1. Uninstall the Integration Bridge, as described in Uninstall/Remove the Integration Bridge. During the uninstall process, do not select Remove credentials.

  2. Download the new version of the Integration Bridge from the Synchronizer > Link Configuration page.

    Select More Actions > Download Integration Bridge, and select the relevant download according to your operating system.

  3. Extract the downloaded zip file (alm-octane-integration-bridge-windows.zip or alm-octane-integration-bridge-linux.zip) to a new folder.

  4. Copy files and values from the previous installation to the new installation. Do the following:

    1. In the directory where you want to install the new version, create the following folder structure:product\conf

    2. Copy the following files from the installation directory of the previous version to the conf directory you created in the previous step.

      • credentialsStore.xml
      • key.bin
    3. In the installation directory of the previous version, access the \product\conf\server-connection.bak file. (On a Linux system, reverse the slashes in the path.)

    4. In a parallel window, browse to the server-connection.conf file downloaded with the new version of the Integration Bridge, and open it for editing.

    5. Copy the agent.guid property and its value from the previous installation file, and append it to the new file. Save the new file.

  5. Run the alm-octane-integration-bridge.exe (Windows) or alm-octane-integration-bridge.bin (Linux) to begin the installation.

    During the installation, select the directory where you want to install the new version.

    For more details, see Download and install the Integration Bridge Agent.

    Note: If your Integration Bridge connection uses a certificate that is not signed by a well-known Certificate Authority, you need to reinstall the certificate after manually upgrading the bridge. For details, see Connections using a certificate that is not signed by a well-known Certificate Authority.

Back to top