Operations Guide

10.5 HotFix 1
- 10.5
- 10.2 HotFix 1
- 10.2
- 10.1 HotFix 1
- 10.1
- 10.0 HotFix 1
- 10.0

Back Next

Parameters Used for Starting the Servers

When you start the servers in a server group, you can specify the server parameters or switches to manage the way you want the servers to start.

Parameters for the Rulebase and Search Servers

When you start a Rulebase or Search Server, you can specify the following parameters:

-e: Indicates not to shut down the secondary servers when the primary server shuts down.
-g<Server Group Connection Name>,<Rulebase Connection String>: Adds the server to the server group.
Use one of the following formats for the rulebase connection string:

odb:0:userid/password@service

iir:rb
-G<Server Group Connection Name>,<Rulebase Connection String>: Adds the Synchronization server to the server group.
-o<Restart Option>: Indicates how the server must behave when the connection to the database is lost. You can use one of the following options:
r
. Indicates to restart the server.
1
. Indicates to check whether the database table is accessible. If the database table is accessible, the server connects to the database. If the database table is not accessible, the server waits until the database connection is restored.
2
. Indicates to restore the database connection.
0
. Indicates to retry until the database connection is restored.
-t<Number of Retries>,<Frequency>: Indicates the maximum number of attempts for the secondary server to establish the database connection and the time interval between two attempts. Default number of attempts is 500, and default time interval is 5 seconds.
-w<Frequency>,<Priority>: Indicates the polling frequency in seconds and the priority for the server. When the primary server is down, the secondary server with the highest priority becomes the primary server. The number 1 indicates the highest priority. Default polling frequency is 1.
-m<Port Number>: Indicates the port number on which the Rulebase Server listens.
-n<Port Number>: Indicates the port number on which the Search Server listens.

Parameters for the Console Server

When you start a Console Server, you can specify the following parameters:

-g<Rulebase Server Group Connection Name>,<Rulebase Connection String>: Adds the server to the Rulebase Server Group.
Use one of the following formats for the rulebase connection string:

odb:0:userid/password@service

iir:rb
-n<Port Number>: Indicates the port number on which the Console Server listens.
-o: Indicates not to start other servers.
-h<Host Name>: Indicates the server that you want to automatically start.

Parameters for the XML Search Server

When you start an XML Search Server, you can specify the

-x<Port Number>

parameter that indicates the port number on which the XML Search Server listens.

rbsgdown Utility

Use the rbsgdown utility to shut down all the primary and secondary Rulebase and Synchronization Servers. You can specify the command at any node. The

rbsgdown

utility stops all the clients connected to the Rulebase and Synchronization servers.

If the Rulebase server includes

-e

switch in the start-up scripts, the rbsgdown utility shuts down only the primary servers.

In the following examples, the

rbsgdown

utility stops the Rulebase and Synchronization servers within the server group called

franky

rbsgdown -gfranky,<Rulebase Connection String>

rbsgdown -Gfranky,<Rulebase connection string>

Use one of the following formats for the rulebase connection string:

odb:0:userid/password@service

iir:rb

Example

The name of the RBSG used in this example is

franky

The environment variable %SSA_GRPDB% contains the connection string to the cluster database. This database must contain the Rulebase objects and the

IDS_RB_GROUP

table. For example, it might be defined as

odb:99:uid/pwd@clusterdb

Start the first Rulebase Server in the group:

set SSA_PRM="IIR rb1 Server for group port 9997"
set SSA_LOGS=-1%SSAWORKDIR%\idsrb1v.log -2%SSAWORKDIR%\idsrb1v.err -3%SSAWORKDIR%\idsrb1v.dbg
set SSA_ISSUP_CMD=start %SSA_PRM% "%SSABIN%\ssasrsv"
%SSA_ISSUP_CMD% -m9997 -gfranky,%SSA_GRPDB% -w1 %SSA_LOGS%

UNIX example

SSA_LOGS="-1$SSAWORKDIR/idsrb1v.log -2$SSAWORKDIR/idsrb1v.err -3$SSAWORKDIR/idsrb1v.dbg"
export SSA_LOGS
$SSABIN/ssasrsv -m9997 -gfranky,$SSA_GRPDB -w1 $SSA_LOGS

Start a second Rulebase Server in the same group:

