Advanced Usage
Options
You have the option of starting your rapClient desktop client with the rapclient
command. The following options are supported:
orrapclient
-hrapclient
--help- Displays all command options.
The other options are:
--logwindow
- Opens a window displaying log output.
--logfile
<filename>- Write log output to the file specified. To write to stdout, specify - as the filename.
--logdir
<name>- Writes each synchronization log output in a new file in the specified directory.
--logexpire
<hours>- Removes logs older than the value specified (in hours). This command is used with
--logdir
. --logflush
- Clears (flushes) the log file after each write action.
--confdir
<dirname>- Uses the specified configuration directory.
Configuration File
The RAP Client reads a configuration file. You can locate this configuration file as follows:
- On Linux distributions:
$HOME/.local/share/data/
rapclient
/rapclient
.cfg- On Microsoft Windows systems:
%LOCALAPPDATA%\Scale Logic Rap\
rapclient
.cfg- On MAC OS X systems:
$HOME/Library/Peferences/Scale\ Logic\ RAP/
rapclient
The configuration file contains settings using the Microsoft Windows .ini file format. You can overwrite changes using the RAP Client configuration dialog.
Note
Use caution when making changes to the RAP Client configuration file. Incorrect settings can produce unintended results.
You can change the following configuration settings (must be under the [
section)rapclient
]
remotePollInterval
(default:30000
) – Specifies the poll time for the remote repository in milliseconds.maxLogLines
(default:20000
) – Specifies the maximum number of log lines displayed in the log window.
rapClient Command Line Client
The RAP Client packages contain a command line client,
, that can be used to synchronize RAP files to client machines.rapclientcmd
performs a single sync run and then exits the synchronization process. In this manner, rapclientcmd
processes the differences between client and server directories and propagates the files to bring both repositories to the same state. Contrary to the GUI-based client, rapclientcmd
does not repeat synchronizations on its own. It also does not monitor for file system changes.rapclientcmd
To invoke
, you must provide the local and the remote repository URL using the following command:rapclientcmd
rapclientcmd [OPTIONS...] sourcedir rapclienturl
where sourcedir
is the local directory and rapurl
is the server URL.
Other command line switches supported by
include the following:rapclientcmd
--user
,-u
[user]
- Use
user
as the login name. --password
,-p
[password]
- Use
password
as the password. -n
- Use
netrc (5)
for login. --non-interactive
- Do not prompt for questions.
--silent
,--s
- Inhibits verbose log output.
--trust
- Trust any SSL certificate, including invalid ones.
--httpproxy http://[user@pass:]<server>:<port>
- Uses
server
as HTTP proxy. --nonshib
- Uses Non Shibboleth WebDAV Authentication
--davpath [path]
- Overrides the WebDAV Path with
path
--exclude [file]
- Exclude list file
--unsyncedfolders [file]
- File containing the list of unsynced folders (selective sync)
--max-sync-retries [n]
- Retries maximum n times (defaults to 3)
-h
- Sync hidden files, do not ignore them
Credential Handling
uses the credentials of the GUI synchronization client. If no client is configured, or if you choose to use a different user to synchronize, you can specify the user password setting with the usual URL pattern. For example:rapclientcmd
$ rapclientcmd / https://admin:secret@server/rapclint/remote.php/webdav/
To synchronize the RAP directory Music
to the local directory media/music
, through a proxy listening on port 8080
, and on a gateway machine using IP address 172.16.0.100
, the command line would be:
$ rapclientcmd --httpproxy http://172.16.0.100:8080 \
$HOME/media/music \
https://server/rapclient/remote.php/webdav/Music
will prompt for the user name and password, unless they have been specified on the command line or rapclientcmd
-n
has been passed.