Page History
On this page
| Table of Contents | ||
|---|---|---|
|
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 | ||
|---|---|---|
| ||
Be aware that cross-cluster resource synchronization is only supported between clusters deployments running the the same major version. While the minor version does not need to match, both clusters deployments must be on the same major version to ensure compatibility and smooth operation. |
| Note |
|---|
|
To create a remote resource configuration
- Go to the Settings application and select Remote repository management on the left side of the screen.
- In the bottom right corner of the screen, click
to open the wizard for creating a remote resource configuration. - In the first step of the wizard, log in to the source Magic Collaboration Studio server:
- In the Source Magic Collaboration Studio address box, enter the address of the source server from which you want to synchronize resources or categories.
In the Username and Password boxes, enter the credentials of a source server user.
If needed, toggle the Use Secure Connection (TLS) button to enable/disable the secure connection.
Note title Required 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.
- Click Next.
- Select the source server resources and/or categories you want to synchronize with the target Teamwork Could server (the current server) and click Next.
- Select the category in the target Magic Collaboration Studio server where you want the synchronized resources to be stored and click Next.
- 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.
- 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.
| Status | Description |
|---|---|
| In queue | The resource is staged to be synchronized and now is in queue. |
| Not synchronized | The resource is not staged for synchronization and you need to trigger it manually. |
| Synchronized | The resource was synchronized successfully from the source server. |
| Partially synchronized | This 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. |
| Error | There 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.
| 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
- Go to the Settings application and select Remote repository management on the left side of the screen.
- Select the remote resource configurations of the resources and/or categories you want to synchronize.
- 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
- Go to the Settings application and select Remote repository management on the left side of the screen.
- Select the remote resource configurations you want to delete.
- In the top right corner of the screen, click
. 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.