set SSA_PRM="IIR rb2 Server for group port 9999"
set SSA_LOGS=-1%SSAWORKDIR%\idsrb2v.log -2%SSAWORKDIR%\idsrb2v.err -3%SSAWORKDIR%\idsrb2v.dbg
set SSA_ISSUP_CMD=start %SSA_PRM% "%SSABIN%\ssasrsv"
%SSA_ISSUP_CMD% -m9999 -gfranky,%SSA_GRPDB% -w1 %SSA_LOGS%

UNIX example

SSA_LOGS="-1$SSAWORKDIR/idsrb2v.log -2$SSAWORKDIR/idsrb2v.err -3$SSAWORKDIR/idsrb2v.dbg"
export SSA_LOGS
$SSABIN/ssasrsv -m9999 -gfranky,$SSA_GRPDB -w1 $SSA_LOGS &

Start the first Synchronization server in the group:

$SSABIN/ssasrsv -s$SSA_XSPORT -n
$SSA_SEPORT -Gmygroup,$SSA_RBNAME -gmygroup,$SSA_RBNAME $SSA_XSY_LOGS

If the two servers are started on the same machine they must have different port numbers (9997 and 9999 respectively). If they are started on different machines they could use the same port numbers.

We now have two Rulebase Servers and a Synchronization server running. One will become the Primary Rulebase for this RBSG and the other will go into Secondary polling mode where it will just monitor the first Rulebase and take over if it detects that the Primary Rulebase has ceased to work.

We may start as many Rulebase Servers as necessary. All additional servers will become secondary servers.

Start a Search Server:

set SSA_PRM="IIR se Server on %SSA_SEHOST%"
set SSA_LOGS=-1%SSAWORKDIR%\idssexx.log -2%SSAWORKDIR%\idssexx.err -3%SSAWORKDIR%\idssexx.dbg
set SSA_ISSUP_CMD=start %SSA_PRM% "%SSABIN%\ssasrsv"
%SSA_ISSUP_CMD% -n%SSA_SEPORT% -gfranky,%SSA_GRPDB% %SSA_LOGS%

UNIX example

SSA_LOGS="-1$SSAWORKDIR/idssexx.log -2$SSAWORKDIR/idssexx.err -3$SSAWORKDIR/idssexx.dbg"
export SSA_LOGS
$SSABIN/ssasrsv -n$SSA_SEPORT -gfranky,$SSA_GRPDB $SSA_LOGS &

Do not assign a RB Server port to the Search Server, as it will automatically determine the correct one based on the

-g

parameter. An error will be generated if a RuleBase Server and the

-g

switch are both specified.

Start the Console Server:

set SSA_PRM="IIR cs Server on %SSA_CSHOST%"
set SSA_LOGS=-1%SSAWORKDIR%\idscsxx.log -2%SSAWORKDIR%\idscsxx.err -3%SSAWORKDIR%\idscsxx.dbg
set SSA_ISSUP_CMD=start %SSA_PRM% "%SSABIN%\ssacssv"
set SSA_ISSUP_HOSTS=-hco%SSA_COHOST% -hse%SSA_SEHOST% -hxm%SSA_XMHOST% -gfranky,%SSA_GRPDB% %SSA_ISSUP_CMD% -o -n%SSA_CSPORT% %SSA_ISSUP_HOSTS% -w%SSAWORKDIR%
%SSA_LOGS%

UNIX example


SSA_LOGS="-1$SSAWORKDIR/idscsxx.log -2$SSAWORKDIR/idscsxx.err -3$SSAWORKDIR/idscsxx.dbg"
export SSA_LOGS
SSA_ISSUP_HOSTS="-hco$SSA_COHOST -hse$SSA_SEHOST -hxm$SSA_XMHOST -gfranky,$SSA_GRPDB"
export SSA_ISSUP_HOSTS
$SSABIN/ssacssv -o -n$SSA_CSPORT $SSA_ISSUP_HOSTS -w$SSAWORKDIR $SSA_LOGS &

Do not assign a Rulebase Server port to the Console Server, as it will automatically determine the correct one based on the

-g

parameter. Use the

-o

switch to prevent Search and Rulebase Servers from being spawned automatically.

Starting the Servers in Server Groups

Download Guide

Watch

Comments

Communities

Knowledge Base

Success Portal