Server Startup Options

Normally, the server administrator will use the web browser interface to access server commands and configure server options. Certain commands can also be set by Command Prompt options at startup, and a few rarely needed commands are set exclusively in this way and do not have an equivalent parameter in the browser interface.

For commands that do not have a browser equivalent, instead of typing commands into the Command Prompt or Terminal, create a shortcut and specify the startup command with options in the Target path (Windows), or create a bash script (Mac).

To specify setup options:

  1. Shut down the Vectorworks server software. See Shutting Down the RLM server.

  2. Open the Command prompt (Windows) or the Terminal (on Mac).

  3. Navigate to the Vectorworks Site Protection Server folder.

  4. Enter the startup command followed by a dash and the option name, and then press Enter to restart the RLM server.

rlm.exe -option_command 

To be in effect, the startup option must be specified every time the server is launched.

Startup Option
Description
Example

-c license_file

Specifies which license file ( .lic) to use (normally, all license files are used)

rlm.exe -c ABCD1234.lic

-c folder_name

If not using all licenses, place the license files to use in a folder, and provide the folder name in the option. Only those licenses are used.

rlm.exe -c licenses

-dlog file_path file_name

Sets up the location and file name of the Debug log; the file path can be specified as a relative or absolute path. If using a relative path, the current folder is the Vectorworks Site Protection Server installation folder. At restart, the Debug log is overwritten.

Also available in the browser interface (Windows); see Debug Log Setup.

Windows example: rlm.exe -dlog Log\dlog.txt 

Mac example:  /rlm -dlog Log/dlog.txt 

-dlog + file_path file_name

Creates a Debug log as described previously; adding a + sign to the options automatically appends data to the log, rather than overwriting it at restart.

Also available in the browser interface; see Specifying Server Options.

rlm.exe -dlog + Log\dlog.txt

-nows

Prevents the server from displaying in a web browser interface; all commands must be executed from the Command Prompt or Terminal.

To turn the web browser interface back on, restart the server without the -nows option.

Also available in the browser interface (Windows); click Manage Windows Service from the main Server Administration screen, and select the Admin webserver disabled option.

rlm.exe -nows

-ws port_number

Modifies the port number of the Administration screen; see Modifying the Administration Screen Port Number.

Also available in the browser interface (Windows); click Manage Windows Service from the main Server Administration screen, and enter the new port number in Webserver port #.

rlm.exe -ws 5056

-x rlmdown

-x rlmremove

Controls whether the rlmdown and rlm remove commands are disabled. Disable the rlmdown command to prevent the ISV server from being shut down. Disable the rlmremove command to turn off the option to remove a license in use by a client.

    -x disables both commands

    -x rlmdown

    -x rlmremove

Also available in the browser interface (Windows); click Manage Windows Service from the main Server Administration screen, and select the rlmdown command disabled and/or the rlmremove command disabled option.

-x rlmdown

-install_service service_name

(Windows)

Registers the server software as a Windows service; provide the name for the service. This is useful if there is no browser on the server machine, but you want the server software to launch automatically.

Also available in the browser interface; see Registering a Windows Service

-install_service rlm

-isv startup_delay

Delays the startup time of the ISV server by the specified number of seconds. If the server system is slow and needs time to locate the dongle driver, this provides extra time.

Also available in the browser interface (Windows); click Manage Windows Service from the main Server Administration screen, and enter the delay in seconds in ISV server startup delay.

-isv startup_delay 10

-v

Launches the RLM server, prints the version number to the Command Prompt, and exits.

Also available in the browser interface; click System Info from the main Server Administration screen.

-v

-info

Prints information about all RLM copies running on the server machine over the last 24 hours, and exits.

Also available in the browser interface; click System Info from the main Server Administration screen.

-info

~~~~~~~~~~~~~~~~~~~~~~~~~

Windows Service Settings

Requiring Server Passwords

Controlling RLM Options

 

vectorworks.net