Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

id1396544159

...

id1396544170

...

id1396544157

On this page

Table of Contents
maxLevel4

...

id1396544160


In Magic Collaboration Studio, you can create remote resource configurations allowing you to synchronize resources from one Magic Collaboration Studio server to another based on the selected synchronization trigger. This is a convenient way to collaborate with disconnected teams or departments and share not only resources but their entire history as well. To learn how you can benefit from this functionality, see cross-cluster resource synchronization.

Warning
titleImportant

Be aware that cross-cluster resource synchronization is only supported between clusters running the same major version. While the minor version does not need to match, both clusters must be on the same major version to ensure compatibility and smooth operation.

Note
  • To create remote resource configurations, you must have the Remote Synchronization Manager role. The role scope needs to include the target Magic Collaboration Studio server categories where you want the synchronized resources to be saved.
  • Cross-cluster resource synchronization works only in one direction - from the source to the target server. Synchronized resources on the target server are read-only and cannot be edited to ensure version consistency.
  • Remote resource configurations are created and managed on the target Magic Collaboration Studio server.

 

To create a remote resource configuration


  1. Go to the Settings application and select Remote repository management on the left side of the screen.
  2. In the bottom right corner of the screen,

...

  1. click Image Modified to open the wizard for creating a remote resource configuration.
  2. In the first step of the wizard, log in to the source Magic Collaboration Studio server:
    1. In the Source Magic Collaboration Studio address box, enter the address of the source server from which you want to synchronize resources or categories.
    2. In the Username and Password boxes, enter the credentials of a source server user.

      Note
      titleRequired source server user permissions

      For successful synchronization, the user whose credentials are used to log in to the source Magic Collaboration Studio server needs to have the Read Resources permission in the source server.

  3. Click Next.
  4. Select the source server resources and/or categories you want to synchronize with the target Teamwork Could server (the current server) and click Next.

    Image Modified

  5. Select the category in the target Magic Collaboration Studio server where you want the synchronized resources to be stored and click Next.
  6. Select one of the following synchronization triggers:
    • Manual - the resource or category is synchronized only when initiated by a user.
    • On every new commit - the resource or category is synchronized whenever a new resource version becomes available in the source server.
    • On specific commit tag - the resource or category is synchronized when a resource is committed to the source server with a specific commit tag.

    Image Modified

  7. Click Create.


A separate remote resource configuration is created for every resource and/or category selected in step 5. All existing remote resource configurations and their details including synchronization status are displayed in the remote repository management screen as shown below.

 

Image Modified

The remote repository management screen where you can create and manage remote resource configurations.


Synchronizing resources manually

After creating a remote resource configuration, the related resource or category is synchronized depending on the selected synchronization mode. However, you can also synchronize resources manually as described below.

Note
If you select the Manual synchronization mode for a remote resource configuration, you need to synchronize resources by yourself as described in this section.


To synchronize resources manually


  1. Go to the Settings application and select Remote repository management on the left side of the screen.
  2. Select the remote resource configurations of the resources and/or categories you want to synchronize.
  3. In the top right corner of the screen, click Image Modified.

Deleting remote resource configurations

If remote resource configurations are no longer needed, you can delete them as described below.


To delete a remote resource configuration


  1. Go to the Settings application and select Remote repository management on the left side of the screen.
  2. Select the remote resource configurations you want to delete.
  3. In the top right corner of the screen, click Image Modified.
  4. Optionally,

...

  1. run Data Manager and use one of the commands for deleting resources to completely remove the remote resource configurations from Magic Collaboration Studio.

    Note
    titleNote

    Step 4 is mandatory if you want to create another remote resource configuration for the same resource. In such a case, it is not enough to delete the configuration you want to replace by using just the Magic Collaboration Studio UI. You need to remove it via Data Manager as well.