8.11. Synchronizing Remote Objects

Engineering Knowledge Manager

User's Guide | Chapter 8: Managing Repository Data |

8.10. Extracting Archives |  | 8.12. Creating Shortcuts to Objects
Prev |  | Next

## 8.11. Synchronizing Remote Objects

The Synchronize action can be used to update objects that are referenced in a repository location, but the data are physically stored on a remote file server. Recall that you can create remote connections to files and folders that reside on file servers outside of EKM using New > Connections to Files/Folders on a Remote Server action. When you create a connection to a remote file or folder, the object is symbolically linked and metadata are extracted once the connection is made. Remote files are assigned the File type, and remote folders are assigned to the Remote Folder type. Because the actual files and folders on the remote file server are only symbolically linked to EKM, they need to be re-synchronized whenever the source data has been updated. The Synchronize action is used to sync up remote items with the repository.

When a remote file is synchronized, the metadata is recalculated and updated in EKM if the file has been modified. When a remote folder is synchronized, the metadata for all the new or modified files contained within the folder are recalculated and updated in EKM. Additionally, any new file or folder that is found on the remote file server that does not exist in the EKM folder will be added to the EKM folder, and any existing file/folder that no longer exists on the remote server will be removed from the EKM folder. The Synchronize action menu is displayed for remote folders only if you have `Full Control` permission; `Modify` permission is required for remote files.

To synchronize a remote file or folder:

1. Select the objects, then click the synchronize button . This opens a Message dialog box.

2. The Message dialog box will report on the progress of the synchronization while it is taking place and when it is complete. Click Cancel to cancel synchronization.

The total number of objects that are processed in the transaction is reported, as well as (fatal) errors and (non-fatal) warnings that were encountered. Error messages will prevent a synchronization from occurring, while warnings are alerts only. Common warnings result when:

- Required user properties have not been input.

- The default type for an extension cannot be applied to a file because the metadata extraction has failed. You can monitor extraction status on the Data/Extraction Monitor page.

Common errors arise when:

- Files/folders contain invalid characters.

- You have insufficient permission to add files to a folder.

Important: If you cancel a synchronization while it is being processed, you may need to wait for some time before the operation is cancelled.

Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

Prev | Up / Contents | Next

Release 18.2 - © ANSYS, Inc. All rights reserved.