Synchronization
Note: The Synchronization feature is available for Litmus Edge Manager 2.11.0 and later.
You can remotely synchronize Marketplace Catalogs located on different Litmus Edge Manager instances. To do this, you will execute the following key steps:
- Create the primary marketplace catalog (and then add changes as desired) within a first Litmus Edge Manager.
- Create a secondary marketplace catalog within a second Litmus Edge Manager.
- Connect (via bootstrap) the secondary marketplace catalog to the primary marketplace catalog.
Once connected, you can then synchronize the secondary marketplace catalog to be identical to the primary marketplace catalog.
If desired, a Litmus Edge Manager can contain both the primary marketplace catalog and the secondary marketplace catalog.
Review the Synchronize Multiple Applications and Marketplace Catalogs how-to guide.
Note: After a primary-secondary marketplace catalog synchronization, any further changes to the primary marketplace catalog requires additional primary-secondary syncs. Secondary marketplace catalogs will not automatically receive primary marketplace catalog changes.
You will create the primary marketplace catalog in the Litmus Edge Manager you want to store this catalog. This primary marketplace catalog will be the marketplace catalog that other secondary marketplace catalog(s) will synchronize and become identical to.
To set up the primary marketplace catalog:
- From the Litmus Edge Manager User UI, select the appropriate company and project. Then, navigate to Features > Marketplace. The Marketplace Catalog opens in a new browser window.
Click Add Catalog. The create catalog dialog box displays..
- Enter a name and optionally enter a description.
- Select the Synchronize checkbox and from the Select Role drop-down list select Primary.
- Click on the primary marketplace catalog you've just created.
- (Optional) Inside the primary marketplace catalog, add the applications (and respective application releases) and registries that will be later synchronized to secondary catalogs. See Step 1-4 of Add a Draft Application Release and Registry Management.
After you have created the primary marketplace catalog and added relevant applications (and relevant releases) and registries, you will next download the primary marketplace catalog bootstrap file.
To download the bootstrap credential file:
- From the primary marketplace catalog's Applications pane, click Synchronization. The Synchronization: Primary Catalog pane appears.
From Expiration within: customize the desired duration for the bootstrap credential file.
Click Generate. A .bootstrap file will be downloaded to your local computer.
After you have downloaded the .bootstrap file, you will next upload the bootstrap file from the previous step to at least one secondary marketplace catalog. You will do this in a different Litmus Edge Manager from the previous step.
To upload the bootstrap credential file to a secondary marketplace catalog:
Repeat the steps to create a new catalog and create a secondary catalog.
From the secondary marketplace catalog's Applications pane, click Synchronization. The Synchronization: Secondary Catalog pane appears.
Click Upload. Navigate to the .bootstrap file you downloaded earlier from the previous step and select it.
Confirm the Certificate information and click Yes.
You need to approve the connection request for the Secondary Catalog from the Primary Catalog pane. To do this, go back to the Synchronization page in the Marketplace Catalog of the first Litmus Edge Manager Instance. Then, select Secondary Catalogs.
You will receive a request from the secondary catalog to synchronize applications from the primary catalog. Click the Actions menu and select Approve.
If successful, the upload process status will display as Approved in both the Primary and Secondary Catalog Synchronization pages.
- Navigate back to secondary catalog's Synchronization: Secondary Catalog pane, and click Sync.
- After a successful sync, click Applications and Registry Management to verify the successful sync.
After you have uploaded the primary marketplace catalog's .bootstrap file to a secondary marketplace catalog, you can then synchronize the secondary marketplace catalog to become identical to the primary marketplace catalog's application (and their application release) and registries.
To synchronize the secondary marketplace and primary marketplace catalog:
From a secondary catalog's Synchronization: Secondary Catalog pane, click Sync. If the Sync is successful, a success message will be displayed.
- After a successful sync, click Applications and Registry Management to verify the successful sync. The secondary catalog will contain the same applications (and application releases) and registries as the primary catalog.