Repository path exceptions
When a user is created in the Syncrify server, you have to specify a path where files are stored. This is called the repository path. Consider the following scenario where you create a user with the following values:
| User's Name: |
John Doe |
| Login ID: |
john@acme.com |
| Repository path: |
C:\Backup |
John, who has an account on Syncrify Server, wants to backup
C:\IIS\wwwroot. Assume the profile name is
WebServer.
By default, the files will be stored in the following folder on the target machine (where Syncrify server is running)
C:\Backup\john@acme.com\WebServer\wwwroot
Another Approach
Consider using
Junction Points on Windows or symbolic links on Linux to achieve similar goal.
Problem statement
Often you need to copy files on the server to the same location where they reside on the client. For example, if you are backing up
C:\IIS\wwwroot on the client machine, you want the backed up files to go in the same location on the server.
Steps - version 3.0 and above
- Login as admin to the web interface of Syncrify server.
- Click Manager Users and then Repository Exceptions on the upper right hand side
- To add a new exception, specify
- Login Email - email address that identifies the user. For example john@acme.com
- Profile Name - refers to the particular profile you want to change. For example WebServer
- Absolute Path - Path on the server machine where files should be stored. For example: C:\IIS\wwwroot
- Click Add
Steps - prior to version 3.0
In order to accomplish this task, you need to create a repository exception. The following steps demonstrate this task.
- Locate the installation folder for the Syncrify server. This is usually C:\Syncrify on Windows and /opt/Syncrify on Linux /Unix and BSD. Let's call this $INSTALL_DIR
- Create a new text file in
$INSTALL_DIR\config\RepositoryExceptions.txt
- Modify this file in any text editor. Each line of this file contains one repository exception in the following format
john@acme.com|WebServer=C:/IIS
This line contains 3 parts. First is the email address of the user followed by a pipe ( | ) symbol. The second part contains profile name followed by an equal ( = ) sign. Finally, specify the path where you want to files to appear.
IMPORTANT: Use forward slash ( / ) instead of back-slash for directory separator, even on Windows machine.
- Save the file
- Restart Syncrify server
Once this RepositoryExceptions.txt file is found at runtime, the Syncrify server will read the path from this file instead of actual path specified through the web interface.
