jRCS Server Installation

Server Installation - Windows

The current versions of jRCS for Windows do not come with a GUI installer and needs to be installed and started from the command line.

The binaries should be extracted to an appropriate location, such as C:\jBASE30\jRCS\bin for jBASE 3.x installations or C:\jBASE4\jRCS\bin for jBASE 4.x or 5.x installations. A command window can then opened at that location, so that jRCS can be installed and started

C:\jbase4\jRCS\bin>jrcs -help

Usage: jrcs [-install | -uninstall | -start | -stop]

-install installs the service

-uninstall uninstalls the service

-start starts the service

-stop stops the service

A "jrcslicensetool" binary is also supplied. This allows the generation of an Installation ID and the subsequent installation of a license key.

C:\jbase4\jRCS\bin>jRCSLicenseTool

Generates an installation identifier or manages JRCS licenses.

jrcslicensetool [-i [key]] [-g] [-p]

Options:

-i [key] install a new license key. If a key is not specified, prompts for the key.

-g generates an installation identifier for the current machine.

-p prints license information, including installed and used license counts.

Once the jRCS license has been installed, license usage information can also be obtained:

C:\jbase4\jRCS\bin>JRCSLicenseTool -p

JRCS License Information:

Conventional licenses: 0

.NET client licenses: 5

Java client licenses: 5

Expiration date: 12/31/09

Allocated Server Licenses:

IP Address Conventional .NET Java

Allocated Enterprise Licenses (Sessions):

IP Address Conventional .NET Java

192.168.1.2 0 ( 0) 1 ( 1) 0 ( 0)

Server Installation - UNIX

A "jrcsd" and "jrcslicensetool" binary are supplied for UNIX installations. These should be installed in an appropriate location, such as /usr/jbc/jrcs/bin for jBASE 3.x installations or /opt/jbase4/jrcs/bin for jBASE 4.x/5.x installations.

For Linux installations, a "jrcsd" script is also provided which should be placed in the /etc/pam.d folder.

The "jrcsd" daemon can then be started as root, with or without command line switches.

Usage of "jrcslicensetool" is identical to that for Windows.

jRCS Server Command Line Switches (UNIX Systems Only)

The following lists the switches which can be given to jRCS server on the command line:

Switch	Description
-d <level>	Specifies the debug level for log messages. Debug level 0 (default) causes only critical errors to be logged. Debug level 9 (highest) directs jRCS to log every JCML request and reply, along with parameters. The length of individual parameters written to the log is limited to a maximum of 1024 bytes.
-p <number>	Sets the initial TCP port number to <number> instead of the default of 8236.
-b <number>	Sets the initial jBASE port number to <number> instead of the default of 15000. If this switch is not supplied, jRCS will use port range 15000-32767 for creating jRCS sessions.
-f <path>	Directs jRCS to log it's debug messages to a file specified by <path> instead of system log. If this switch is not set, jRCS logs to the application log via the system logger.
-q	Quiet. Disables I/O redirection from server to client. If this flag is set, jRCS will never relay output and debugging requests from the host to the client. If a host process encounters an output statement or hits a debug condition, the process will abort.

jRCS Server Registry Settings (Windows Systems Only)

Due to the fact that it is impossible to reasonably pass command-line parameters to a Windows service, the Windows version of jRCS reads the registry key located under HKEY_LOCAL_MACHINE\Software\jRCS to obtain the equivalent of settings listed in Table 1-1. The registry settings are detailed in Table 1-2.

Value	Type	Purpose
DebugLevel	DWORD	Equivalent of the -d command line switch in UNIX.
BasePIB	DWORD	Equivalent of the -b command line switch in UNIX.
ListenPort	DWORD	Equivalent of the -p command line switch in UNIX.
Quiet	DWORD	Equivalent of the -q command line switch in UNIX. (1 - enable quiet mode, 0 or missing - disable quiet mode)
LogFile	String	Equivalent of the -f command line switch in UNIX.

jBASE Remote Connectivity Service