sscontrol sitename
Use the sscontrol sitename command to configure a site name.
Syntax
>>-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 (+).
- sitename
- 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.
- value
- 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.
- value
- 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.
- value
- 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.
- time
- 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.
- value
- 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.
- value
- 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.
- weight
- 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