You can control the manager function with the dscontrol
manager command.
Syntax

>>-dscontrol--manager--+-interval--seconds-------------------------------------------------+-><
+-loglevel--level---------------------------------------------------+
+-logsize--+-unlimited-+--------------------------------------------+
| '-bytes-----' |
+-metric set--+-loglevel--level--------+----------------------------+
| '-logsize--+-unlimited-+-' |
| '-bytes-----' |
+-quiesce--+-server--------------+--+-----------------------------+-+
| '-cluster@port@server-' '-daily--start_hour--end_hour-' |
+-reach set--+-interval--seconds------+-----------------------------+
| +-loglevel--level--------+ |
| '-logsize--+-unlimited-+-' |
| '-bytes-----' |
+-refresh--refresh cycle--------------------------------------------+
+-report--+---------------------+-----------------------------------+
| '-cluster+cluster2...-' |
+-restart--Message--------------------------------------------------+
+-sensitivity--weight-----------------------------------------------+
+-smoothing--index--------------------------------------------------+
+-start----log file--metric_port------------------------------------+
+-status------------------------------------------------------------+
+-stop--------------------------------------------------------------+
+-unquiesce--+-server--------------+--------------------------------+
| '-cluster@port@server-' |
'-version-----------------------------------------------------------'
Parameters
- interval
- Set how often the manager will update the weights of the servers
to the executor, updating the criteria that the executor uses to route
client requests.
- loglevel
- Set the logging level for the manager log.
- level
The number of the level (0 to 5).
The higher the number, the more information that is written to the
manager log. The default is 1. The following are the possible values:
0 is None, 1 is Minimal, 2 is Basic, 3 is Moderate, 4 is Advanced,
5 is Verbose.
- logsize
- Set the maximum size of the manager 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.
- 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 log level is 1. The log size is the maximum number of bytes
to be logged in the metric monitor log file. You can specify either
a positive number greater than zero, or unlimited. The default logsize
is 1 MB.
- quiesce
- Specify no more connections to be sent to a server except subsequent
new connections from the client to the quiesced server if the connection
is designated as sticky and stickytime has not expired. The manager
sets the weight for that server to 0 in every port to which it is
defined. Use this command if you want to do some quick maintenance
on a server and then unquiesce it. If you delete a quiesced server
from the configuration and then add it back, it will not retain its
status prior to being quiesced. For more information, see Quiesce servers or services for maintenance windows.
- server
The IP address of the server as either
a symbolic name or in dotted decimal format.
- cluster@port@server
When
you want to bring down a particular service on a server, like HTTP,
you can now quiesce individual daemons. If you have added server1
to port 80 and port 22 of a cluster, for example, the usual quiesce
command will stop forwarding traffic to server1 on port 80 and port
22. This new option allows you to stop traffic only on port 80 if
you need to stop that particular service.
- daily start_hour end_hour

New feature:
This setting specifies to quiesce the server
at a time of day, start_hour, and unquiesce the
server at a later point, end_hour. The values for start_hour and end_hour are
can range from 0 to 23. For example, (0 0) indicates to quiesce the
server from 12:00 AM to 12:59 AM. (12 13) indicates to quiesce the
server from 12:00 PM to 1:59 PM, which is a 2 hour period. Specify
(-1 -1) to disable the daily quiesce for a particular server.newfeat
- reach set
- Sets the interval, loglevel, and logsize for the reach advisor.
- refresh
- Set the number of intervals before querying the executor for a
refresh of information about new and active connections.
- report
- Display a statistics snapshot report.
- cluster
The address of the cluster you want
displayed in the report. The address can be either a symbolic name
or in IP address format. The default is a manager report display for
all the clusters.
Note: Additional clusters are separated by a plus
sign (+).
- restart
- Restart all servers (that are not down) to normalized weights
(1/2 of maximum weight).
- sensitivity
- Set minimum sensitivity to which weights update. This setting
defines when the manager should change its weighting for the server
based on external information.
- smoothing
- Set an index that smooths the variations in weight when load balancing.
A higher smoothing index will cause server weights to change less
drastically as network conditions change. A lower index will cause
server weights to change more drastically.
- start
- Start the manager.
- 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. See Examples. To change the directory where
the log files are kept, see Logging with Load Balancer.
- metric_port
Port that Metric Server will
use 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 of all the values in the manager that
can be set globally and their defaults.
- stop
- Stop the manager.
- unquiesce
- Specify that the manager can begin to give a weight higher than
0 to a server that was previously quiesced, in every port to which
it is defined.
- server
The IP address of the server as either
a symbolic name or in dotted decimal format.
- cluster@port@server
This
command will unquiesce that particular port for service,
but all other ports will remained quiesced.
- version
- Display the current version of the manager.
Samples
- To set the updating interval for the manager to every 5 seconds:
dscontrol manager interval 5
- To set the level of logging to 0 for better performance:
dscontrol manager loglevel 0
- To set the manager log size to 1,000,000 bytes:
dscontrol manager logsize 1000000
- To specify that no more connections be sent to the server at 130.40.52.153:
dscontrol manager quiesce 130.40.52.153
- To quiesce the HTTP service on server 9.40.25.67, which is on
cluster1:
dscontrol manager quiesce cluster1@9.40.25.67@80
- To set the number of updating intervals before the weights are
refreshed to 3:
dscontrol manager refresh 3
- To get a statistics snapshot of the manager:
dscontrol manager report
- To restart all the servers to normalized weights and write a message
to the manager log file:
dscontrol manager restart Restarting the manager to update code
- To set the sensitivity to weight changes to 10:
dscontrol manager sensitivity 10
- To set the smoothing index to 2.0:
dscontrol manager smoothing 2.0
- To start the manager and specify the log file named ndmgr.log
(paths cannot be set):
dscontrol manager start ndmgr.log
- To display the current status of the values associated with the
manager:
dscontrol manager status
- To stop the manager:
dscontrol manager stop
- To specify that no more new connections be sent to a server at
130.40.52.153 between 2:00 AM and 4:59 PM:
dscontrol manager quiesce 130.40.52.153 daily 2 16
- To specify that the manager can begin to give a weight higher
than 0 to a server at 130.40.52.153 that was previously quiesced:
dscontrol manager unquiesce 130.40.52.153
- To display the current version number of the manager:
dscontrol manager version