Synchronization steps

This section lists the steps involved in setting up synchronization.

Caution: Before setting up synchronization on a production system, we recommend synchronizing an experimental ALM Octane workspace and ALM or JIRA project.


Before you begin, perform the following prerequisite steps. These steps need to be performed once for every ALM or JIRA instance.

To integrate: Perform the following:
  • ALM on SaaS <-> ALM Octane on SaaS 

Contact your SaaS operator. Request that they enable the Synchronizer service for your space, and install an Integration Bridge between ALM Octane and your ALM instance.

  • ALM on premises <-> ALM Octane on SaaS 
  • JIRA cloud/on-premises <-> ALM Octane on SaaS 
  1. Contact your SaaS operator and request that they enable the Synchronizer service for your space.

  2. Download and install the Integration Bridge, as described here: Set up the Integration Bridge Agent.

  • ALM or JIRA on premises <-> ALM Octane on premises
  1. Install the Synchronizer as described in the Synchronizer Installation Guide. This is included in the Synchronizer installation package, from Micro Focus download sites.
  2. After you configure the Synchronizer, you need to download and install the Integration Bridge, as described here: Set up the Integration Bridge Agent.

Synchronization workflow

Working with ALM Octane Synchronizer involves the following steps:

Step Description

Prepare for ALM synchronization

Prepare for JIRA synchronization

Make recommended modifications to your ALM or JIRA project and ALM Octane workspace to ensure smooth synchronization.

Step 1: Define a Synchronizer Admin user

Space admin: Define a Synchronizer Admin user to manage the synchronization links.

The Synchronizer admin role is required for all of the remaining steps.

Step 2: Define the synchronization scope

Create favorites for ALM Octane Synchronizer to use when looking for new records in ALM, JIRA, or ALM Octane.

If no favorite is configured, all records are considered for synchronization.

You can perform this step before setting up ALM Octane Synchronizer, or come back and do it later.

Tip: We recommend creating integration favorites before your first synchronization. Run a simulation using your favorite to verify that synchronization works as you expect.

Step 3: Create a synchronization link

Use the wizard to help you define your connection data to ALM or JIRA, the favorites used to filter data, and the directions in which the endpoints are updated.

Step 4: View and edit link configuration

Check the mappings and settings that were created automatically for your link, and make any adjustments necessary.

Step 5: Configure synchronizer notifications

Configure Synchronizer to send notifications about issues occurring during synchronizations.

Link notifications are configured for all links in a workspace. Bridge notifications are configured per bridge.

Step 6: Run synchronizations

Run an integrity check to prevent errors during synchronization, and an optional simulation to understand details about the data that will be updated.

Run manual synchronizations or enable synchronizations to run automatically.

Step 7: Review link summaries and error details

Review the status of your links and investigate any errors that may have occurred during synchronization.

You can view the run history for a specific link in the Run History tab.

See also: