-
Cisco VDS Service Broker 1.1 Command Reference
-
Preface
-
Command-Line Interface Command Summary
-
Cisco VDS Service Broker Release 1.1 Software Commands, aaa through line
-
Cisco VDS Service Broker Release 1.1 Software Commands, lls through show statistics fd
-
Cisco VDS Service Broker Release 1.1 Software Commands, show statistics icmp through write
-
Acronyms
-
Standard Time Zones
-
Feedback
Table Of Contents
lls
To view a long list of directory names, use the lls user command in user EXEC configuration mode.
lls [directory]
Syntax Description
Defaults
None
Command Modes
User EXEC configuration mode.
Usage Guidelines
This command provides detailed information about files and subdirectories stored in the present working directory (including size, date, time of creation, sysfs name, and long name of the file). This information can also be viewed with the dir command.
Examples
The following example shows how to view a long list of directory names:
ServiceBroker# llssize time of last change name-------------- ------------------------- -----------4096 Mon Jan 10 14:02:26 2005 <DIR> WebsenseEnterprise4096 Mon Jan 10 14:02:26 2005 <DIR> Websense_config_backup10203 Mon Feb 28 04:24:53 2005 WsInstallLog4096 Wed Feb 9 00:59:48 2005 <DIR> core_dir4096 Mon Jan 10 13:49:27 2005 <DIR> crash382 Tue Mar 1 03:32:13 2005 crka.log1604 Tue Feb 22 03:55:04 2005 dbupgrade.log4096 Mon Jan 10 14:02:31 2005 <DIR> downgrade4096 Mon Feb 28 04:17:32 2005 <DIR> errorlog53248 Tue Mar 1 03:01:53 2005 <DIR> logs16384 Mon Jan 10 13:49:26 2005 <DIR> lost+found438 Tue Jan 11 05:37:57 2005 new_file.xml8192 Tue Mar 1 00:00:00 2005 <DIR> preload_dir4096 Tue Mar 1 03:26:00 2005 <DIR> sa40960 Tue Mar 1 03:32:15 2005 <DIR> service_logs4096 Tue Feb 22 03:51:25 2005 <DIR> smartfilter384802 Mon Feb 28 03:46:00 2005 syslog.txt16296 Mon Feb 21 04:42:12 2005 test4096 Mon Jan 10 14:02:24 2005 <DIR> var4096 Sat Feb 12 07:15:23 2005 <DIR> wmt_vodRelated Commands
logging
To configure system logging, use the logging command in Global configuration mode. To disable logging functions, use the no form of this command.
logging {console {enable | priority loglevel} | disk {enable | filename filename | priority loglevel | recycle size} | facility facility | host {hostname | ip_address} [port port_num | priority loglevel | rate-limit message_rate]}
no logging {console {enable | priority loglevel} | disk {enable | filename filename | priority loglevel | recycle size} | facility facility | host {hostname | ip_address} [port port_num | priority loglevel | rate-limit message_rate]}
Syntax Description
Defaults
Logging: on
Priority of message for console: warning
Priority of message for log file: debug
Priority of message for a host: warning
Log file: /local1/syslog.txt
Log file recycle size: 10,000,000
Command Modes
Global configuration (config) mode.
Usage Guidelines
Use the logging command to set specific parameters of the system log file. System logging is always enabled internally on the SB. The system log file is located on the sysfs partition as /local1/syslog.txt. This file contains the output from many of the VDS-SB components running on the SB, such as authentication entries, privilege levels, administrative details, and diagnostic output during the boot process.
To view information about events that have occurred in all devices in your VDS-SB network, you can use the system message log feature. When a problem occurs in the VDS-SB network, use the system message logs to diagnose and correct such problems.
The syslog.txt file on the VDSM contains information about events that have occurred on the VDSM and not on the registered nodes. The messages written to the syslog.txt file depend on specific parameters of the system log file that you have set using the logging Global configuration command. For example, a critical error message logged on a registered node does not appear in the syslog.txt file on the VDSM because the problem never occurred on the VDSM but occurred only on the registered node. However, such an error message is displayed in the syslog.txt file on the registered node.
A disk failure syslog message is generated every time that a failed sector is accessed. Support for filtering multiple syslog messages for a single failed sector on an IDE disk was added. Support for filtering multiple syslog messages for a single failed section for SCSI disks and SATA disks exists.
To configure the SB to send varying levels of event messages to an external syslog host, use the logging host command. Logging can be configured to send various levels of messages to the console using the logging console priority command.
The no logging disk recycle size command sets the file size to the default value. Whenever the current log file size surpasses the recycle size, the log file is rotated. The log file cycles through at most five rotations, and they are saved as [log file name]. [1-5] under the same directory as the original log. The rotated log file is the one configured using the logging disk filename command.
Configuring System Logging to Remote Syslog Hosts
Users can log to only a single remote syslog host Use one of the following two commands to configure a single remote syslog host for an SB:
ServiceBroker(config)#logging host hostnameServiceBroker(config)#logging priority priorityYou can configure an SB to send varying levels of messages to up to four remote syslog hosts. To accommodate this, logging host priority priority Global configuration command (shown above) is deprecated, and the logging host hostname Global configuration command is extended as follows:
ServiceBroker(config)# [no]logging host hostname [priority priority-code | port port | rate-limit limit]where the following is true:
•
hostname is the hostname or IP address of the remote syslog host. Specify up to four remote syslog hosts. To specify more than one syslog host, use multiple command lines; specify one host per command.
•
Note
•
•
Mapping syslog Priority Levels to RealProxy Error Codes
The RealProxy system generates error messages and writes them to the RealProxy log file. These error messages are captured by the caching application and passed to the system log file. A one-to-one mapping exists between the RealProxy error codes and the syslog priority levels.
Examples
The following example shows that the SB is configured to send messages that have a priority code of "error" (level 3) to the console:
ServiceBroker(config)# logging console priority warningsThe following example shows that the SB is configured to disable sending of messages that have a priority code of "error" (level 3) to the console:
ServiceBroker(config)# no logging console warningsThe following example shows that the SB is configured to send messages that have a priority code of "error" (level 3) to the remote syslog host that has an IP address of 172.31.2.160:
ServiceBroker(config)#logging host 172.31.2.160 priority errorRelated Commands
ls
To view a list of files or subdirectory names within a directory, use the ls command in EXEC configuration mode.
ls [directory]
Syntax Description
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
To list the filenames and subdirectories within a particular directory, use the ls directory command; to list the filenames and subdirectories of the current working directory, use the ls command. To view the present working directory, use the pwd command.
Examples
The following example shows how to display a list of files within the current working directory:
ServiceBroker# ls/local1The following example shows how to display a list of files within the /local1 directory:
ServiceBroker# ls /local1core_dircrasherrorloglogslost+foundservice_logssmartfiltersyslog.txtRelated Commands
mkdir
To create a directory, use the mkdir command in EXEC configuration mode.
mkdir directory
Syntax Description
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
Use this command to create a new directory or subdirectory in the SB file system.
Examples
The following example shows how to create a new directory under local1:
ServiceBroker# mkdir /local1/mydirRelated Commands
mkfile
To create a new file, use the mkfile command in EXEC configuration mode.
mkfile filename
Syntax Description
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
Use this command to create a new file in any directory of the SB.
Examples
The following example shows how to create a new file:
ServiceBroker# mkfile traceinfoRelated Commands
model
To change the CDE250 platform model number after a remanufacturing or rescue process, use the model command in EXEC configuration mode.
model {cde250-2S10 | cde250-2S6 | cde250-2S8 | cde250-2S9}
Syntax Description
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
Use the model command to change the CDE250 model type. Table 0-1 shows the internal and external drives for the CDE250 models.
Examples
The following example shows how to change the CDE250 to model 2S9:
ServiceBroker# model CDE250-2S6This platform is already a CDE250-2S6.ServiceBroker#mount-option
To configure the mount option profile for remote storage, use the mount-option command in Global configuration mode. To delete the configuration, use the no form of this command.
mount-option config-url url [username username password password]
no mount-option config-url url [username username password password]
Syntax Description
Command Default
None
Command Modes
Global configuration (config) mode.
Examples
The following example shows how configure the mount option:
ServiceBroker(config)# mount-option config-url ftp://domain/path/config.xmlRelated Commands
mpstat
To display processor-related statistics, use the mpstat command in EXEC configuration mode.
mpstat line
Syntax Description
Command Default
None
Command Modes
EXEC configuration mode.
Examples
The following example shows how to display the mpstat list of options:
ServiceBroker# mpstat -hLinux 2.6.32.52-cds-64 (W14-UCS220-3) 10/17/12 _x86_64_ (8 CPU)01:50:50 CPU %usr %nice %sys %iowait %irq %soft %steal %guest %idle01:50:50 all 0.01 0.11 0.12 0.02 0.00 0.00 0.00 0.00 99.74ServiceBroker#netmon
To display the transmit and receive activity on an interface, use the netmon command in EXEC configuration mode.
netmon line
Syntax Description
Command Default
None
Command Modes
EXEC configuration mode.
Usage Guidelines
The netmon utility displays the transmit and receive activity on each interface in megabits per second (Mbps), bytes per second (Bps), and packets per second (pps).
Examples
The following example shows how to display the netmon list of options:
ServiceBroker# netmon -hUsage: netmon [<loop-time-in-seconds>] [<iterations>](runs forever if iterations not specified)Related Commands
netstatr
To display the rate of change of netstat statistics, use the netstatr command in EXEC configuration mode.
netstatr line
Syntax Description
Command Default
None
Command Modes
EXEC configuration mode.
Usage Guidelines
The netstatr utility displays the rate of change, per second, of netstat statistics for a given period of time. The average rate per second is displayed, regardless of the sample period. To view the list of options, enter netstatr -h.
Examples
The following example shows how to display the netstart list of options:
ServiceBroker# netstatr -hUsage: netstatr [-v] [<loop-time-in-seconds>] [<iterations>]-v verbose mode(default is 3 sec loop time, run forever)Related Commands
no (Global configuration)
To undo a command in Global configuration mode or set its defaults, use the no form of a command in Global configuration mode.
no command
Note
Syntax Description
Defaults
None
Command Modes
Global configuration (config) mode.
Usage Guidelines
Valid values for command are as follows:
aaa
Configures accounting, authentication and authorization methods.
alarm
Configures the alarms
asset
Configures the asset tag name string.
banner
Defines a login banner.
clock
Configures the time-of-day clock.
cms
Configures the CMS1 .
device
Configures the device mode.
direct-server-return
Configure direct-server-return.
disk
Configures disk-related settings.
enable
Modify enable password parameters.
exec-timeout
Configures the EXEC timeout.
expert-mode
Configures debugshell.
external-ip
Configures up to eight external (NAT) IP addresses.
ftp
Configures FTP caching-related parameters.
geo-location-server
Configure geo location server ip address and port.
geo-location-service
Configure geo location service parameters.
hostname
Configures the system's network name.
interface
Configures a Gigabit Ethernet interface.
ip
Configures IP parameters.
ipv6
IPv6 Configuration commands.
kernel
Enables access to the kernel debugger.
line
Specifies terminal line settings.
logging
Configures the syslog2 .
ntp
Configures the NTP3 .
port-channel
Configures port channel global options.
primary-interface
Configures a primary interface.
radius-server
Configures RADIUS server authentication.
service-broker
Configures Service Broker-related parameters.
service-monitor
Configure Service Monitor related parameters.
snmp-server
Configures the SNMP server.
ssh-key-generate
Generates the SSH4 host key.
sshd
Configures the SSH service.
tacacs
Configures Tacacs+ authentication.
tcp
Configures global TCP parameters.
telnet
Configures Telnet services.
transaction-logs
Configures the transaction logging.
url-signature
Configures an encryption key to use when signing a URL.
username
Establishes username authentication.
VDSM
Configures the VDSM settings.
1 CMS = Centralized Management System
2 syslog = system logging
3 NTP = Network Time Protocol
4 SSH = Secure Shell
Use the no command to disable functions or negate a command. If you need to negate a specific command, such as the default gateway IP address, you must include the specific string in your command, such as no ip default-gateway ip-address.
no (Interface configuration)
To negate an interface configuration mode, use the no command in interface configuration mode.
no {autosense | bandwidth {10-10 | 100-100 | 1000-1000 | 10000-10000} | description | full-duplex | half-duplex | ip {access-group {num {in | out} | name {in | out} | address ip-addr} | ipv6 {access-group {num {in | out} | name {in | out} | address ip-addr} | lacp | mtu | shutdown | standby group-num [priority interface]}
Syntax Description
Defaults
Priority: 100.
Command Modes
Interface configuration (config-if) mode.
Related Commands
ntp
To configure the Network Time Protocol (NTP) server and to allow the system clock to be synchronized by a time server, use the ntp command in Global configuration mode. To disable this function, use the no form of this command.
ntp server {ip_address | hostname} [ip_addresses | hostnames]
no ntp server {ip_address | hostname} [ip_addresses | hostnames]
Syntax Description
Defaults
None
Command Modes
Global configuration (config) mode.
Usage Guidelines
Use this command to synchronize the SB or VDSM clock with the specified NTP server. The ntp server command enables NTP servers for timekeeping purposes and is the only way to synchronize the system clock with a time server.
When you synchronize the VDSM clock with an NTP server, there is a possibility of all devices registered with the VDSM being shown as offline and then reverted to online status. This situation can occur when synchronization with the NTP server sets the VDSM clock forward in time by an interval greater than at least two polling intervals or when the software clock on the VDSM is changed by a similar value using the clock command in EXEC configuration mode. The VDSM determines the status of devices in the VDS-SB network depending on when it was last contacted by the devices for a getUpdate request. If you set the VDSM clock ahead in time, you have added that amount of time to the period since the VDSM received the last getUpdate request. However, it is only a transient effect. Once the devices contact the VDSM for their next getUpdate request after the clock setting change, the VDSM GUI reports the status of all devices correctly.
Examples
The following example shows how to configure the IP address of the time server providing the clock synchronization:
ServiceBroker(config)# ntp 172.16.22.44The following example shows how to reset the time server providing the clock synchronization:
ServiceBroker(config)# no ntp 172.16.22.44Related Commands
clock
Sets or clears clock functions or updates the calendar.
show clock
Displays the system clock.
show ntp
Displays the Network Time Protocol parameters.
ntpdate
To set the software clock (time and date) using a Network Time Protocol (NTP) server, use the ntpdate command in EXEC configuration mode.
ntpdate {hostname | ip_address}
Syntax Description
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
Use NTP to find the current time of day and set the SB current time to match. The ntpdate command synchronizes the software clock with the hardware clock.
Examples
The following example shows how to set the software clock of the SB using an NTP server:
ServiceBroker# ntpdate 10.11.23.40Related Commands
ping
To send echo packets for diagnosing basic network connectivity on networks, use the ping command in EXEC configuration mode.
ping {hostname | ip_address}
Syntax Description
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
To use this command with the hostname argument, be sure that DNS functionality is configured on your SB. To force the timeout of a nonresponsive host or to eliminate a loop cycle, press Ctrl-C.
Following are sample results of the ping command:
•
•
•
•
Examples
The following example shows how to test the basic network connectivity with a host:
ServiceBroker# ping 172.19.131.189PING 172.19.131.189 (172.19.131.189) from 10.1.1.21 : 56(84) bytes ofdata.64 bytes from 172.19.131.189: icmp_seq=0 ttl=249 time=613 usec64 bytes from 172.19.131.189: icmp_seq=1 ttl=249 time=485 usec64 bytes from 172.19.131.189: icmp_seq=2 ttl=249 time=494 usec64 bytes from 172.19.131.189: icmp_seq=3 ttl=249 time=510 usec64 bytes from 172.19.131.189: icmp_seq=4 ttl=249 time=493 usec--- 172.19.131.189 ping statistics ---5 packets transmitted, 5 packets received, 0% packet lossround-trip min/avg/max/mdev = 0.485/0.519/0.613/0.047 msServiceBroker#port-channel
To configure the port channel load balancing, use the port-channel command in Global configuration mode. To disable load balancing, use the no form of this command.
port-channel load-balance {dst-ip | dst-mac | dst-mixed-ip-port | dst-port | round-robin | src-dst-mac | src-dst-mixed-ip-port | src-dst-port | src-mixed-ip-port | src-port}
no port-channel load-balance
Syntax Description
Defaults
Round-robin is the default load balancing method.
Command Modes
Global configuration (config) mode.
Usage Guidelines
The port-channel load-balance command configures one of three load balancing algorithms and provides flexibility in choosing interfaces when an Ethernet frame is sent. The round-robin keyword allows evenly balanced usage of identical network interfaces in a channel group. Because this command takes effect globally, if two channel groups are configured, they must use the same load balancing.
The other balancing options give you the flexibility to choose specific interfaces (by IP address, MAC address, port) when sending an Ethernet frame. The source and destination options, while calculating the outgoing interface, take into account both the source and destination (MAC address or port).
Because the VDS-SB software normally starts IP packets or Ethernet frames, it does not support hashing based on the source IP address and source MAC address. The round-robin keyword is the default load balancing algorithm to evenly distribute traffic among several identical network interfaces.
To remove a port channel, use the no port-channel interface PortChannel command.
Note
Note
Examples
The following example shows how to configure the round-robin load balancing method on an SB:
ServiceBroker(config)# port-channel load-balance round-robinRelated Commands
primary-interface
To configure the primary interface for the VDS-SB network, use the primary-interface command in Global configuration mode. Use the no form of the command to remove the configured primary interface.
primary-interface {GigabitEthernet 1-2/port | PortChannel 1-2 | Standby group_num}
no primary-interface {GigabitEthernet 1-2/port | PortChannel 1-2 | Standby group_num}
Syntax Description
Defaults
The default primary interface is the first operational interface on which a link beat is detected. Interfaces with lower-number IDs are polled first (for example, GigabitEthernet 0/0 is checked before 1/0). Primary interface configuration is required for the proper functioning of the Centralized Management System (CMS). After devices are registered to the VDSM, the VDSM uses the configured primary interface to communicated with the registered devices.
You cannot enable the VDS-SB network without specifying the primary interface. Also, you must have chosen the primary interface before you enable the CMS. The primary interface can be changed without disabling the VDS-SB network. The primary interface specifies the default route for an interface. To change the primary interface, choose a different interface as the primary interface.
Note
You can select a standby interface as the primary interface (you can enter the primary-interface Standby group_num command) to specify a standby group as the primary interface on an SB.
Command Modes
Global configuration (config) mode.
Usage Guidelines
The primary-interface command in Global configuration mode allows the administrator to specify the primary interface for the VDS-SB network.
The primary interface can be changed without disabling the VDS-SB network. To change the primary interface, re-enter the command string and specify a different interface.
Note
Examples
The following example shows how to specify the Gigabit Ethernet slot 1 port 0 as the primary interface on an SB:
ServiceBroker(config)# primary-interface GigabitEthernet 1/0The following example shows how to specify the Gigabit Ethernet slot 2 port 0 as the primary interface on an SB:
ServiceBroker(config)# primary-interface GigabitEthernet 2/0pwd
To view the present working directory, use the pwd command in EXEC configuration mode.
pwd
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
Use this command to display the present working directory of the SB.
Examples
The following example shows how to view the present working directory:
ServiceBroker# pwd/local1Related Commands
radius-server
To configure RADIUS authentication parameters, use the radius-server command in Global configuration mode. To disable RADIUS authentication parameters, use the no form of this command.
radius-server {enable | host {hostname | host_ipaddr} [auth-port port] | key keyword | redirect {enable | message reply location url} | retransmit retries | timeout seconds}
no radius-server {enable | host {hostname | host_ipaddr} | key | redirect {enable | message reply location url} | retransmit | timeout}
Syntax Description
Defaults
auth-port port: UDP port 1645
retransmit retries: 2
timeout seconds: 5
Command Modes
Global configuration (config) mode.
Usage Guidelines
RADIUS is a client/server authentication and authorization access protocol used by an VDS-SB network device to authenticate users attempting to connect to a network device. The VDS-SB network device functions as a client, passing user information to one or more RADIUS servers. The VDS-SB network device permits or denies network access to a user based on the response that it receives from one or more RADIUS servers. RADIUS uses the User Datagram Protocol (UDP) for transport between the RADIUS client and server.
You can configure a RADIUS key on the client and server. If you configure a key on the client, it must be the same as the one configured on the RADIUS servers. The RADIUS clients and servers use the key to encrypt all RADIUS packets sent. If you do not configure a RADIUS key, packets are not encrypted. The key itself is never sent over the network.
Note
RADIUS authentication usually occurs in these instances:
•
•
RADIUS authentication is disabled by default. You can enable RADIUS authentication and other authentication methods at the same time. You can also specify which method to use first.
To configure RADIUS parameters, use the radius-server command in Global configuration mode. To disable RADIUS authentication parameters, use the no form of this command.
The redirect keyword of the radius-server command redirects an authentication response to a different Authentication Server if an authentication request using the RADIUS server fails.
Note
To exclude domains from RADIUS authentication, use the rule no-auth domain command. RADIUS authentication takes place only if the site requested does not match the specified pattern.
Enabling and Disabling Administrative Login Authentication Through RADIUS
When configuring an SB to use RADIUS to authenticate and authorize administrative login requests, follow these guidelines:
•
•
•
•
Tip
To use the SB CLI to enable RADIUS authentication on an SB, enable RADIUS authentication for normal login mode by entering the authentication login radius command in Global configuration mode as follows:
ServiceBroker(config)#authentication login radius enable [primary] [secondary]Use the authentication configuration radius command in Global configuration mode to enable RADIUS authorization as follows:
ServiceBroker(config)#authentication configuration radius enable [primary][secondary]
Note
Configuring RADIUS Authentication of HTTP Requests
To configure RADIUS authentication for HTTP requests on an SB, configure the RADIUS server settings on the SB and enable RADIUS authentication for HTTP requests on the SB using the radius-server command in Global configuration mode.
Examples
The following example shows how to enable the RADIUS client, specify a RADIUS server, specify the RADIUS key, accept retransmit defaults, and excludes the domain name, mydomain.net, from RADIUS authentication. You can verify the configuration with the show radius-server and show rule all commands.
ServiceBroker(config)# radius-server enableServiceBroker(config)# radius-server host 172.16.90.121ServiceBroker(config)# radius-server key myradiuskeyServiceBroker(config)# rule action no-auth pattern-list 2ServiceBroker(config)# rule pattern-list 2 domain mydomain.netServiceBroker# show radius-serverLogin Authentication for Console/Telnet/Ftp/SSH Session: enabledConfiguration Authentication for Console/Telnet/Ftp/SSH Session: enabled (secondary)Radius Configuration:---------------------Radius Authentication is onTimeout = 5Retransmit = 2Key = ****Radius Redirect is offThere is no URL to authentication failure instructionsServers-------IP 172.16.90.121 Port = 1645ServiceBroker# show rule allRules Template Configuration----------------------------Rule Processing Enabledrule no-auth domain mydomain.netThe following example disables RADIUS authentication on the SB:
ServiceBroker(config)# no radius-server enableThe following example shows how to force the SB to try RADIUS authentication first:
ServiceBroker(config)#authentication login radius enable primaryRelated Commands
reload
To halt and perform a cold restart on the SB, use the reload command in EXEC configuration mode.
reload [force]
Syntax Description
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
To reboot the SB, use the reload command. If the current running configuration is different from the startup configuration and if the configuration changes are not saved to flash memory, you are prompted to save the current running configuration parameters to the startup configuration.
To save any file system contents to disk from memory before a restart, use the cache synchronize command.
Examples
The following example shows how to reload the SB after you have saved the configuration changes.
ServiceBroker# reloadSystem configuration has been modified. Save? [ yes ] :yesProceed with reload? [ confirm ] yesShutting down all services, will timeout in 15 minutes.reload in progress .....The following example forces a reboot on the SB:
ServiceBroker# reload forceRelated Commands
cache synchronize
Saves any file system contents to disk from memory before a restart.
write
Saves startup configurations.
write erase
Erases the startup configuration from NVRAM.
rename
To rename a file on the SB, use the rename command in EXEC configuration mode.
rename old_filename new_filename
Syntax Description
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
Use this command to rename any sysfs file without making a copy of the file.
Examples
The following example renames a file named errlog.txt as old_errlog.txt:
ServiceBroker# rename errlog.txt old_errlog.txtRelated Commands
restore
To restore the device to its manufactured default status, removing the user data from the disk and flash memory, use the restore command in EXEC configuration mode. This command erases all existing content on the device.
restore factory-default [preserve basic-config]
Syntax Description
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
Use this command to restore data on disk and in flash memory to the factory default, while preserving particular time stamp evaluation data. You need to enter this command from the root directory, or else the following error message is displayed:
ServiceBroker# restore factory-defaultNeed to cd to / before issuing this commandCommand aborted.ServiceBroker#Be sure to back up the VDSM database and copy the backup file to a safe location that is separate from that of the VDSM, or change over from the primary to a standby VDSM before you use the restore factory-default command on your primary VDSM. The primary VDSM operation must be halted before proceeding with backup and restore commands.
Caution
By removing the VDSM database, all configuration records for the entire VDS-SB network are deleted. If you do not have a valid backup file or a standby VDSM, you must use the cms deregister force command and reregister every SB after you have reconfigured the VDSM, because all previously configured data is lost.
If you used your standby VDSM to store the database while you reconfigured the primary, you can simply register the former primary as a new standby VDSM.
If you created a backup file while you configured the primary VDSM, you can copy the backup file to this newly reconfigured VDSM and use the cms database restore command.
Caution
Cisco VDS Service Broker software consists of three basic components:
•
•
•
All these components must be correctly installed for Cisco VDS Service Broker software to work properly.
Examples
The following two examples show the results of using the restore factory-default and restore factory-default preserve basic-config commands. Because configuration parameters and data are lost, prompts are given before initiating the restore operation to ensure that you want to proceed.
Note
VDSM# restore factory-defaultThis command will wipe out all of data on the disksand wipe out VDS-SB CLI configurations you have ever made.If the box is in evaluation period of certain product,the evaluation process will not be affected though.It is highly recommended that you stop all active servicesbefore this command is run.Are you sure you want to go ahead?[ yes/no ]VDSM# restore factory-default preserve basic-configThis command will wipe out all of data on the disksand all of VDS-SB CLI configurations except basic networkconfigurations for keeping the device online.The to-be-preserved configurations are network interfaces,default gateway, domain name, name server and hostname.If the box is in evaluation period of certain product,the evaluation process will not be affected.It is highly recommended that you stop all active servicesbefore this command is run.Are you sure you want to go ahead?[ yes/no ]
Note
The following example shows that entering the show disks command after the restore command verifies that the restore command has removed data from the partitioned file systems (sysfs and cdnfs):
ServiceBroker# show disksSYSFS 0.0GB 0.0%CDNFS 0.0GB 0.0%FREE 29.9GB 100.0%Because flash memory configurations were removed after the restore command was used, the show startup-config command does not return any flash memory data. The show running-config command returns the default running configurations.
The show wmt command continues to display the same license evaluation periods as before the restore factory-default command was invoked, because the evaluation period is not affected by this restore command. For example, if there were 21 days remaining in the evaluation period before the restore factory-default command was used, there would continue to be 21 days remaining in the evaluation period.
Related Commands
rmdir
To delete a directory, use the rmdir command in EXEC configuration mode.
rmdir directory
Syntax Description
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
Use this command to remove any directory from the SB file system. The rmdir command removes only empty directories.
Examples
The following example shows how to remove the oldfiles directory under /local1:
ServiceBroker# rmdir /local1/oldfilesRelated Commands
script
To execute a script provided by Cisco or check the script for errors, use the script command in EXEC configuration mode.
script {check | execute} file_name
Syntax Description
check
Checks the validity of the script.
execute
Executes the script. The script file must be a sysfs file in the current directory.
file_name
Name of the script file.
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
The script command in EXEC configuration mode opens the script utility, which allows you to execute scripts supplied by Cisco or check errors in those scripts. The script utility can read standard terminal input from the user if the script you run requires inputs from the user.
Note
Examples
The following example shows how to check for errors in the script file foo.script:
ServiceBroker# script check foo.scriptScript file foo.script is valid.service
To specify the type of service, use the service command in EXEC configuration mode.
On the VDSM:
service cms restart
On the SB:
service {service-broker | cms | service-monitor}
Syntax Description
cms
Specifies CMS services.
service-broker
Specifies Service Broker services.
service-monitor
Specifies Service Monitor services.
Defaults
None
Command Modes
EXEC configuration mode.
Examples
The following example shows how to restart service-broker service:
ServiceBroker# service service-broker restartThe service service broker has been restarted successfully!ServiceBroker#setup
To configure basic configuration settings (general settings, device network settings, and disk configuration) on the SB and a set of commonly used caching services, use the setup command in EXEC configuration mode. You can also use the setup command in EXEC configuration mode to complete basic configuration after upgrading.
setup
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
EXEC configuration mode.
Examples
The following example shows the part of the output when you enter the setup command in EXEC configuration mode on an SB running the VDS-SB software:
ServiceBroker# setupHere is the current profile of this deviceCDN device : YesDo you want to change this (y/n) [ n ] :Press the ESC key at any time to quit this sessionshow aaa
To display the accounting, authentication, and authorization configuration, use the show aaa command in EXEC configuration mode.
show aaa [commands [accounting | authorization] | enable [authentication] | exec [accounting | authorization] | login [authentication] | system [accounting | authorization]]
Syntax Description
Command Default
None
Command Modes
EXEC configuration mode.
Usage Guidelines
Table 3-2 describes the fields shown in the show aaa commands command display.
Table 3-3 describes the fields shown in the show aaa enable command display.
Table 3-4 describes the fields shown in the show aaa exec command display.
Table 3-5 describes the fields shown in the show aaa login command display.
Table 3-6 describes the fields shown in the show aaa system command display.
Table 3-6 show aaa system Field Descriptions
System events Accounting
Tacacs+
Accounting through Tacacs+ for system event is enabled or disabled.
Related Commands
show access-lists
To display the access control list (ACL) configuration, use the show access-lists command in EXEC configuration mode.
show access-lists
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC configuration mode.
Usage Guidelines
Table 3-7 describes the fields shown in the show access-lists 300 display.
Related Commands
show alarms
To display information on various types of alarms, their status, and history, use the show alarms command in EXEC configuration mode.
show alarms [critical [detail [support] | detail [support] | history [start_num [end_num [detail [support] | detail [support]]] | critical [start_num [end_num [detail [support]] | detail [support]]] | detail [support] | major [start_num [end_num [detail [support]] | detail [support]]] | minor [start_num [end_num [detail [support]]] | detail [support]]] | major [detail [support]] | minor [detail [support]]] | status]]
Syntax Description
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
The Node Health Manager enables VDS-SB applications to raise alarms to draw attention to error or significant conditions. The Node Health Manager, which is the data repository for such alarms, aggregates the health and alarm information for the applications, services (for example, the cache service), and resources (for example, disk drives) that are being monitored on the SB. For example, the Node Health Manager gives you a mechanism to determine if a monitored application (for example, the HTTP proxy caching service) is alive on the SB. These alarms are referred to as VDS-SB software alarms.
The VDS-SB software uses SNMP to report error conditions by generating SNMP traps. In the VDS-SB software, the following SB applications can generate an VDS-SB software alarm:
•
•
•
The three levels of alarms in the VDS-SB software are as follows:
•
•
•
You can configure alarms using the snmp-server enable traps alarm command in Global configuration mode.
Use the show alarms critical command in EXEC configuration mode to display the current critical alarms being generated by the VDS-SB software applications. Use the show alarms critical detail command in EXEC configuration mode to display additional details for each of the critical alarms being generated. Use the show alarms critical detail support command in EXEC configuration mode to display an explanation about the condition that triggered the alarm and how you can find out the cause of the problem. Similarly, you can use the show alarms major and show alarms minor command in EXEC configuration modes to display the details of major and minor alarms.
Use the show alarms history command in EXEC configuration mode to display a history of alarms that have been raised and cleared by the VDS-SB software on the SB. The VDS-SB software retains the last 100 alarm raise and clear events only.
Use the show alarm status command in EXEC configuration mode to display the status of current alarms and the SB's alarm overload status and alarm overload configuration.
Note
Brstcnt Threshold Alarm
When the number of sessions or current bandwidth usage exceeds the configured license limit on the Service Broker, the protocol engine raises an alarm and sends a threshold exceeded notification to the Service Broker. Any new requests for that protocol engine are not routed to that Service Broker.Service Broker
Note
Table 3-8 describes the fields shown in the show alarms history display.
Table 3-9 describes the fields shown in the show alarms status display.
Related Commands
alarm
Configure alarms.
snmp-server enable traps
Enables the SB to send SNMP traps.
show arp
To display the Address Resolution Protocol (ARP) table, use the show arp command in EXEC configuration mode.
show arp
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
The show arp command displays the Internet-to-Ethernet address translation tables of the ARP. Without flags, the current ARP entry for the hostname is displayed.
Table 3-10 describes the fields shown in the show arp display.
show authentication
To display the authentication configuration, use the show authentication command in EXEC configuration mode.
show authentication user
Syntax Description
Defaults
None
Command Modes
EXEC configuration mode.
Related Commands
clear
Clears the HTTP object cache, the hardware interface, statistics, archive working transaction logs, and other settings.
show banner
To display information on various types of banners, use the show banner command in EXEC configuration mode.
show banner
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
Table 3-11 describes the fields shown in the show banner display.
Related Commands
show bitrate
To display the bit rate allocated to a particular device, use the show bitrate command in EXEC configuration mode.
show bitrate [movie-streamer | wmt]
Syntax Description
movie-streamer
(Optional) Displays the Movie Streamer bit rate settings.
wmt
(Optional) Displays Windows Media Technology (WMT) bit rate settings.
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
Table 3-12 describes the fields shown in the show bitrate display.
Related Commands
bitrate
Configures the maximum pacing bit rate for large files for the Movie Streamer and separately configures WMT bit-rate settings.
show clock
To display the system clock, use the show clock command in EXEC configuration mode.
show clock [detail | standard-timezones {all | details timezone | regions | zones region_name}]
Syntax Description
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
The VDS-SB has several predefined standard time zones. Some of these time zones have built-in summertime information while others do not. For example, if you are in an eastern region of the United States (US), you must use the US/Eastern time zone that includes summertime information and adjusts the clock automatically every April and October. There are about 1500 standard time zone names.
The clock summertime command is disabled when a standard time zone is configured. You can only configure summertime if the time zone is not a standard time zone (if the time zone is a customized zone).
In addition, CLI commands exist to enable you to display a list of all the standard time zones. The show clock standard-timezones all command in EXEC configuration mode enables you to browse through all standard time zones and choose from these predefined time zones. You can choose a customized name that does not conflict with the predefined names of the standard time zones. Most predefined names of the standard time zones have two components, a region name and a zone name. You can list time zones by several criteria, such as regions and zones.
Table 3-13 describes the field in the show clock display.
Table 3-13 show clock Field Description
Local time
Day of the week, month, date, time (hh:mm:ss), and year in local time relative to the UTC offset.
Table 3-14 describes the fields shown in the show clock detail display.
The following example shows an excerpt of the output from the show clock standard-timezones all command in EXEC configuration mode. As the following example shows all the standard time zones (approximately 1500 time zones) are listed. Each time zone is listed on a separate line.
ServiceBroker #show clock standard-timezones allAfrica/AbidjanAfrica/AccraAfrica/Addis_AbabaAfrica/AlgiersAfrica/AsmeraAfrica/BamakoAfrica/BanguiAfrica/BanjulAfrica/BissauAfrica/BlantyreAfrica/BrazzavilleAfrica/BujumburaAfrica/CasablancaAfrica/CeutaAfrica/ConakryAfrica/DakarAfrica/Dar_es_SalaamAfrica/Djibouti..
ServiceBroker(config)#The following example shows an excerpt of the output from the show clock standard-timezones region command in EXEC configuration mode. As the example shows, all first level time zone names or directories are listed. All 1500 time zones are organized into directories by region.
ServiceBroker #show clock standard-timezones regionsAfrica/America/Antarctica/Arctic/Asia/Atlantic/Australia/Brazil/CET...The following example shows an excerpt of the output from the show clock standard-timezones zones command in EXEC configuration mode. As the following example shows, this command lists the name of every time zone that is within the specified region (for example, the US region).
ServiceBroker#show clock standard-timezones zones USAlaskaAleutianArizonaCentralEast-IndianaEasternHawaiiIndiana-StarkeMichiganMountainPacificSamoaThe following example shows an excerpt of the output from the show clock standard-timezones details command in EXEC configuration mode. This command shows details about the specified time zone (for example, the US/Eastern time zone). The command output also includes the standard offset from the Greenwich Mean Time (GMT).
ServiceBroker #show clock standard-timezones details US/EasternUS/Eastern is standard timezone.Getting offset information (may take a while)...Standard offset from GMT is -300 minutes (-5 hour(s)).It has built-in summertime.Summer offset from GMT is -240 minutes. (-4 hour(s)).Related Commands
clock (EXEC)
Sets or clears clock functions or updates the calendar.
clock (Global configuration
Sets the summer daylight saving time and time zone for display purposes.
show cms
To display the Centralized Management System (CMS)-embedded database content and maintenance status and other information, use the show cms command in EXEC configuration mode.
show cms {database {content {dump filename | text | xml} | maintenance [detail]} | info | processes}
Syntax Description
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
Table 3-15 describes the fields shown in the VDSM show cms info display.
Table 3-16 describes the fields shown in the SB show cms info display.
The following example writes the database content to a file in text format:
VDSM# show cms database content textDatabase content can be found in /local1/cms-db-12-12-2002-17:06:08:070.txt.The following example writes the database content to a file in XML format:
VDSM# show cms database content xmlDatabase content can be found in /local1/cms-db-12-12-2002-17:07:11:629.xml.The following example shows the output of the show cms database maintenance detail on an SB:
ServiceBroker# show cms database maintenance detailDatabase maintenance is not running.Regular database maintenance is enabled.Regular database maintenance schedule is set on Sun, Mon, Tue, Wed, Thu, Fri, Sat at 02:00Full database maintenance is enabled.Full database maintenance schedule is set on Sun, Mon, Tue, Wed, Thu, Fri, Sat at 04:00Disk usage for STATE partition: Total: 1523564K, Available: 1443940K, Use: 6%DATABASE VACUUMING DETAILS AND ERRORS-------------------------------------Database Vacuuming never performed or it did not complete due to error.Latest Vacuuming status :No ErrorLast Vacuum Error : No ErrorLast Reindex Time : Thu Jul 15 02:02:49 2004Latest Reindexing status :No ErrorLast Reindex Error: No ErrorServiceBroker#Related Commands
cms (EXEC)
Configures the CMS-embedded database parameters.
cms (global)
Schedules maintenance and enables the CMS on a given node.
show debugging
To display the state of each debugging option, use the show debugging user command in user EXEC configuration mode.
show debugging
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
User EXEC configuration mode.
Examples
The following is sample output from the show debugging command:
ServiceRouter# show debuggingDebug web-engine is set to traceDebug capturecontroller is set to traceServiceRouter#Related Commands
debug
Monitors and records caching application functions.
undebug
Disables debugging functions.
show device-mode
To display the configured or current mode of a device, use the show device-mode command in EXEC configuration mode.
show device-mode {configured | current}
Syntax Description
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
If the configured and current device modes differ, a reload is required for the configured device mode to take effect.
Examples
The configured device mode field in the show device-mode configured display shows the device mode that has been configured, but has not yet taken effect. The current device mode field in the show device-mode current command display shows the current mode in which the VDS-SB device is operating.
The following example shows how to use the show device-mode command to show the device mode when you change the device to an SB using the device mode command:
Acmehost# show device-mode currentCurrent device mode: service-brokerAcmehost# show device-mode configuredConfigured device mode: service-brokerAcmehost(config)# device mode service-brokerThe new configuration will take effect after a reloadAcmehost(config)# exitAcmehost# show device-mode currentCurrent device mode: service-brokerNote: The configured and current device modes differ,a reload is required for the configured device mode totake effect.Acmehost# show device-mode configuredConfigured device mode: service-brokerNote: The configured and current device modes differ,a reload is required for the configured device mode totake effect.Acmehost# write memoryAcmehost# reload force...reload...Acmehost# show running-configdevice mode service-broker!hostname Acmehost..Acmehost# show device-mode configuredConfigured device mode: service-brokerAcmehost# show device-mode currentCurrent device mode: service-brokerRelated Commands
show disks
To view information about your disks, use the show disks command in EXEC configuration mode.
show disks [current | details | error-handling [details] | raid-state | SMART-info [details]]
Syntax Description
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
The show disks command displays the names of the disks currently attached to the SB.
Table 3-17 describes the fields shown in the show disks details display.
The show disks error-handling command displays the current level of disk and sector-related errors.
Table 3-18 describes the fields shown in the show disks error-handling details display.
Proactively Monitoring Disk Health with SMART
The ability to proactively monitor the health of disks with Self Monitoring, Analysis, and Reporting Technology (SMART) was added. SMART provides you with hard drive diagnostic information and information about impending disk failures.
SMART is supported by most disk vendors and is a standard method used to determine the health of a disk. SMART has several read-only attributes (for example, the power-on hours attribute, the load and unload count attribute) that provide the VDS-SB software with information about the operating and environmental conditions that may indicate an impending disk failure.
To display more detailed information, enter the show disks SMART-info details command in EXEC configuration mode. The output from the show disks SMART-info and the show disks SMART-info details commands differ based on the disk vendor and the type of drive technology (Integrated Drive Electronics [IDE], Small Computer Systems Interface [SCSI], and Serial Advanced Technology Attachment [SATA] disk drives).
Even though SMART attributes are vendor dependent, there is a common way of interpreting most SMART attributes. Each SMART attribute has a normalized current value and a threshold value. When the current value exceeds the threshold value, the disk is considered as failed. The VDS-SB software monitors the SMART attributes and reports any impending failure through syslog messages, SNMP traps, and alarms.
The output from the show tech-support command in EXEC configuration mode also includes SMART information.
Table 3-19 describes some typical fields in the show disks SMART-info display.
Examples
The following example displays output for two disks experiencing sector errors:
ServiceBroker# show disks error-handlingDisk errors since last boot:disk05 total bad sectors = 1, total errors = 2disk10 total bad sectors = 3, total errors = 9If the details option is given, then each bad sector's Logical Block Address (LBA) displays along with its corresponding I/O error count:
ServiceBroker# show disks error-handling detailsDisk errors since last boot:disk05 total bad sectors = 1, total errors = 2# diskname Sector (LBA) I/O errors:disk05 3000005 2disk10 total bad sectors = 3, total errors = 9# diskname Sector (LBA) I/O errors:disk10 16000 3disk10 170001 4disk10 180001 2Total errors (since system boot) across all disks = 11
Note
SMART support is vendor dependent; each disk vendor has a different set of supported SMART attributes. The following example shows the output from the show disks SMART-info command in EXEC configuration mode that was entered on two different SBs (Service Broker A and Service Broker B). These two SBs contain hard disks that were manufactured by different vendors.
ServiceBroker# show disks SMART-info=== disk00 ===smartctl version 5.38 [ i686-spcdn-linux-gnu ] Copyright (C) 2002-8 Bruce AllenHome page is http://smartmontools.sourceforge.net/=== START OF INFORMATION SECTION ===Device Model: ST3500320NSSerial Number: 5QM19RKRFirmware Version: SN04User Capacity: 500,107,862,016 bytesDevice is: Not in smartctl database [ for details use: -P showall ]ATA Version is: 6ATA Standard is: ATA/ATAPI-6 T13 1410D revision 2Local Time is: Thu May 21 14:09:19 2009 UTCSMART support is: Available - device has SMART capability.SMART support is: Enabled=== START OF READ SMART DATA SECTION ===SMART overall-health self-assessment test result: PASSEDRUNNING: /usr/sbin/smartctl /dev/sda -H -i=== disk01 ===smartctl version 5.38 [ i686-spcdn-linux-gnu ] Copyright (C) 2002-8 Bruce AllenHome page is http://smartmontools.sourceforge.net/=== START OF INFORMATION SECTION ===Device Model: ST3500320NSSerial Number: 5QM19B0BFirmware Version: SN04User Capacity: 500,107,862,016 bytesDevice is: Not in smartctl database [ for details use: -P showall ]ATA Version is: 6ATA Standard is: ATA/ATAPI-6 T13 1410D revision 2Local Time is: Thu May 21 14:09:19 2009 UTCSMART support is: Available - device has SMART capability.SMART support is: Enabled=== START OF READ SMART DATA SECTION ===SMART overall-health self-assessment test result: PASSEDRUNNING: /usr/sbin/smartctl /dev/sdb -H -i=== disk02 ===smartctl version 5.38 [ i686-spcdn-linux-gnu ] Copyright (C) 2002-8 Bruce AllenHome page is http://smartmontools.sourceforge.net/=== START OF INFORMATION SECTION ===Device Model: ST3500320NSSerial Number: 5QM19SK9Firmware Version: SN04User Capacity: 500,107,862,016 bytesDevice is: Not in smartctl database [ for details use: -P showall ]ATA Version is: 6ATA Standard is: ATA/ATAPI-6 T13 1410D revision 2Local Time is: Thu May 21 14:09:19 2009 UTCSMART support is: Available - device has SMART capability.SMART support is: Enabled=== START OF READ SMART DATA SECTION ===SMART overall-health self-assessment test result: PASSEDRUNNING: /usr/sbin/smartctl /dev/sdc -H -iThe following example shows the output from the show dis raid-state command, which shows all the disk partitions on a CDE:
ServiceBroker# #show disks raid-stateSYSTEM : RAID-1Status: NormalPartitions: disk00/05 disk02/05SYSTEM: RAID-1Status: NormalPartitions: disk00/01 disk02/01SYSTEM: RAID-1Status: NormalPartitions: disk00/02 disk02/02SYSTEM: RAID-1Status: NormalPartitions: disk00/04 disk02/04Related Commands
disk (EXEC)
Configures disks and allocates disk space for devices using VDS-SB software.
show flash
To display the flash memory version and usage information, use the show flash command in EXEC configuration mode.
show flash
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
If a new software image has been installed and is waiting to be run after a reboot, the show flash command displays this information and the version of VDS-SB software that runs on the device after reload.
Note
Examples
The following example shows how to display the flash information:
ServiceBroker# show flashVDS-SB software version (disk-based code): VDS-SB-2.4.0-b328System image on flash:Version: 2.4.0.328System flash directory:System image: 274 sectorsBootloader, rescue image, and other reserved areas: 59 sectors512 sectors total, 179 sectors free.Table 3-20 describes the fields shown in the show flash display.
Related Commands
show ftp
To display the caching configuration of the File Transfer Protocol (FTP), use the show ftp command in EXEC configuration mode.
show ftp
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
EXEC configuration mode.
Examples
The following example shows how to display the caching configuration of FTP:
ServiceBroker# show ftpFTP heuristic age-multipliers: directory-listing 30% file 60%Maximum Time To Live in days : directory-listing 3 file 7Minimum Time To Live in minutes: 60No objects are revalidated on every request.Serve-IMS without revalidation if...Directory listing object is less than 50% of max ageFile object is less than 80% of max ageIncoming Proxy-Mode:Servicing Proxy mode FTP connections on ports: 22 23 88 66 48 488 449 90Outgoing Proxy-Mode:Not using outgoing proxy mode.Maximum size of a cacheable object is unlimited.Related Commands
show geo-location-server
It displays information about primary and secondary Geo location server [ip address and port configured].
If Geo server monitoring is enabled/disabled. By default it is enabled. Geo monitoring polling interval is configured in seconds. The status of the Geo location server will be checked at each poll-interval. Default is 60 sec. Geo location server timeout - time after which the server will be treated as inactive. Default is 1 sec.
show geo-location-server
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC configuration mode.
Examples
The following example shows how to display information about primary and secondary Geo location server
ServiceBroker# show geo-location-serverPrimary geo location server 1.1.1.3 7000Secondary geo location server 1.1.1.2 7000Geo Location server monitoring is enabledGeo Location server poll rate 30 secondsGeo Location server timeout 5 secondsshow geo-location-service
It displays if location service is enabled/disabled, location cache timeout and max location cache entries.
show geo-location-service
Syntax Description
This command has no arguments or keywords.
Command Default
None
Command Modes
EXEC configuration mode.
Examples
The following example displays if location service is enabled or disabled.
ServiceBroker# show geo-location-serviceLocation based service is enabledLocation cache timeout 600000 secondsLocation cache max entries 10000show hardware
To display the system hardware status, use the show hardware command in EXEC configuration mode.
show hardware [all | core | cpuinfo | dmi [all | baseboard | bios | cache | chassis | connector | memory | processor | slot | system] | mapping {disk [all | diskname] | interface [all | GigabitEthernet slot/port_num | TenGigabitEthernet slot/port_num]} | meminfo | pci [details | drivers | ids | tree]]
Syntax Description
all
(Optional) Displays all hardware class information.
core
(Optional) Displays core hardware information.
cpuinfo
(Optional) Displays CPU information.
dmi
(Optional) Displays DMI1 .
all
(Optional) Displays all DMI information.
baseboard
(Optional) Displays motherboard information.
bios
(Optional) Displays BIOS information.
cache
(Optional) Displays processor cache information.
chassis
(Optional) Displays chassis information.
connector
(Optional) Displays connector information.
memory
(Optional) Displays physical memory information.
processor
(Optional) Displays processor information.
slot
(Optional) Displays PCI slot information.
system
(Optional) Displays system information.
mapping
(Optional) Shows mapping between Cisco and Linux hardware names.
disk
Maps Cisco disk name to Linux device name.
diskname
Name of the disk (disk00).
interface
Maps Cisco interface name to Linux device name.
all
Displays all interface information.
GigabitEthernet
Selects a 1G ethernet interface.
slot/port_num
Slot and port number for the selected interface. The slot range is from 1 to 14; the port range is from 0 to 0. The slot number and port number are separated with a forward slash character (/).
TenGigabitEthernet
Selects a 10G ethernet interface.
meminfo
(Optional) Displays RAM information.
pci
(Optional) Displays PCI information.
details
(Optional) Show output with PCI addresses and names.
drivers
(Optional) Identify driver names and availability.
ids
(Optional) Show PCI vendor and device codes.
tree
(Optional) Show a tree-like diagram containing all buses, bridges and devices.
1 Desktop Management Interface
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
The output of the show hardware command in EXEC configuration mode displays all core or Desktop Management Interface (DMI) information. The DMI output can also be filtered by optional keywords.
Table 3-21 describes the fields shown in the show hardware display.
Examples
The following example shows how to display the core hardware information:
ServiceBroker# show hardware coreVDS Service Broker Software (VDS-SB)Copyright (c) 1999-2011 by Cisco Systems, Inc.VDS Service Broker Software Release 2.6.0 (buildb460 Aug 28 2011)Version: cde220-2g2-DEVELOPMENT[vcn-build1:/auto/vcn-u1/vosis_release_builds/vosis_2.6.0-b460/spcdn]Compiled 05:55:01 Aug 28 2011 by ipvbuildCompile Time Options: KQ SSSystem was restarted on Mon Aug 29 11:56:58 2011.The system has been up for 1 day, 5 hours, 5 minutes, 2 seconds.CPU 0 is GenuineIntel Intel(R) Xeon(R) CPUL5410 @ 2.33GHz (rev 23) running at 2333MHz.CPU 1 is GenuineIntel Intel(R) Xeon(R) CPUL5410 @ 2.33GHz (rev 23) running at 2333MHz.CPU 2 is GenuineIntel Intel(R) Xeon(R) CPUL5410 @ 2.33GHz (rev 23) running at 2333MHz.CPU 3 is GenuineIntel Intel(R) Xeon(R) CPUL5410 @ 2.33GHz (rev 23) running at 2333MHz.CPU 4 is GenuineIntel Intel(R) Xeon(R) CPUL5410 @ 2.33GHz (rev 23) running at 2333MHz.CPU 5 is GenuineIntel Intel(R) Xeon(R) CPUL5410 @ 2.33GHz (rev 23) running at 2333MHz.CPU 6 is GenuineIntel Intel(R) Xeon(R) CPUL5410 @ 2.33GHz (rev 23) running at 2333MHz.CPU 7 is GenuineIntel Intel(R) Xeon(R) CPUL5410 @ 2.33GHz (rev 23) running at 2333MHz.Total 8 CPUs.16000 Mbytes of Physical memory.10 GigabitEthernet interfaces1 Console interface2 USB interfaces [Not supported in this version ofsoftware]Cookie info:Base PID: CDE220-2G2 VID: 00SerialNumber: 99999999999Model Type:SerialNumber (raw): 57 57 57 57 57 57 57 57 5757 57TestDate: 12-19-2002ExtModel: CDE220-2G2ModelNum (raw): 55 0 0 0 1HWVersion: 1PartNumber: 53 54 55 56 57BoardRevision: 1ChipRev: 1VendID: 0CookieVer: 2Chksum: 0xfb9eList of all disk drives:disk00: Normal (h02 c00 i00 l00 - mptsas) 476940MB(465.8GB)disk00/01: SYSTEM 5120MB( 5.0GB)mounted internallydisk00/02: SYSTEM 3072MB( 3.0GB)mounted internallydisk00/04: SYSTEM 2048MB( 2.0GB)mounted internallydisk00/05: SYSFS 32768MB( 32.0GB)mounted at /local1disk00/06: CDNFS 433917MB(423.7GB)mounted internallydisk01: Normal (h02 c00 i01 l00 - mptsas) 476940MB(465.8GB)disk01/01: SYSTEM 5120MB( 5.0GB)mounted internallydisk01/02: SYSTEM 3072MB( 3.0GB)mounted internallydisk01/04: SYSTEM 2048MB( 2.0GB)mounted internallydisk01/05: SYSFS 32768MB( 32.0GB)mounted at /local1<Output truncated>The following example shows how to display the DMI information:
ServiceBroker# show hardware dmi--------------------- DMI Information -------------# dmidecode 2.9SMBIOS 2.5 present.70 structures occupying 2793 bytes.Table at 0xCFF66000.Handle 0x0000, DMI type 0, 24 bytesBIOS InformationVendor: Phoenix Technologies LTDVersion: 1.2aRelease Date: 04/09/2009Address: 0xE3DD0Runtime Size: 115248 bytesROM Size: 2048 kBCharacteristics:PCI is supportedPNP is supportedBIOS is upgradeableBIOS shadowing is allowedESCD support is availableBoot from CD is supportedServiceBroker#Related Commands
show hosts
To view the hosts on your SB, use the show hosts command in EXEC configuration mode.
show hosts
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
EXEC configuration mode.
Examples
The show hosts command lists the name servers and their corresponding IP addresses. It also lists the hostnames, their corresponding IP addresses, and their corresponding aliases (if applicable) in a host table summary.
Table 3-22 describes the fields shown in the show hosts display.
Table 3-22 show hosts Field Descriptions
Domain names
Domain names used by the device to resolve the IP address.
Name Server(s)
IP address of the DNS1 name server or servers.
hostname
FQDN2 (that is, hostname and domain) of the current device.
inet address
IP address of the current host device.
aliases
Name configured for the current device based on the host command in Global configuration mode.
1 DNS = Domain Name Server
2 FQDN = fully qualified domain name
show interface
To display the hardware interface information, use the show interface command in EXEC configuration mode.
show interface {all | GigabitEthernet slot/port | PortChannel {1 [lacp] | 2 | 3 | 4 } | standby group_num | TenGigabitEthernet slot/port}
Syntax Description
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
Table 3-23 describes the fields shown in the show interface GigabitEthernet display.
Table 3-24 describes the fields shown in the show interface PortChannel display.
Table 3-25 describes the fields shown in the show interface standby display.
Table 3-26 describes the fields shown in the show interface TenGigabitEthernet display.
Related Commands
show inventory
To display the system inventory information, use the show inventory command in EXEC configuration mode.
show inventory
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
The show inventory command allows you to view the unique device identifier information (UDI) for an SB. Typically, Cisco SBs contain the following three identification items that make up the UDI:
•
•
•
This identity information is stored in the SB nonvolatile memory. Each SB has a unique device identifier (UDI). The UDI shows PID, VID and SN.
The UDI is electronically accessed by the product operating system or network management application to enable identification of unique hardware devices. The data integrity of the UDI is vital to customers. The UDI that is programmed into the SB's nonvolatile memory is equivalent to the UDI that is printed on the product label and on the carton label. This UDI is also equivalent to the UDI that can be viewed through any electronic means and in all customer-facing systems and tools. Currently, there is only CLI access to the UDI; there is no SNMP access to the UDI information.
On newer SB models, you can use the show inventory command in EXEC configuration mode to display the SB's UDI. On older SB models, use the show tech-support command in EXEC configuration mode to display the SB's UDI.
Examples
The following example shows the inventory information for one of the newer SB models (SB-565):
ServiceBroker# show inventoryPID: SB-565-K9 VID: 0 SN: serial_numberIn the preceding example, serial number is the serial number of the SB. The version ID is displayed as "0" because the version number is not available.
Table 3-27 describes the fields shown in the show inventory display.
The following example shows that you must use the show tech-support command in EXEC configuration mode to display the inventory information on an older SB model:
ServiceBroker# show inventoryPlease look at 'sh tech-support' for information!ServiceBroker# show tech-supportRelated Commands
show tech-support
Displays system information necessary for Cisco Technical Support to assist you with your SB.
show ip
To display the, use the show ip command in user EXEC configuration mode.
show ip
Syntax Description
Command Default
None
Command Modes
User EXEC configuration mode.
Usage Guidelines
This command requires a Proximity Engine license.
Examples
To display information about an entry in the BGP routing table (for example, 42.1.1.0/24), use the show ip bgp 42.1.1.0/24 command. To locate information by IP address (for example, 42.1.1.1), use the show ip bgp 42.1.1.1 command.
ServiceRouter# show ip bgp 42.1.1.0/24BGP routing table entry for 42.1.1.0/24, version 12Paths: (1 available, best # 1)Flags: on xmit-list, is in urib, is best urib routePath type: internal, path is valid, is best pathAS-Path: NONE, path sourced internal to AS192.168.86.3 (metric 0) from 192.168.86.3 (192.168.86.3)Origin incomplete, MED 0, localpref 100, weight 0Not advertised to any peerServiceRouter# show ip bgp 42.1.1.1BGP routing table entry for 42.1.1.0/24, version 12Paths: (1 available, best # 1)Flags: on xmit-list, is in urib, is best urib routePath type: internal, path is valid, is best pathAS-Path: NONE, path sourced internal to AS192.168.86.3 (metric 0) from 192.168.86.3 (192.168.86.3)Origin incomplete, MED 0, localpref 100, weight 0Not advertised to any peerServiceRouter#
The following sample output shows the display when the advertised community and the configured location community matches:
ServiceRouter# sh ip bgp 1.1.1.1BGP routing table entry for 1.1.1.1/32, version 4Paths: (1 available, best # 1)Flags: on xmit-list, is in urib, is best urib routePath type: internal, path is valid, is best pathAS-Path: NONE, path sourced internal to AS48.0.0.8 (metric 0) from 48.0.0.8 (1.1.1.1)Origin IGP, MED 0, localpref 100, weight 0Community: 1:1(location specific)The following sample output shows the display when the community is not advertised to any peer:
ServiceRouter# sh ip bgp 33.1.5.0BGP routing table entry for 33.1.5.0/24, version 4Paths: (1 available, best #1)Flags: on xmit-list, is in urib, is best urib routePath type: internal, path is valid, is best pathAS-Path: 2 , path sourced external to AS62.0.0.2 (metric 20) from 26.0.0.6 (10.1.1.1)Origin IGP, MED 0, localpref 100, weight 0Community: 5:5(location specific)Related Commands
clear ip bgp
Clears entries in the BGP route table.
router bgp
Configures a BGP routing process.
show lacp
To display LACP information, use the show lacp command in EXEC configuration mode.
show lacp {counters| internal}
Syntax Description
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
You must first turn on LACP by entering the lacp command in Interface configuration mode before you can display the LACP statistics.
In the show lacp counters command, the LACP control packet is sent or received every 30 seconds. If one of the interfaces within the port channel goes down, then the counter value does not further increment for that interface.
Examples
The following example shows how to display the LACP statistics:
ServiceBroker# show lacp countersInterface PortChannel 1 (4 physical interface(s)):Protocol: noneInterface PortChannel 2 (4 physical interface(s)):lacpdu marker marker responsePort send receive send receive send receive error-----------------------------------------------------GigabitEthernet 7/0 16 16 0 0 0 0 0GigabitEthernet 8/0 16 15 0 0 0 0 0GigabitEthernet 9/0 16 15 0 0 0 0 0GigabitEthernet 10/0 17 15 0 0 0 0 0Interface PortChannel 3 (0 physical interface(s)):Protocol: noneInterface PortChannel 4 (0 physical interface(s)):Protocol: noneThe following example shows how to display the link status for the port channel:
ServiceBroker# show lacp internalInterface PortChannel 1 (4 physical interface(s)):Protocol: LACPMode: src-dst-portPort Admin-State Link-State LACP-State Aggregate id-----------------------------------------------------------------------------GigabitEthernet 3/0 up up bndl 21GigabitEthernet 4/0 up up bndl 21GigabitEthernet 5/0 up up bndl 21GigabitEthernet 6/0 up up bndl 21ServiceBroker# show interface portChannel 1 lacpInterface PortChannel 1 (4 physical interface(s)):Protocol: LACPMode: src-dst-portPort Admin-State Link-State LACP-State Aggregate id-----------------------------------------------------------------------------GigabitEthernet 3/0 up up bndl 21GigabitEthernet 4/0 up up bndl 21GigabitEthernet 5/0 up up bndl 21GigabitEthernet 6/0 up up bndl 21Related Commands
lacp
Turns on Link Aggregation Control Protocol (LACP).
show interface portchannel 1 lacp
Displays the link status for the port channel.
lacp
Turns on Link Aggregation Control Protocol (LACP).
show interface portchannel 1 lacp
Displays the link status for the port channel.
show logging
To display the system message log configuration, use the show logging command in EXEC configuration mode.
show logging
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
The following is an example of a syslog message for proxy mode native FTP support:
SB-FTP_PROXY-3-252009: Failed to configure FTP Proxy-mode listener on port' [ port ] '.Explanation: Could not start proxy-mode listener for FTP controlconnection for the specified port. The port is temporarilyin an un-bindable state, or is in use by some otherapplication.Action: Check whether the port has been configured for use by adifferent application. If not, retry theincoming proxy command after 2 minutes. If this errorrepeats frequently, contact Cisco TAC.To view information about events that have occurred in all devices in your VDS-SB network, you can use the system message log in the VDSM GUI. The VDSM logs only severity level critical or higher messages from registered nodes. Also, the VDSM logs certain other status messages that are considered important to the Centralized Management System (CMS). The messages displayed in the system message log for device, SB, are not related to the messages logged in the system log file on the sysfs partition on the VDSM as /local1/syslog.txt.
The syslog.txt file on the VDSM contains information about events that have occurred on the VDSM and not on the registered nodes. The messages that are written to the syslog.txt file depend on specific parameters of the system log file that you have set by using the logging Global configuration command. For example, a critical error message logged on a registered node does not appear in the syslog.txt file on the VDSM because the problem never occurred on the VDSM but only on the registered node. However, this error message is displayed in the system message log for device the SB device.
Examples
The following example shows how to display the syslog host configuration on an SB:
ServiceBroker# show loggingSyslog to host is disabledPriority for host logging is set to: warningSyslog to console is disabledPriority for console logging is set to: warningSyslog to disk is enabledPriority for disk logging is set to: noticeFilename for disk logging is set to: /local1/syslog.txtSyslog facility is set to *Syslog disk file recycle size is set to 500000Related Commands
clear
Clears the HTTP object cache, the hardware interface, statistics, archive working transaction logs, and other settings.
logging
Configures system logging.
show mount-option
To display the mount options, use the show mount-option command in EXEC configuration mode.
show mount-option
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
Table 3-28 describes the fields shown in the show mount-option display.
Table 3-28 show mount-option status Field Descriptions
Read/Write
ReadBlock Size
WriteBlock Size
Mount Timeout
Retransmit
Retry Minutes
Related Commands
show ntp
To display the Network Time Protocol (NTP) parameters, use the show ntp command in EXEC configuration mode.
show ntp status
Syntax Description
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
Table 3-29 describes the fields shown in the show ntp status display.
Related Commands
clock
Sets or clears clock functions or updates the calendar.
ntp
Configures the NTP server and allows the system clock to be synchronized by a time server.
show processes
To display CPU or memory processes, use the show processes command in EXEC configuration mode.
show processes [cpu | debug pid | memory | system [delay delay_num | count count_num]]
Syntax Description
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
Use the commands shown in this section to track and analyze system CPU utilization.
The show processes debug command displays the extensive internal system call information and a detailed account of each system call (and arguments) made by each process and the signals that it has received.
Use the show processes system command to display system updates. The delay option specifies the delay between updates, in seconds. The count option specifies the number of updates that are displayed. This command displays these items:
•
•
•
Note
Table 3-30 describes the fields shown in the show processes displays.
show radius-server
To display RADIUS information, use the show radius-server command in EXEC configuration mode.
show radius-server
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
Table 3-31 describes the fields shown in the show radius-server display.
Related Commands
show running-config
To display the current running configuration information on the terminal, use the show running-config command in EXEC configuration mode.
show running-config
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
Use this command with the show startup-config command to compare the information in running memory to the startup configuration used during bootup.
Note
Examples
The following example shows how to display the current running configuration information:
ServiceBroker# show running-config! VDS-SB version 2.6.0!device mode service-broker!!hostname EE8-2G2-5!!authsvr location-server primary 4.0.1.3 7000!!clock timezone PDT -7 0!!ip domain-name telstra.com!exec-timeout 0!!!!!interface PortChannel 1ip address 188.0.82.8 255.255.255.0exitinterface PortChannel 2ip address 188.87.0.5 255.255.0.0exit!interface GigabitEthernet 1/0channel-group 1exitinterface GigabitEthernet 2/0channel-group 1exitinterface GigabitEthernet 3/0channel-group 2exitinterface GigabitEthernet 4/0channel-group 2exitinterface GigabitEthernet 5/0channel-group 2exitinterface GigabitEthernet 6/0channel-group 2exitinterface GigabitEthernet 7/0channel-group 2exitinterface GigabitEthernet 8/0channel-group 2exitinterface GigabitEthernet 9/0channel-group 2exitinterface GigabitEthernet 10/0channel-group 2exit!streaming-interface PortChannel 2!!ip default-gateway 188.0.82.1ip default-gateway 188.87.0.1!!port-channel load-balance round-robinprimary-interface PortChannel 2!transaction-logs enabletransaction-logs archive max-file-size 2000000transaction-logs archive max-file-number 50transaction-logs archive interval 300transaction-logs export enabletransaction-logs export interval 5transaction-logs export sftp-server 188.0.84.5 root **** /var/ftp/pub/uploadtransaction-logs format custom "%J"!!!!!ip name-server 188.0.84.7!ip route 10.74.61.0 255.255.255.0 188.87.0.1ip route 171.70.77.0 255.255.255.0 188.87.0.1ip route 188.85.0.3 255.255.255.255 188.87.0.1ip route 188.0.86.3 255.255.255.255 188.0.82.1ip route 188.85.0.4 255.255.255.255 188.87.0.1ip route 225.1.1.12 255.255.255.255 188.87.0.1ip route 239.1.1.12 255.255.255.255 188.87.0.1ip route 239.1.1.14 255.255.255.255 188.87.0.1ip route 224.0.0.22 255.255.255.255 188.87.0.1!!!ntp server 171.68.10.150ntp server 171.68.10.80!!!!!!!!!!rule enable!!!!!movie-streamer enablemovie-streamer max-concurrent-sessions 10000movie-streamer advanced client idle-timeout 0movie-streamer advanced client rtp-timeout 0bitrate movie-streamer outgoing 6000000bitrate movie-streamer incoming 6000000!rtsp advanced max-request-rate 1000wmt max-concurrent-sessions 14000wmt cache min-ttl 1wmt cache max-ttl days 3wmt advanced client idle-timeout 300wmt advanced server inactivity-timeout 300wmt transaction-logs format extended wms-90!username admin password 1 $5$bVz2jc/k$QYvCAKrBmq3YqM5IklvuGrXQACMelfONdq3/siTpqV8username admin privilege 15!snmp-server enable traps configsnmp-server enable traps service-broker disk-failsnmp-server enable traps alarm raise-criticalsnmp-server enable traps alarm clear-criticalsnmp-server enable traps alarm raise-majorsnmp-server enable traps alarm clear-majorsnmp-server enable traps alarm raise-minorsnmp-server enable traps alarm clear-minorsnmp-server enable traps entitysnmp-server enable traps snmp cold-startsnmp-server host 188.0.84.6 telstra v2csnmp-server group telstra v2c read telstra notify telstrasnmp-server community telstra!!!tacacs key ****tacacs password asciitacacs host 188.0.84.5 primary!!ftp enable!telnet enable!!!!!!!VDSM ip 188.0.86.3cms enable!cms database maintenance regular schedule every-day at 04:00cms database maintenance full schedule Sun at 04:00!kernel kdbdisk error-handling reload!banner enable!bandwidth wmt outgoing 6000000 defaultbandwidth wmt outgoing 6000000 max-bandwidthbandwidth wmt incoming 6000000 defaultbandwidth wmt incoming 6000000 max-bandwidthbandwidth movie-streamer outgoing 6000000 defaultbandwidth movie-streamer outgoing 6000000 max-bandwidthbandwidth movie-streamer incoming 6000000 defaultbandwidth movie-streamer incoming 6000000 max-bandwidth!url-signature key-id-owner 1 key-id-number 1 key ****url-signature key-id-owner 2 key-id-number 2 key ****!!!!!!!!contentmgr disk-bucket-fail-threshold 1!! End of VDS-SB configurationServiceBroker#Related Commands
configure
Enters Global configuration mode.
copy
Copies the configuration or image data from a source to a destination.
show service-broker
To display the Service Broker configuration, use the show service-broker command in EXEC configuration mode.
On the SB:
show service-broker { access-policy | bfqdn [all | domain [name] [bfqdn-policy [print-script | print-xml]] ] | cdn [all | name cdn-name [ adaptation-policy [print-script | print-xml ]]] | cdn-network [dump-file | ip-address] | cdn-selection-policy [print-script | print-xml] | memory | service-broker-policy [ print-script ] | status [ all | cdn name] }
Syntax Description
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
This command allows users to check the Service Broker-related configuration. Through this command, users can view the configured features of an SB, such as location-based parameters.
Note
The memory usage is calculated in the show service-broker service-monitor command as follows:
Total used memory = total memory - (total free memory + total buffer memory + total cache memory) + total pinned memory. The percentage of total used memory = (total used memory)/total memory.
The total memory, total free memory, total buffer memory, and total cache memory are obtained from /proc/meminfo. The total pinned memory is obtained from /proc/ukse/ukse_prefetch_details.
show services
To display services-related information, use the show services command in EXEC configuration mode.
show services {ports [port_num] | summary}
Syntax Description
ports
Displays services by port number.
port_num
(Optional) Displays up to eight port numbers. The port number range is from 1 to 65535.
summary
Displays the services summary.
Defaults
None
Command Modes
EXEC configuration mode.
Examples
The following example shows how to display the services information by the port number:
VDSM# show services portsService information by port---------------------------550 Started on Mon Oct 14 12:13:20 2002Runs 1 serviceCisco_Streaming_Engine553 Started on Mon Oct 14 12:13:20 2002Runs 1 serviceRTSP_Gateway554 Started on Mon Oct 14 12:13:20 2002Runs 1 serviceRTSP_Gateway...15256 Started on Mon Oct 14 12:13:20 2002Runs 1 serviceCMS27999 Started on Mon Oct 14 12:13:20 2002Runs 1 serviceReal_Server28000 Started on Mon Oct 14 12:13:20 2002Runs 1 serviceReal_ProxyThe following example shows how to display a services information summary, showing the service and the associated port numbers:
VDSM# show services summaryService Ports-----------------------------------------------------CMS 15256 2000 2001 2002 2003 2004 2005GUI 8001Wmt 1755 1756 1757 1799icp 3128emdb 5432CertMgr 6001MgmtAgent 5252Real_Proxy 1090 8082 9002 555 28000 7879 6060 7071 3031VDSM_UI_http 8443Real_Server 7070 8081 9091 27999 7878 7802 1554 3030 4040 5050RTSP_Gateway 554 553RPC_APACHE_PORT 6550temp_RPC_APACHE_PORT 8008Cisco_Streaming_Engine 550 SNMPshow snmp
To check the status of Simple Network Management Protocol (SNMP) communications, use the show snmp command in EXEC configuration mode.
show snmp {alarm-history | engineID | group | stats | user}
Syntax Description
alarm-history
Displays SNMP alarm history information.
engineID
Displays the local SNMP engine identifier.
group
Displays SNMP groups.
stats
Displays SNMP statistics.
user
Displays SNMP users.
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
This command provides information on various SNMP variables and statistics on SNMP operations.
Table 3-32 describes the fields shown in the snmp alarm-history display.
Table 3-32 show snmp alarm-history Field Descriptions
Index
Serial number of the listed alarms.
Type
Status of whether the alarm has been Raised or Cleared.
Sev
Levels of alarm severity (Critical, Major or Minor).
Alarm ID
Traps sent by a VDS-SB device contain numeric alarm IDs.
ModuleID
Traps sent by a VDS-SB device contain numeric module IDs. See Table 3-34 to map module names to module IDs.
Category
Traps sent by an VDS-SB device contain numeric category IDs. See Table 3-34 to map category names to category IDs.
Descr
Description of the VDS-SB software alarm and the application that generated the alarm.
Table 3-33 describes the mapping of module names to module IDs.
Table 3-34 describes the mapping of category names to category IDs.
Table 3-34 Mapping of Category Names to Category IDs
Communications
1
Service Quality
2
Processing Error
3
Equipment
4
Environment
5
Content
6
Table 3-35 describes the fields shown in the show snmp stats display.
Table 3-36 describes the fields shown in the show snmp engineID display.
Table 3-36 show snmp engineID Field Descriptions
Local SNMP Engine ID
String that identifies the copy of SNMP on the local device.
Table 3-37 describes the fields shown in the show snmp group display.
Table 3-38 describes the fields shown in the show snmp user display.
Related Commands
show ssh
To display Secure Shell (SSH) status and configuration information, use the show ssh command in EXEC configuration mode.
show ssh
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
EXEC configuration mode.
Related Commands
show standby
To display standby interface information, use the show standby command in EXEC configuration mode.
show standby
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
Table 3-39 describes the fields shown in the show standby display.
Related Commands
show startup-config
To display the startup configuration, use the show startup-config command in EXEC configuration mode.
show startup-config
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
Use this command to display the configuration used during an initial bootup, stored in non-volatile random-access memory (NVRAM).
Examples
The following example shows how to display the startup configuration details on the SB:
ServiceBroker# show startup-config! VDS-SB version 2.3.9!device mode service-broker!!hostname V2-CDE220-3!!!primary-interface PortChannel 1!!interface PortChannel 1ip address 3.1.14.72 255.255.255.0exitinterface PortChannel 2ip address 4.0.8.13 255.255.255.0exit!interface GigabitEthernet 1/0channel-group 2exitinterface GigabitEthernet 2/0channel-group 2exitinterface GigabitEthernet 3/0channel-group 1exitinterface GigabitEthernet 4/0channel-group 1exitinterface GigabitEthernet 5/0channel-group 1exitinterface GigabitEthernet 6/0channel-group 1exit!!ip default-gateway 3.1.14.1!!offline-operation enable!!!rule action block pattern-list 3rule action redirect http://www.baidu.com pattern-list 2rule pattern-list 1 url-regex http://chunliu.com/b.wmvrule pattern-list 2 header-field request-line b.wmvrule pattern-list 3 header-field request-line c.wmv!icap service camiantserver icap://trythis/servernameexit!!!transaction-logs enabletransaction-logs archive interval 120!username admin password 1 bVmDmMMmZAPjYusername admin privilege 15!!authentication login local enable primaryauthentication configuration local enable primary!access-lists 300 deny groupname Disneyaccess-lists 300 permit groupname anyaccess-lists enable!!telnet enable!!!VDSM ip 4.0.8.10cms enable!!!service-broker service-monitor threshold wmt 50service-broker service-monitor number-of-samples wmt 5service-broker service-monitor sample-period wmt 15qos device-policy-service enable!!cache content max-cached-entries 1000! End of VDS-SB configurationRelated Commands
show statistics
To display the SB statistics, use the show statistics command in EXEC configuration mode.
show statistics { aaa | authentication | fd | icmp| icmpv6 | ip | lsof | netstat | radius | service-broker | services | snmp | tacacs | tcp | transaction-logs | udp }
On SB only:
show statistics {all | BFQDN [all | domain ] | cdn [ all | name ] | geo-location | history | javascript | summary}}
Syntax Description
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
The access control list statistics display the number of access requests, denials, and permissions recorded. Use the show statistics access-lists 300 command to display the number of group name accesses recorded.
Table 3-40 describes the fields shown in the show statistics access-lists 300 display.
Related Commands
clear
Clears the HTTP object cache, the hardware interface, statistics, archive working transaction logs, and other settings.
show statistics access-lists
To display SB access control list statistics, use the show statistics access-lists command in EXEC configuration mode.
show statistics access-lists
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
The access control list statistics display the number of access requests, denials, and permissions recorded. Use the show statistics access-lists 300 command to display the number of group name accesses recorded.
Table 3-41 describes the fields shown in the show statistics access-lists 300 display.
Related Commands
clear
Clears the HTTP object cache, the hardware interface, statistics, archive working transaction logs, and other settings.
show statistics admission
To display admission control statistics, use the show statistics admission command in EXEC configuration mode.
show statistics admission
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
Table 3-42 describes the fields shown in the show statistics admission display.
show statistics fd
To display file descriptors limit statistics, use the show statistics netstat command in EXEC configuration mode.
show statistics fd
Syntax Description
This command has no arguments or keywords.
Defaults
None
Command Modes
EXEC configuration mode.
Usage Guidelines
Table 3-43 describes the fields shown in the show statistics fd display.
Examples
The following is sample output from the show statistics fd command:
ServiceBroker# show statistics fdNumber of file descriptors in use = 3600Maximum number of file descriptions allowed = 262144Percentage of file descriptions in use = 1.37%
