Add configurations
Contents
A configuration require minimum a local catalog and a remote catalog. After entering information about a configuration select the Add
button to add it to RsyncOSX. Continue adding new configurations until completed and configurations are saved to permanent storage after each entry. Select local catalog either by drag and drop or by enter text directly. For remote catalogs only drag and drop for local attached volumes. For remote server catalogs enter by text only.
There is also an Assist function which picks up your local catalogs. You can also add your remote info for easy to add new tasks.
There are three types of tasks:
- synchronize, which is default and keeps source and destination in sync
- snapshots, save changes and deletes ahead of a synchronize
- syncremote, remote is source, synchronize a remote source to a local volume
Sample configuration
Local catalog and Remote catalog are added either by using drag and drop from filemanager or by text only. If enter by text please remember to add the full path. Remote catalogs is entered either by full paths or use the ~
character to expand remote user home catalog.
The Capacity button query remote storage in all configurations about available storage space. Only valid for remote hosts.
Catalog parameters
- Local catalog: required field
/Users/thomas/Documents/
- my Documents catalog in my home catalog
- Remote catalog: required field
~/Documents/
- the
~
is expanded as the home catalog with full path by the remote operating system - the remote catalog might also be added by full path, depends where the backup catalog is placed on remote server
- the backup catalog might also be a local catalog on a local attached disk
- the
- Dont´t add trailing:
/
- by default a trailing
/
is added to both source and destination
- by default a trailing
Remote server parameters
- Remote username:
thomas
- username for login to remote server
- Remote server:
10.0.0.57
- either server name or IP-address for remote server
- ID:
My docs catalog
- informal tag for the configuration
Task
- Type: there are four types of tasks,
synchronize
which is default,snapshots
,syncremote
andsingle file
.
Optional pre and post task
- pretask: attach optional pre shell script to the synchronize command. The
pre.sh
is executed ahead of the synchronize command, thepost.sh
after the synchronize command. The scripts are normal shell scripts as if executed from the command line.- switch execute shell script on/off
- posttask: attach optional post shell script to the synchronize command. The
post.sh
is executed after the synchronize command.- switch execute shell script on/off
- Halt on error: if the phrase “error” occurs in the output from the
pre.sh
command, ifon
the execution of synchronize command is aborted
Add configurations
Select the Add
button when completed and configuration is added to RsyncOSX. RsyncOSX adds a trailing / character to both local and remote volume. After selecting the Add button another configuration might be added. Any changes (edit or delete) to configurations are done from the Synchronize view. Additional parameters to rsync might be added utilizing the Parameter button.
Assist
The main objective for the assist function is to ease adding configurations. Assist picks up the following:
- the name of all catalogs within your home directory
- the path of your home directory
- and if there is added tasks, remote server and remote user from the current profile
There is not possible to save, change or delete values in assist.
Selecting Local
or Remote
transfer the data to the add new configrations screen. The following is transferred from the selected dropdown values to the add view when selecting either Local
or Remote
:
- Local catalog (in Add view):
Local home
+/
+Catalogs
- Remote catalog (in Add view):
~
+/
+Catalogs
- Remote username (in Add view):
Remote users
- Remote server (in Add view):
Remote computers
Local home
: your home catalogCatalogs
: catalogs to synchronize, the catalog is added toLocal home
andRemote home
.Remote users
: remote username ifRemote computers
are used.Remote computers
: name or IP-adress of remote computer
Author RsyncOSX
LastMod 2021-01-18 (10a0ae7)