Litmus Edge Manager User UI
...
Product Features
Marketplace: Catalogs and Appl...

Synchronization

7min

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:

  1. Create the primary marketplace catalog (and then add changes as desired) within a first Litmus Edge Manager.
  2. Create a secondary marketplace catalog within a second Litmus Edge Manager.
  3. 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.

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.

Step 1: Set Up Primary Marketplace Catalog

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:

  1. 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.
  2. Click Add Catalog. The create catalog dialog box displays..

    Marketplace Catalog: Primary Marketplace Catalog
    Marketplace Catalog: Primary Marketplace Catalog
    
  3. Enter a name and optionally enter a description.
  4. Select the Synchronize checkbox and from the Select Role drop-down list select Primary.
  5. Click on the primary marketplace catalog you've just created.
  6. (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.
Document image


Step 2: Download Primary Marketplace Catalog Bootstrap File

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:

  1. From the primary marketplace catalog's Applications pane, click Synchronization. The Synchronization: Primary Catalog pane appears.
  2. From Expiration within: customize the desired duration for the bootstrap credential file.

    From Expiration within: customize the desired duration for the bootstrap credential file.
    From Expiration within: customize the desired duration for the bootstrap credential file.
    
  3. Click Generate. A .bootstrap file will be downloaded to your local computer.

    Primary Marketplace Catalog: Synchronization: Generate Bootstrap File
    Primary Marketplace Catalog: Synchronization: Generate Bootstrap File
    

Step 3: Create a Secondary Marketplace Catalog

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:

  1. Repeat the steps to create a new catalog and create a secondary catalog.

    Marketplace Catalog: Secondary Marketplace Catalog
    Marketplace Catalog: Secondary Marketplace Catalog
    
  2. From the secondary marketplace catalog's Applications pane, click Synchronization. The Synchronization: Secondary Catalog pane appears.

    Secondary Marketplace Catalog: Synchronization
    Secondary Marketplace Catalog: Synchronization
    
  3. Click Upload. Navigate to the .bootstrap file you downloaded earlier from the previous step and select it.

    Secondary Marketplace Catalog: Synchronization: Upload
    Secondary Marketplace Catalog: Synchronization: Upload
    
  4. Confirm the Certificate information and click Yes.

    Confirm Certificate
    Confirm Certificate
    
  5. 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.

    Check connection request from LEM Marketplace Catalog
    Check connection request from LEM Marketplace Catalog
    
  6. You will receive a request from the secondary catalog to synchronize applications from the primary catalog. Click the Actions menu and select Approve.

    Approve the Request for Sync
    Approve the Request for Sync
    
  7. If successful, the upload process status will display as Approved in both the Primary and Secondary Catalog Synchronization pages.

    Approved Status in the Secondary Catalog Synchronization page
    Approved Status in the Secondary Catalog Synchronization page
    
    Approved Status in the Primary Catalog Synchronization page
    Approved Status in the Primary Catalog Synchronization page
    
  8. Navigate back to secondary catalog's Synchronization: Secondary Catalog pane, and click Sync.
  9. After a successful sync, click Applications and Registry Management to verify the successful sync.

Step 4: Synchronize Secondary Marketplace Catalog to Primary Marketplace Catalog

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:

  1. From a secondary catalog's Synchronization: Secondary Catalog pane, click Sync. If the Sync is successful, a success message will be displayed.

    Secondary Marketplace Catalog: Synchronization: Sync
    Secondary Marketplace Catalog: Synchronization: Sync
    
  2. 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.
Secondary Marketplace Catalog: Applications and Registry Management
Secondary Marketplace Catalog: Applications and Registry Management