sscontrol manager

Use the sscontrol manager command to control the manager.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-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.

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
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.

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.

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

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: March 23, 2018 0:18
File name: rcmd_sscontrolmanager.html