Document toolboxDocument toolbox

14.1 Gantt Router

What does the Gantt Router do?

The Gantt Router is the point of contact for Gantt clients to connect to ServiceOptimizer. It processes the user's login information and then connects the Gantt client through to an FRU Process.

 

 Example syntax: MUST only be run by spsysmon

NB All parameters are supplied by spsysmon

ParameterOptionsDescription
-d <database>  Mandatory database connection string (supplied by 14.1 System Monitor 1 spsysmon). 
[-c <num>] The default number to use is: four.

Number of database connections to use. Should be the number of clients likely be to logging on at any given time- it can be as high as sp409.listener_count(14.1 API Agent), but should not need to be as high as this. The default should be acceptable. 

Database Connection usage

The GanttRouter only uses a database connection while the user credentials are validated and FRU availability is ascertained. The connection is not used while the Gantt chart is loading, nor is it used during normal Gantt operations.

-i <componentId>  Component identifier for this component. This is supplied by the System Monitor
[-m <monitorId>]  Component identifier for System Monitor. This is supplied by the System Monitor. This parameter is optional, if it is not present then it is assumed that there is no System Monitor controlling this process. 
[-S secsToSleep]  This is for ServicePower internal use only, and tells the Gantt Router to pause for the specified number of seconds during the process initialisation. 
[-n <retryLimit>]Default value is set to 3 if a value is not specified. Number of times the FRU process will attempt to reconnect to the database before reporting a failure.
[-r] <retryDelay>] Default value is set to 3 if a value is not specified.

Time interval between database reconnection attempts.  

Care must be taken not to set the time interval too high as blocking threads will cause issues.

[-h]  Display usage message. 

System Parameters

The following sp083_system_parameters apply specifically to the configuration of the API Agent and control how it manages the various aspects of its behaviour:

Parameter

Description

gr_failed_login_limit

Number of failed login attempts allowed, after which Gantt Router will refuse all further login attempts.  Only affects server behaviour to prevent a Denial Of Service attack on the server - clients can, and do, adopt their own behaviour.

gr_max_num_gantts

Maximum number of concurrent connections to the Gantt Router.  Once this number is reached, additional connection attempts are rejected.

Logging

The Gantt Router logfiles are very important for use when diagnosing faults with communcations to the ServiceGaANTT clients. As such, it is wise to set these up such that they can hold a complete day's worth of tracing within a single file. Application Logfiles gives more details.