On this page

In Magic Collaboration Studio, you can create remote resource configurations allowing you to synchronize resources from one Teamwork Cloud 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.

Important

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

  • To create remote resource configurations, you must have the Remote Synchronization Manager role. The role scope needs to include the target Teamwork Cloud 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 Teamwork Cloud 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, click  to open the wizard for creating a remote resource configuration.
  3. In the first step of the wizard, log in to the source Teamwork Cloud 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.

    3. If needed, toggle the Use Secure Connection (TLS) button to enable/disable the secure connection.

      Required source server user permissions

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

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



  6. Select the category in the target Teamwork Cloud server where you want the synchronized resources to be stored and click Next.
  7. 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.



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

 

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

In the following table, you can find the descriptions of synchronization status.

StatusDescription
In queueThe resource is staged to be synchronized and now is in queue.
Not synchronizedThe resource is not staged for synchronization and you need to trigger it manually.
SynchronizedThe resource was synchronized successfully from the source server.
Partially synchronizedThis is an alert, indicating that there is a more recent version available in the source server. You may want to consider re-synchronizing the resource if your use case requires having the latest version on the target server. Reproducible with manual synchronization configuration.
ErrorThere can be a couple of reasons why there is an error. A reason will be displayed in the tooltip while hovering over the status.

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.

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 .

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 .
  4. In the open dialog, choose one of the following:

    • DELETE CONFIGURATION ONLY - choose to delete only the configuration, leaving synchronized categories/resources in the target server. 
    • DELETE ALL - choose to delete the configuration along with the synchronized resources and/or categories.