Share this page

# Prepare for synchronization

When setting up synchronization, review the following section carefully.

In this topic:

## Prerequisites

The following needs to be performed once for every ALM or Jira instance:

- ALM Octane on SaaS: Contact your SaaS operator. Request that they enable the Synchronizer service for your space.

- ALM Octane on premises: Install the Synchronizer as described in Download and install the Synchronizer (on-premises). This is included in the Synchronizer installation package, from Micro Focus download sites.

## Preparing for synchronization

Before you can perform synchronization, you need to prepare a number of things as described in the following sections.

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.
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.
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.

## Enabling synchronization with multiple workspaces

By default, the Synchronizer does not support multiple links between a single ALM or Jira project and multiple ALM Octane workspaces. The following steps describe how to enable this.

Step 1: Enable synchronization with multiple workspaces

- If you are using ALM Octane on SaaS, ask Support to enable this functionality for you on the relevant shared spaces.

- If you are using ALM Octane on-premises you can either enable the functionality directly on the Synchronizer service machine, or via API, as described in the following sections.

Method 1: Enable the functionality at the site level on the Synchronizer service machine:

1. On the Synchronizer server, open the file /opt/sync/conf/sync.site.params.properties.

2. Add the following line to the sync.site.params.properties file:

   `sync.enable.sync.multi.octane.workspace.to.same.remote.project=1`

Method 2: Enable the functionality at the space or site level using API parameter updates:

1. Execute a POST request using a REST client (e.g. Postman, Insomnia), having JSON as content type as follows:

   - For the site: `http://<synchronizer URL:port>/sync/admin/param`

   - For a shared space: `http://<synchronizer URL:port>/sync/api/shared_spaces/<shared space UUID>/param`

     In the body enter: `{"name": "sync.enable.sync.multi.octane.workspace.to.same.remote.project", "value": "1", "description": "none"}`

     The user doing the request must have site admin permissions for the site call, and shared space permissions for the shared space call.

2. Change the request method from POST to PUT to update the parameters.

Step 2: Synchronize multiple workspaces after the functionality is enabled

1. Create a UDF in the remote project (ALM/Jira) that will contain the ALM Octane workspace of the entity.

2. Create filters in the remote project to use for link creation.

3. Create links in the Synchronizer for the desired entities. You must choose the correct remote filters for link creation, so that the correct entities from the remote project will be synced to the correct ALM Octane workspace.

See also:

- Using Synchronizer with ALM or Jira - Overview
- Prerequisites
- Perform synchronization

https://admhelp.microfocus.com ALM Octane 8942
Tips to improve your search results... ValueEdge & ALM Octane Help Center ValueEdge ALM Octane Help 16.0.100-16.0.400 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: