Configure servers and modify existing server configurations
with the dscontrol server command.
Syntax

>>-dscontrol--server--+-add--cluster@port@server--+-address--address--------------------------------------------------+-+-><
| +-advisorrequest--string--------------------------------------------+ |
| +-advisorresponse--string-------------------------------------------+ |
| +-encapforward--+-yes-+--encaptype--+-ipip-+--encapcond--+-always-+-+ |
| | '-no--' '-gre--' '-auto---' | |
| +-fixedweight--value------------------------------------------------+ |
| +-sticky--value-----------------------------------------------------+ |
| '-weight--value-----------------------------------------------------' |
+-set--cluster@port@server--+-advisorrequest--string--------------------------------------------+-+
| +-advisorresponse--string-------------------------------------------+ |
| +-encapforward--+-yes-+--encaptype--+-ipip-+--encapcond--+-always-+-+ |
| | '-no--' '-gre--' '-auto---' | |
| +-fixedweight--value------------------------------------------------+ |
| +-sticky--value-----------------------------------------------------+ |
| '-weight--value-----------------------------------------------------' |
+-remove--cluster@port@server---------------------------------------------------------------------+
+-report--cluster@port@server---------------------------------------------------------------------+
'-status--cluster@port@server---------------------------------------------------------------------'
Parameters
- add
- Add this server.
- cluster
The address of the cluster as either
a symbolic name or in IP address format. You can use an at symbol
(@) to act as a wild card. For instance, the following command will
result in adding ServerA to port 80 on all clusters:
dscontrol server add @80@ServerA
Note: Additional
clusters are separated by a plus sign (+)
.
- port
The number of the port. You can use
an at symbol (@) to act as a wild card. For instance, the following
command will result in adding ServerA to all clusters on all ports:
dscontrol server add @@ServerA
Note: Additional
ports are separated by a plus sign (+).
- server
The server is the unique IP address
of the TCP server machine as either a symbolic name or in IP address
format. Or, if you use a unique name that does not resolve to an IP
address, you must provide the server address parameter on the dscontrol
server add command.
Note: Additional servers are separated by a plus
sign (+).
- address
The unique IP address of the TCP server machine
as either a host name or in IP address format. If the server is not
able to be resolved, you must provide the address of the physical
server machine.
- advisorrequest
String
- advisorresponse
String
- encapforward value
Specifies to enable
encapsulation forwarding.
Value can be yes or no.

New feature:
Use encapsulation forwarding when the back-end
server is not located on the same network segment or if you are using
virtualization technology and need to forward packets that are otherwise
unable to be forwarded.newfeat
- encaptype value
Specifies the type
of encapsulation forwarding.
Value can be:
- encapcond value
Specifies the conditions
in which to enable encapsulation forwarding.
Value can
be:
- fixedweight
The fixedweight option allows you to specify
whether you want the manager to modify the server weight or not. If
you set the fixedweight value to yes, when the manager runs it will
not be allowed to modify the server weight. For more information,
see
Managing traffic with server weights.
- sticky
Allows a server to override the stickytime setting
on its port. The default value of yes means that the server retains
the normal affinity that is defined for the port. Setting the value
to no will configure Load Balancer to not send the client to a specific
server the next time it issues a request on that port, regardless
of the stickytime setting of the port.
Sticky
is valid only for conn+affin port selection algorithm, and this feature
is useful in certain situations in which you are using rules. For
more information, see the step on setting the port affinity override
feature in the Optimize connections with client-to-server affinity topic.
- weight
A number from 0–100 (but not to exceed the specified
port's weightbound value) representing the weight for this server.
Setting the weight to zero will prevent any new requests from being
sent to the server, but will not end any currently active connections
to that server. The default is one-half the specified port's
maximum weightbound value. If the manager is running, this setting
will be quickly overwritten.
- remove
- Remove this server.
- report
- Report on this server. The report contains the following information
per server: current number of connections per second (CPS), kilobytes
transferred in a one second interval (KBPS), total number of connections
(Total), number of connections that are in the active state (Active),
number of connections that are in the FIN state (FINed), and number
of completed connections (Comp).
- set
- Set values for this server.
- status
- Show status of the servers.
Samples
- To add the server at 27.65.89.42 to port 80 on a cluster address
130.40.52.153:
dscontrol server add 130.40.52.153@80@27.65.89.42
- To remove the server at 27.65.89.42 on all ports on all clusters:
dscontrol server remove @@27.65.89.42
- To set the weight to 10 for server 27.65.89.42 at port 80 on cluster
address 130.40.52.153:
dscontrol server set 130.40.52.153@80@27.65.89.42 weight 10
- To allow the HTTP advisor to query an HTTP URL request HEAD /
HTTP/1.0 for server 27.65.89.42 on HTTP port 80:
dscontrol server set 130.40.52.153@80@27.65.89.42 advisorrequest "\"HEAD / HTTP/1.0\""
- To show the status for server 9.67.143.154 on port 80:
dscontrol server status 9.67.131.167@80@9.67.143.154
- To set the server 27.65.89.42 as nonsticky, which enables the
port affinity override feature:
dscontrol server set 130.40.52.153@80@27.65.89.42 sticky no