arserver

The arserver.jar executable is the main component of . It handles all interactions between clients and the database, making all access to the system dependent on it.

On Windows, arserver.jar is usually started by armonitor which runs automatically as a service called . Normally, you should use this service to control arserver.

On UNIX, the arsystem script usually controls arserver.jar through armonitor. Normally, you should use arsystem to start the arserver process (see arsystem).

On UNIX systems, the arsignal command causes arserver to load or reload information (see arsignal-exe-or-arsignal). Generally, these signals are sent after a manual repair or restore operation is performed. However, they do not cause damage or adversely affect users accessing .

Synopsis

c:\progfm\java\jdk\bin\java.exe[Java path ] -jar arserver.jar [-s serverName] [-i ARSystemServerInstallDir] [-l licenseDirectory] [-m] [-t] [-checkdb [logFileNameWithAbsolutePath]]

The -checkdb option is a standalone option. When you use this option, the process checks the consistency of the  database, reports the results in the checkdb log file, and then quits. Therefore, do not include the -checkdb option with arserver.jar in the armonitor.conf file.

Options

You can specify the following options in any order on the command line:

• -i—Specifies the directory in which the  was installed.
• -l—Specifies the directory in which  license files are stored.
• -m—(Windows only) Runs the process in manual mode, not as a Windows service. If you run the process in a command window, you must use this option.
• -s—Specifies the name of the server that you specified during the installation of . When multiple monitors are running on the same host, this option can be used to identify a monitor process.
• -t—Logs all startup and initialization activities and writes the information to the arstartup _number.log file. This file is in
  • (UNIX) ARSystemServerInstallDir/bin
  • (Windows) ARSystemServerInstallDir
• -checkdb—Runs the server instance in the database consistency checker mode. See Checking-the-database-tables.

Running arserver.jar with the checkdb option starts only the database consistency checker, not the main .

Environment

ARCONFIGDIR
(UNIX only) Directory in which the ar.conf file is stored. The arsystem script sets ARCONFIGDIR to ARSystemServerInstallDir/conf, and you should not need to change this value. However, arsystem does not modify ARCONFIGDIR if a preset value is found.

ARDATE
Format used for date-time fields.

(Windows only) This value consists of a string of operators defined by Regional Settings. If you do not set this variable, the system uses the date format specified in the Regional Settings of the user account that runs the service.

(UNIX only) This value consists of a string of operators defined by the strftime library call. Some combinations are successfully displayed but cannot be translated for input. If you do not set ARDATE, the system uses the date format for the language specified by the LANG variable.

ARDATEONLY
Format used by the program for date fields.

(Windows only) This value consists of a string of operators defined by Regional Settings. If you do not set this variable, the system uses the date format specified in the Regional Settings of the user account that runs the service.

(UNIX only) This value consists of a string of operators defined by the strftime library call. Some combinations are successfully displayed but cannot be translated for input. If you do not set ARDATEONLY, the system uses the date format for the language specified by the LANG variable.

ARTIMEONLY
 Format used by the program for time-of-day fields.

(Windows only) This value consists of a string of operators defined by Regional Settings. If you do not set ARTIMEONLY, the system uses the date format specified in the Regional Settings of the user account that runs the service.

(UNIX only) This value consists of a string of operators defined by the strftime library call. Some combinations are successfully displayed but cannot be translated for input. If you do not set ARTIMEONLY, the system uses the time format for the language specified by the LANG variable.

LANG
(UNIX only) This value establishes the locale for , based on information obtained during installation. Normally, this setting is managed by the arsystem script.

LC_ALL
(UNIX only) This value establishes the locale for , based on information obtained during installation. Normally, this setting is managed by the arsystem script.

Files

• Windows
  • ARSystemServerInstallDir\Conf\ar.cfg
  • WindowsSystemDir\drivers\etc\services

• UNIX
  • ARSystemServerInstallDir/conf/ar/
  • ARSystemServerInstallDir/conf/ar.conf
  • /etc/services