Operations Guide

Back Next

Starting

This section provides information on how to start the Console client.

Two (Windows) icons for the Console Client are placed in the SSA Program folder by the Installation process. Click the

Console Client

icon to start the client in read-only mode. This mode is used to run search clients while restricting access to System maintenance utilities.

Use the

Console Client (Admin Mode)

icon to allow update activity such as creating, deleting and loading Systems.

Once the Console Server is running, the Console Client can be started using this command:

For Win32:

%SSABIN%\idsconc [-cWORKDIR] [-dX] [-hHOST] [-rhRBHOST]
[-rnRBNAME] [-pPROFILE] [-wWORKDIR] [-vVERBOSITY] [-a]

For Unix:

$SSABIN/idsconc [-cWORKDIR] [-dX] [-hHOST] [-rhRBHOST]
[-rnRBNAME] [-pPROFILE] [-wWORKDIR] [-vVERBOSITY] [-a]

where the optional switches are:

-a: starts the client in Admin mode which permits System maintenance. Omitting this switch will place the Console Client in a non-administrative mode.

-DX: X is the debug level and determines how much debug information will be logged. It must be in the range 0-3. 0 requests no debug information, while 3 requests that all debug information be logged. 0 is the default.
-cWORKDIR: This defines the name of the Work Directory to be used by client programs. This parameter is optional. If specified, it must specify a directory that is accessible to the machine on which the Client is running. At present, this parameter is used only by the Relate Client. If you are not planning to run the Relate Client, then there is no need to supply this parameter.
-hHOST: This parameter may be used to determine which Console Server the client will connect to. It should be in the form
host:port
, where
host
is the hostname or IP address of the machine where the Console Server is running and
port
is the port number on which the Console Server is listening.

The default value is
localhost:1669
.

-pPROFILE: This parameter may be used to define a Profile name. A profile is used to store session state information in the Rulebase. This allows a client to restart using the same settings as the previous time that profile was used. Using a profile can cause problems if you are planning to reinitialize the Rulebase or switch Rulebases mid-session. In such cases, use
-p-
to disable profiles.

-rnRBNAME: These optional parameters may be used to set the initial Rulebase Host and Rulebase Name values for the client. If present these values will override any default values supplied by the Console Server.
-wWORKDIR: This defines the value for
SSAWORKDIR
to be used by the Console Server on behalf of this client. This is a directory on the machine where the Console Server is running.