sscontrol sitename

Use the sscontrol sitename command to configure a site name.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-sscontrol--sitename--+-delete--filename.ext-----------------------------------+-><
                        +-appendload--filename.ext-------------------------------+   
                        +-report-------------------------------------------------+   
                        +-save--filename.ext-------------------------------------+   
                        +-logsize--name--+-port---------+--+-unlimited---------+-+   
                        |                '-cluster@port-'  '-number of records-' |   
                        +-receivetimeout--name--+-port---------+--seconds--------+   
                        |                       '-cluster@port-'                 |   
                        +-report--save--filename.ext-----------------------------+   
                        '-force--newload--filename.ext---------------------------'   

Parameters

add
Add a new site name.
  • sitename

    An irresolvable host name, requested by the client. Additional site names are separated by a plus sign (+).

cachelife
The amount of time a proximity response is valid and saved in the cache. The default is 1800.
  • value

    A positive number representing the number of seconds a proximity response is valid and saved in the cache.

networkproximity
Determines each server's network proximity to the requesting client. Use this proximity response in the load balancing decision. Set the proximity on or off.
  • value

    The choices are yes or no. The default is no, which means network proximity is turned off.

proportions
Set the proportion of importance for cpu, memory, port (information from any advisors), and system metrics for the Metric Server that are used by the manager to set server weights. Each of these values is expressed as a percentage of the total and the total is always 100.
cpu
The percentage of CPU in use on each load balanced server machine (input from Metric Server agent).
memory
The percentage of memory in use (input from Metric Server agent) on each load balanced server
port
The input from advisors listening on the port.
system
The input from the Metric Server.
proximitypercentage
Sets the importance of the proximity response versus the health of the server (manager weight).
  • value

    The default is 50.

stickytime
The interval during which a client will receive the same server ID previously returned for the first request. The default value of stickytime is 0, which signifies that the site name is not sticky.
  • time

    A positive, non-zero number representing the number of seconds during which the client receives the same server ID previously returned for the first request.

ttl
Sets the time to live. This indicates how long another name server will cache the resolved response. The default value is 5.
  • value

    A positive number representing the number of seconds the name server will cache the resolved response.

waitforallresponses
Sets whether to wait for all proximity responses from the servers before responding to the client request.
  • value

    The choices are yes or no. The default is yes.

weightbound
A number representing the maximum weight that can be set for servers on this site name. The weightbound value set for the site name may be overridden for individual servers using server weight. The default value of site name weightbound is 20.
  • weight

    The value of weightbound.

set
Set the properties of the site name.
remove
Remove this site name.
status
Show current status of a specific site name.

Samples

  • To add a site name:
    sscontrol sitename add 130.40.52.153
  • To turn on network proximity:
    sscontrol sitename set mySite networkproximity yes
  • To set a cache life of 1900000 seconds:
    sscontrol sitename set mySite cachelife 1900000
  • To set a proximity percent of 45:
    sscontrol sitename set mySite proximitypercentage 45
  • To set a site name to not wait for all responses before responding:
    sscontrol sitename set mySite waitforallresponses no
  • To set the time to live to 7 seconds:
    sscontrol sitename set mySite ttl 7
  • To set the proportions of importance for CpuLoad, MemLoad, Port, and System Metric, respectively:
    sscontrol sitename set mySite proportions 50 48 1 1 
  • To remove a site name:
    sscontrol sitename remove 130.40.52.153
  • To show the status for site name mySite:
    sscontrol sitename status mySite
    This command produces output similar to:
    SiteName Status:
    ---------------
    SiteName ........................... mySite
    WeightBound ........................ 20
    TTL ................................ 5
    StickyTime ......................... 0
    Number of Servers .................. 1
    Proportion given to CpuLoad ........ 49
    Proportion given to MemLoad ........ 50
    Proportion given to Port ........... 1
    Proportion given to System metric .. 0
    Advisor running on port ............ 80
    Using Proximity .................... N

Icon that indicates the type of topic Reference topic



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