dscontrol cluster

Configure clusters and cluster properties with the dscontrol cluster command.

Syntax

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

    • port
      A 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.

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

Icon that indicates the type of topic Reference topic



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