sscontrol manager
Use the sscontrol manager command to control the manager.
Syntax
>>-sscontrol--manager--+-interval--seconds----------------------+->< +-loglevel--level------------------------+ +-logsize--+-unlimited-+-----------------+ | '-bytes-----' | +-metric set--+-loglevel--level--------+-+ | '-logsize--+-unlimited-+-' | | '-bytes-----' | +-reach set--+-interval--seconds------+--+ | +-loglevel--level--------+ | | '-logsize--+-unlimited-+-' | | '-bytes-----' | +-report--sitename+sn2+...+snN-----------+ +-restart--message-----------------------+ +-sensitivity--weight--------------------+ +-smoothing--smoothing index-------------+ +-start--+----------------------+--------+ | '-logfile--metric_port-' | +-status---------------------------------+ +-stop-----------------------------------+ '-version--------------------------------'
Parameters
- interval
- Set how often the manager updates the weights of the servers.
- interval
- Set how often the advisor will query the servers for information.
- seconds
A positive number in seconds that represents how often the manager updates weights. The default is 2.
- seconds
- loglevel
- Set the logging level for an advisor log.
- level The number of the level (0 to 5). The default is 1. The higher the number, the more information that is written to the advisor log. The possible values are:
- 0 is None
- 1 is Minimal
- 2 is Basic
- 3 is Moderate
- 4 is Advanced
- 5 is Verbose
- level
- logsize
- Set the maximum size of an advisor log. When you set a maximum
size for the log file, the file will wrap; when the file reaches the
specified size, the subsequent entries are written from the top of
the file, overwriting the previous log entries. Log size cannot be
set smaller than the current size of the log. Log entries are time–stamped
so you can tell the order in which they were written. The higher you
set the log level, the more carefully you should choose the log size,
because you can quickly run out of space when logging at the higher
levels.
- bytes
The maximum size in bytes for the manager log file. You can specify either a positive number greater than zero, or unlimited. The log file may not reach the exact maximum size before being overwritten because the log entries vary in size. The default value is 1 MB.
- bytes
- metric set
- Sets the loglevel and logsize for the metric monitor log. The loglevel is the metric monitor logging level (0 - None,1 - Minimal,2 - Basic,3 - Moderate, 4 - Advanced, or 5 - Verbose). The default loglevel is 1. The logsize is the maximum number of bytes to be logged in the metric monitor log file. You can specify either positive number greater than zero, or unlimited. The default logsize is 1.
- reach set
- Sets the interval, loglevel, and logsize for the reach advisor.
- report
- Display a statistics snapshot report.
- sitename
An integer greater than or equal to zero. This value should be no larger than 3. If retries keyword is not configured, the number of retries defaults to zero.
- sitename
- start
- Start the advisor. There are advisors for each protocol. The default ports are as follows:
- log file
File name to which the manager data is logged. Each record in the log is time-stamped.
The default file is installed in the logs directory.
- metric_port
Port that Metric Server uses to report system loads. If you specify a metric port, you must specify a log file name. The default metric port is 10004.
- status
- Display the current status and defaults of all the global values in the manager.
- stop
- Stop the manager.
- version
- Display the current version of the manager.
Samples
- To set the updating interval for the manager to every 5 seconds:
sscontrol manager interval 5
- To set the level of logging to 0 for better performance:
sscontrol manager loglevel 0
- To set the manager log size to 1,000,000 bytes:
sscontrol manager logsize 1000000
- To get a statistics snapshot of the manager:
sscontrol manager report
This command produces output similar to:---------------------------------- | SERVER | STATUS | ---------------------------------- | 9.67.129.221| ACTIVE| | 9.67.129.213| ACTIVE| | 9.67.134.223| ACTIVE| ---------------------------------- -------------------------- | MANAGER REPORT LEGEND | -------------------------- | CPU | CPU Load | | MEM | Memory Load | | SYS | System Metric | | NOW | Current Weight | | NEW | New Weight | | WT | Weight | -------------------------- ------------------------------------------------------------------------ | mySite | WEIGHT | CPU 49% | MEM 50% | PORT 1% | SYS 0% | ------------------------------------------------------------------------ | |NOW NEW | WT LOAD | WT LOAD | WT LOAD | WT LOAD | ------------------------------------------------------------------------ | 9.37.56.180 | 10 10 |-99 -1|-99 -1|-99 -1| 0 0| ------------------------------------------------------------------------ | TOTALS:| 10 10 | -1| -1| -1| 0| ------------------------------------------------------------------------ ----------------------------------------- | ADVISOR | SITENAME:PORT | TIMEOUT | ----------------------------------------- | http | 80 | unlimited | -----------------------------------------
- To restart all the servers to normalized weights and write a message
to the manager log file:
sscontrol manager restart Restarting the manager to update code
This command produces output similar to:320-14:04:54 Restarting the manager to update code
- To set the sensitivity to weight changes to 10:
sscontrol manager sensitivity 10
- To set the smoothing index to 2.0:
sscontrol manager smoothing 2.0
- To start the manager and specify the log file named ndmgr.log (paths
cannot be set)
sscontrol manager start ndmgr.log
- To display the current status of the values associated with the
manager:
sscontrol manager status
This command produces output similar to the following:Manager status: ============= Metric port................................... 10004 Manager log filename.......................... manager.log Manager log level............................. 1 Maximum manager log size (bytes).............. unlimited Sensitivity level............................. 5 Smoothing index............................... 1.5 Update interval (seconds)..................... 2 Weights refresh cycle......................... 2 Reach log level............................... 1 Maximum reach log size (bytes)................ unlimited Reach update interval (seconds)............... 7
- To stop the manager:
sscontrol manager stop
- To display the current version number of the manager:
sscontrol manager version