Use this command to control various features of the advisor function.
>>-dscontrol--advisor--+-connecttimeout--name--+-port---------+--seconds--------+->< | '-cluster@port-' | +-interval--name--+-port---------+--seconds--------------+ | '-cluster@port-' | +-list---------------------------------------------------+ +-loglevel--name--+-port---------+--level----------------+ | '-cluster@port-' | +-logsize--name--+-port---------+--+-unlimited---------+-+ | '-cluster@port-' '-number of records-' | +-receivetimeout--name--+-port---------+--seconds--------+ | '-cluster@port-' | +-report--name--+-port---------+-------------------------+ | '-cluster@port-' | +-retries--name--+-port---------+--number of retries-----+ | '-cluster@port-' | +-start--name--+-port---------+--------------------------+ | '-cluster@port-' | +-status--name--+-port---------+--+----------+-----------+ | '-cluster@port-' '-log file-' | +-stop--name--+-port---------+---------------------------+ | '-cluster@port-' | +-timeout--name--+-port---------+--+-unlimited-+---------+ | '-cluster@port-' '-seconds---' | '-version--name--+-port---------+------------------------' '-cluster@port-'
The name of the advisor. Possible values include connect, db2, dns, ftp, http, https, cachingproxy, imap, ldap, ldapuri, nntp, ping, pop3, self, sip, smtp, ssl, ssl2http, telnet, and wlm.
See the topic List of advisors for more information on the advisors that Load Balancer provides.
Names of customized advisors are of the format ADV_xxxx, where xxxx is the name of the class that implements the custom advisor. See Creating a custom advisor for more information.
The number of the port that the advisor is monitoring.
The cluster value is optional on the advisor commands, but the port value is required. If the cluster value is not specified, then the advisor will start running on the port for all clusters. If you specify a cluster, then the advisor will start running on the port, but only for the cluster you have specified. See the topic Enabling advisors to manage load balancing for more information on starting and stopping advisors.
The cluster is the address in IP address format or symbolic name. The port is the number of the port that the advisor is monitoring.
A positive integer representing the timeout in seconds at which the advisor waits before reporting that a connect to a server fails. The default is 3 times the value specified for the advisor interval.
A positive integer representing the number of seconds between requests to the servers about their current status. The default is 7.
The number of the level (0 to 5). The default is 1. The higher the number, the more information that is written to the advisor log. The following are the possible values: 0 is None, 1 is Minimal, 2 is Basic, 3 is Moderate, 4 is Advanced, 5 is Verbose.
The maximum size in bytes for the advisor log file. You can specify either a positive number greater than zero, or the word unlimited. The log file may not reach the exact maximum size before overwriting because the log entries themselves vary in size. The default value is 1 MB.
A positive integer representing the timeout in seconds at which the advisor waits before reporting that a receive from a server fails. The default is 3 times the value specified for the advisor interval.
An integer greater than or equal to zero. This value should be no larger than 3. If retries keyword is not configured, the number of retries defaults to zero.
Advisor Name | Protocol | Port |
---|---|---|
connect | ICMP | 12345 |
db2 | private | 50000 |
dns | DNS | 53 |
ftp | FTP | 21 Note: The FTP advisor should advise only on
the FTP control port (21). Do not start an FTP advisor on the FTP
data port (20).
|
http | HTTP | 80 |
https | SSL | 443 |
imap | IMAP | 143 |
ldap | LDAP | 389 |
ldapuri | LDAP | 389 |
nntp | NNTP | 119 |
ping | PING | 0 |
pop3 | POP3 | 110 |
self | private | 12345 |
sip | SIP | 5060 |
smtp | SMTP | 25 |
ssl | SSL | 443 |
ssl2http | SSL | 443 |
telnet | Telnet | 23 |
WLM | private | 10007 |
File name to which the management data is logged. Each record in the log is time–stamped.
The default file is advisorname_port.log, for example, http_80.log. To change the directory where the log files are kept, see Logging with Load Balancer. The default log files for cluster (or site) specific advisors are created with the cluster address, for example, http_127.40.50.1_80.log.
A positive number representing the number of seconds, or the word unlimited. The default value is unlimited.
dscontrol advisor start http 127.40.50.1@80
dscontrol advisor start http 88
dscontrol advisor stop http 127.40.50.1@80
dscontrol advisor connecttimeout http 80 30
dscontrol advisor connecttimeout http 127.40.50.1@80 20
dscontrol advisor interval ftp 21 6
dscontrol advisor list
dscontrol advisor loglevel http 80 0
dscontrol advisor logsize ftp 21 5000
dscontrol advisor receivetimeout http 80 60
dscontrol advisor report ftp 21
dscontrol advisor status http 80
dscontrol advisor timeout ftp 21 5
dscontrol advisor version ssl 443
This
command produces output similar to the following: Version: 04.00.00.00 - 07/12/2001-10:09:56-EDT