Share this page

# Download Synchronizer and prepare ALM Octane

To begin, you download the Synchronizer package. You then need to prepare ALM Octane to enable communication between ALM Octane and the Synchronizer.

In this topic:

## Download the Synchronizer

1. Download the Synchronizer installation package from Micro Focus download sites:

   https://www.microfocus.com/en-us/products/application-lifecycle-management-octane-on-prem/download

2. Under /opt/ extract the tar file:

   `tar -xzvf <installation file name>`

The file structure should now be /opt/sync/.

Back to top

## Prepare ALM Octane to enable the integration

To enable communication between ALM Octane and the Synchronizer, perform the following steps within your ALM Octane environment. (In a cluster configuration, this must be done separately for each ALM Octane node.)

Note:

- If you upgrade ALM Octane the following configuration changes are overwritten. Back up the files described below before upgrading, and restore them after upgrading.

- This document provides paths for ALM Octane on Linux. If you are using ALM Octane on Windows, the paths are similar but use Windows format.

1. Within /opt/octane/webapps, copy the service.locator.properties.example file to service.locator.properties:

       cp service.locator.properties.example service.locator.properties

2. Within the service.locator.properties file, enter the correct internal URL of the Synchronizer. Note that the URLs cannot start or end with spaces.

3. Open the /opt/octane/wrapper/wrapper.conf file. In the section headed `#on-prem configuration`, uncomment the following lines (remove the # character from the beginning of each line):

       wrapper.java.additional.38=-Dservice.locator.properties.location=%DEPLOY_BASE_DIR%/webapps/service.locator.properties

       wrapper.java.additional.39=-Denable_services_integration=true

   This enables ALM Octane to communicate with the Synchronizer.

4. If ALM Octane is configured behind a proxy, the Synchronizer must be identified as a non-proxy host. To do this, add the following line at the end of the wrapper.conf file:

       wrapper.java.additional.<next line number>=-Dhttp.nonProxyHosts=<Synchronizer host>

   For example, if the last line in the wrapper.conf file begins with `wrapper.java.additional.62`, add the following line:

       Example: wrapper.java.additional.63=-Dhttp.nonProxyHosts=sync.service.company.com

5. Restart the ALM Octane server. In a command line, enter:

   `service octane restart`

6. The Synchronizer needs to use an API client ID and secret to communicate with ALM Octane. To generate these, go to /opt/octane/install and run the following:

   `./generateadminapikey.sh <octane-server-url> <site-admin-name> <site-admin-password>`

   In an ALM Octane on Windows installation, go to C:\Program Files\octane\install, and use generateadminapikey.bat.

   Example of output:

       Example: "client_id":"micro-services-key_12qw97wx4wp8phrr4wwqzkore"

       "client_secret":"$00~7_djkRV~?vGF@ExMsFPn"

7. Save the client ID and secret. When you configure the Synchronizer, you will enter the client ID in the serviceApiKey property, and the secret in the serviceApiSecret property.

Back to top

Next steps:

- Install Synchronizer using the Configurator interface
- Install Synchronizer using the sync.yml file

https://admhelp.microfocus.com ALM Octane 8942
Tips to improve your search results... ALM Octane Help Center ALM Octane Help 15.1.90 All View Local Help Center View Online Help Center back Go back in browser history forward Go forward in browser history Remove search highlights next topic Go to next topic previous topic Go to previous topic Print the current topic Version: