rdm-tfs
Remote Transactional File Server
Synopsis
rdm-tfs [OPTIONS]... [input_file [arg]... ]
Description
rdm-tfs is a command-line utility to run the Transactional File Server.
A TFS is needed for RDM databases. The TFS can either be built into
an application or it can be run separately through this utility.
This utility may be cleanly terminated by issuing SIGTERM
Issuing SIGINT will terminate the utility immediately.
The Transactional File Server (TFS) utility instantiates a TFS that can be accessed by one or more remote clients using either TCP/IP protocol or shared-memory protocol. If both are enabled, they can be used simultaneously by different client sessions. rdm-tfs may run on the same computer as a runtime, or on a different computer, provided the different computer's domain name is visible to the runtime through TCP/IP.
rdm-tfs may be installed as a Windows service, or started as a daemon process. To determine if rdm-tfs is already running, use the --query option (the --query option will work whether rdm-tfs has been started in the foreground or background).
On Windows, you may install rdm-tfs as a service that will run automatically by using the --install option. The PATH must list the fully qualified path to the rdm-tfs utility, or to the directory in which it resides. All required DLLs must reside either in the same directory as rdm-tfs. This option requires administrative privilege. To stop/start the rdm-tfs service, use the Windows service control manager.
When this utility is run as a foreground process, it may be cleanly terminated by issuing SIGTERM.
| -h, --help | Display this usage information |
| --version | Display the version information |
| -q, --quiet | Quiet mode. No information will be displayed |
| --docroot=path | The location of the docroot directory. (See Database Storage Location) |
| --listen=interface | Enable the listener on a given interface ('--listen=none', '--listen=tcp', '--listen=shm', or '--listen=all'). The default is 'all'. |
| --service=service | Enable one or more services. Supported values are: 'all', 'none', 'rdm', 'sql' and 'rest'. Multiple values can be specified with a comma (e.g. --service=rdm,sql). The default is 'all'. |
| -n, --name=name | Specifies the server port (TCP/IP) or name (non-TCP-IP) for connections. The default port is "21553" and the default name is "21553". If a number is specified, it will be used for the TCP/IP port and the server name. If a string or invalid port number is specified, it will be used as the server name, and the TCP/IP transport will not be initialized. |
| --start | Start the server in the background |
| --stop | Stop the server |
| --query | Query the execution status of the server |
| --logfile=name | Log output to the specified log file |
| --log-category=category | Set the log category (this can be specified more than
once for multiple categories) - the default is all) |
| --log-level=level | Set the log level ('--log-level=all', '--log-level=error', '--log-level=warning', '--log-level=info', '--log-level=mesg', or a number (5-99)) - the default is '99') |
| Option | Description |
|---|---|
| --install=exepath | Install the server as a service with the specified executable path |
| --uninstall | Uninstall the executable as a service |
| --serviceuser=user | User account to install server as service (only valid with --install option) |
| --servicepw=password | User account password to install server as service (only valid with --install option) |
See Also