dscontrol cluster
Configure clusters and cluster properties with the dscontrol cluster command.
Syntax
>>-dscontrol--cluster--+-add--cluster--+--c2...--+-address--address-----------------------+-+->< | '-proportions--active--new--port--system-' | +-set--cluster--+--c2...----proportions--active--new--port--system---+ +-remove--cluster----------------------------------------------------+ +-report--cluster----------------------------------------------------+ '-status--cluster----------------------------------------------------'
Parameters
- add
- cluster
The cluster name or address to which clients connect. The cluster value is either a symbolic name or in IP address format.
With the exception of the dscontrol cluster add command, you can use an at symbol (@) symbol to act as a wild card. For example, the following command will result in setting a weightbound of 80 to all clusters:dscontrol cluster set @ weightbound 80
Note: Additional clusters are separated by a plus sign (+).
- address address
The unique IP address of the TCP machine as either a host name or in IP address format. If the cluster value is unresolvable, you must provide the IP address of the physical machine.
- proportions At the cluster level, set the proportion of importance for active connections (active), new connections (new), information from any advisors (port), and information from a system monitoring program such as Metric Server (system) that are used by the manager to set server weights. Each of these values, described below, is expressed as a percentage of the total and they therefore always total 100. For more information see Tuning the proportion of importance given to status information.
- active
A number from 0–100 representing the proportion of weight to be given to the active connections. The default is 50.
- new
A number from 0–100 representing the proportion of weight to be given to new connections. The default is 50.
- portA number from 0–100 representing the proportion of weight to be given to the information from the advisors. The default is 0.Note: When an advisor is started and if the port proportion is 0, Load Balancer automatically sets this value to 1 in order for the manager to use the advisor information as input for calculating server weight.
- system
A number from 0–100 representing the proportion of weight to be given to the information from the system metrics, such as from Metric Server. The default is 0.
- active
- cluster
- set
- Set the properties of the cluster.
- remove
- Remove this cluster.
- report
- Show the internal fields of the cluster.
- status
- Show current status of a specific cluster.
Samples
- To add cluster address 130.40.52.153:
dscontrol cluster add 130.40.52.153
- To remove cluster address 130.40.52.153:
dscontrol cluster remove 130.40.52.153
- To set the relative importance placed on input (active, new, port,
system) received by the manager for servers residing on cluster 9.6.54.12:
dscontrol cluster set 9.6.54.12 proportions 60 35 5 0
- To show the status for cluster address 9.67.131.167:
dscontrol cluster status 9.67.131.167