19.56. rpull

Allows to pull entities from a remote RS server into a local RS installation, e.g. from PROD to TEST.

You can always use the terminal for finding out the exact path of the node you want to import. Just navigate to the node you want to export in the remote RS and enter the pwd command as described in Section 19.50.

19.56.1. rpull copy

Allows to copy the fetched entities from a remote RS server into a local RS, e.g. from PROD to TEST. The arguments required are the following:

remoteServer Object resolver query of the remote server, e.g. /remoteservers/PROD. Refer to Section 15.5. Object Resolver for more information on object resolver queries and to Section 12. Remote RS Servers for more information on remote RS servers.
remoteEntityPath The entity path in the remote RS server, e.g. /usermanager/ClassicModelCars. This path can be a directory or a single entity.
localTarget The target in the local RS where the remote entities should be copied to, e.g. /usermanager/import
-c optional flag to indicate that a check has to be performed instead of the real import. It displays all problems found, i.e. it allows to pre-check the real entity import and look for potential errors.
-v optional flag to indicate that report variants should also be imported from the remote RS server. While importing other objects other than reports, this flag is ignored.

You can always use the terminal for finding out the exact path of the node you want to import. Just navigate to the node you want to export in the remote RS and enter the pwd command as described in Section 19.50.

In order to be able to import remote entities, all keys must be set in the remote entities.
In order to be able to import remote reports, their datasources must be able to be mapped to local datasources. This mapping is defined via the /etc/main/rssync.cf configuration file. Details can be found in the Configuration Guide.

The example below imports users from the remote RS REST server named PROD. The entities are being imported from the remote location /usermanager/ClassicModelCars into the locale location /usermanager/import.

rpull copy /remoteservers/PROD /usermanager/ClassicModelCars /usermanager/import

The example below imports reports, including variants, from the remote RS REST server named PROD. The entities are being imported from the remote location /reportmanager/myreports into the locale location /reportmanager/import.

rpull copy -v /remoteservers/PROD /reportmanager/myreports /reportmanager/import

The example below performs a check without performing the real import of the example above:

rpull copy -c -v /remoteservers/PROD /reportmanager/myreports /reportmanager/import

The example below imports files from the remote RS REST server named PROD. The entities are being imported from the remote location /fileserver/myfiles into the locale location /fileserver/import.

rpull copy /remoteservers/PROD /usermanager/ClassicModelCars /usermanager/import

Use: rpull copy [-c] [-v] remoteServer remoteEntityPath localTarget