FeedbackTable Of Contents
CLI Commands
This chapter includes the VFrame Data Center CLI. The commands in this chapter provide detailed information about the CLI.
•
copy
•
•
•
•
•
•
•
•
•
•
clear setup
To clear the current setup configuration, use the clear setup command in user EXEC mode.
clear setup
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
User EXEC.
Command History
Usage Guidelines
It will take anywhere from 30 to 60 minutes for the Director to reboot. Once it has rebooted, you can run the setup command on the iLO server to reconfigure your Director.
Examples
The following example clears the current setup configuration:
test-100# clear setupWarning: Running clear setup will cause the system to shut down VFrameDo you really want to clear the setup configuration: (yes/no) [no]? yesINFO: Removing admin passwordNo password found for user macrouser.Broadcast message from root (pts/0) (Wed Dec 27 10:08:55 2006):The system is going down for reboot NOW!test-100#Related Commands
clock
To manage the system clock, use the clock command in global configuration mode.
clock {set set-datetime | timezone}
no clock {set set-datetime | timezone}
Syntax Description
Defaults
The system clock is initially set to factory default.
Command Modes
Global configuration.
Command History
Examples
The following example sets the time zone:
test-100# configEnter configuration commands, one per line. End with CNTL/Z.test-100(config)# clock timezoneVerify if there are running jobs...There are 0 job(s) running.Do you want to shut down the VFDC to run clock timezone command? (yes/no) [no] ?Once you answer the preceding question, you enter the VFrame Data Center Director operating system. The redhat-config-date dialog box appears:
1.
2.
3.
Related Commands
ntp
Specifies the NTP peer and server.
show clock
Displays the current date and time.
config
To enter global configuration mode, use the config command in user EXEC mode.
config [terminal]
Syntax Description
Defaults
No default behavior or values.
Command Modes
User EXEC.
Usage Guidelines
Enter either the config or config terminal command to enter global configuration mode.
Command History
Examples
The following example changes EXEC mode to config mode by executing the config command:
test-100# configEnter configuration commands, one per line. End with CNTL/Z.test-100(config)#The following example changes EXEC mode to config mode by executing the config terminal command:
test-100# config terminalEnter configuration commands, one per line. End with CNTL/Z.test-100(config)#Related Commands
copy
To manage system files and patches, use the copy command in user EXEC mode.
copy {backup setup | file pname/fname url {scp:// | ftp://}hname/pname[/fname] | logs url
{scp:// | ftp://}hname/pname | setup {backup | url {scp:// | ftp://}hname/pname/fname} | url url/fname {install | license | setup}}Syntax Description
Defaults
No default behavior or values.
Command Modes
User EXEC.
Usage Guidelines
Typically, you obtain licenses or packages from Cisco.com.
When you save the license or package, use a name that is 80 characters or less.
The copy command is also useful for copying log files to your FTP or SCP server so that you can maintain copies, or send them to the Cisco Technical Assistance Center to help you resolve a problem.
Command History
Examples
The following example copies a patch to the installation staging area from an HTTP server that does not require user authentication:
test-100# copy url http://maintenance.example.com/vframe/VFrameDebug.zip installUsername:Getting image files...[OK]Unzipping files...[OK]Verifying patch signature...[OK]Installing files in staging area...[OK]test-100#The following example restores the local backup of a configuration file:
test-100# copy backup setupRe-initialize the database. Warning erases and initializes all data in the database:(yes/no) [no]? yes Start database sent mts message to system manager re-initializing thedatabase...This will take some time...
Note
Related Commands
del install
Deletes a patch from the installation staging area.
show files
Displays information about system files.
show license
Displays information about the product license.
db
To manage databases, use the db command in user EXEC mode.
db {backup [scp:// | ftp://]directory/file-name | dev {0 | 1 | 2} | reset | restore [scp:// | ftp://]directory/file-name | space reserved-space}
Syntax Description
Defaults
The default path is /nwdisks/2.
Command Modes
User EXEC.
Usage Guidelines
Before you restore a database, disable redundancy if you are using a redundant setup. Also, ensure that no one is logged in to the system.
When you use backup, you can include path information. The backup file is created on the backup storage medium selected when using the setup command.
When you use restore, you can include path information. The backup file must be on the backup storage medium selected when using the setup command.
Command History
Examples
The following example backs up a database to a file named Jul2006.backup in the /workspace directory:
test-100# db backup /workspace/Jul2006.backupwaiting for physical backup to completePhysical backup is completed.Save backup filetest-100#The following example restores the backup file named Jul2006.backup:
test-100# db restore /workspace/Jul2006.backupStopping servicesWaiting for 12 out of 13 processes to shutdownWaiting for 10 out of 13 processes to shutdownWaiting for 8 out of 13 processes to shutdownWaiting for 7 out of 13 processes to shutdownWaiting for 5 out of 13 processes to shutdownWaiting for 4 out of 13 processes to shutdownWaiting for 2 out of 13 processes to shutdownWaiting for 1 out of 13 processes to shutdownWaiting for 1 out of 13 processes to shutdownWaiting for 0 out of 13 processes to shutdownRestore DB from file...Bring upWait for DB on-line...Shutdown DB.Starting services.test-100#Related Commands
copy
Manages license files, setup files and logs.
setup
Performs initial system configuration.
debug services
To display debug and system logs in real time, use the debug services command in user EXEC mode. To disable debug display, use the no form of this command.
debug services {aaad | daemons | database | dbmnt | dhcpwd | hdrh | hsrp | imagemgmt | ntpwd | syscfg | sysmgr | sysmnt | system | trend | vccjava | vccvha | vframe}
Syntax Description
Defaults
No default behavior or values.
Command Modes
User EXEC.
Command History
Usage Guidelines
The debug command is similar to the show logging command. The difference is that the debug display keeps the log open so that you see messages as they are added to the log. The show logging command displays the contents of the log at the time you enter the command.
Press Ctrl+C to end the log display.
Examples
The following is sample output from the debug services aaad command:
test-100# debug services aaadSep 13 14:39:43,364 Added signal handler for SIGHUPSep 13 14:39:43,365 AAA daemon starting...Sep 13 14:39:43,365 active_start()test-100#The following is sample output from the debug services database command:
test-100# debug services database11:20:58 Maximum server connections 811:25:58 Checkpoint Completed: duration was 0 seconds.11:25:58 Checkpoint loguniq 198, logpos 0x4c9018, timestamp: 0x35577711:25:58 Maximum server connections 811:30:58 Checkpoint Completed: duration was 0 seconds.11:30:58 Checkpoint loguniq 198, logpos 0x4d4018, timestamp: 0x3557f711:30:58 Maximum server connections 811:35:58 Checkpoint Completed: duration was 0 seconds.11:35:58 Checkpoint loguniq 198, logpos 0x4df018, timestamp: 0x355877test-100#Related Commands
show logging
Displays debugging or system logs.
show tech
Displays technical information that is useful for system debugging.
del install
To delete a patch, use the del install command in user EXEC mode.
del install staged patch_name
Syntax Description
staged patch_name
Installs a patch from the patch staging area. Specifiy the patch name in patch_name. The maximum number of characters is 80.
Defaults
No default behavior or values.
Command Modes
User EXEC.
Usage Guidelines
Deleting a patch from the installation staging area does not uninstall the patch. You can not uninstall a patch that you installed using the install command.
Use the show install staged command to determine the patch name.
Command History
Examples
The following example deletes the VFrameDebug package from the staging area:
test-100# del install staged VFrameDebugtest-100#Related Commands
copy
Manages system files.
install
Installs software upgrades or patches.
show install
Displays information about packages in the installation staging area.
do
To execute a user EXEC mode command while in any configure mode, use the do command in Global configuration mode or ethernet interface configuration mode.
do exec-command
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration.
Ethernet interface configuration.
Command History
Usage Guidelines
Include the parameters required by the command.
Examples
The following example pings 192.0.2.10:
test-100# configEnter configuration commands, one per line. End with CNTL/Z.test-100(config)# do ping 192.0.2.10PING 192.0.2.10 (192.0.2.10) 56(84) bytes of data.64 bytes from 192.0.2.10: icmp_seq=0 ttl=253 time=0.378 ms64 bytes from 192.0.2.10: icmp_seq=2 ttl=253 time=0.325 ms--- 192.0.2.10 ping statistics ---4 packets transmitted, 2 received, 50% packet loss, time 3016msrtt min/avg/max/mdev = 0.325/0.351/0.378/0.032 ms, pipe 2test-100(config)#Related Commands
end
To exit modes, use the end command in ethernet interface configuration and global configuration modes.
end
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Global configuration.
Ethernet interface configuration.
Command History
Usage Guidelines
The end command exits ethernet interface configuration mode to user EXEC mode and global configuration mode to user EXEC mode.
The exit command exits ethernet interface configuration mode to global configuration mode, global configuration mode to user EXEC mode, and the current CLI session.
Examples
The following example shows how to enter the global configuration mode and then return to user EXEC mode using the end command:
test-100# configEnter configuration commands, one per line. End with CNTL/Z.test-100(config)# endtest-100#The following example shows how to enter ethernet interface configuration mode and then return to user EXEC mode using the end command:
test-100# configEnter configuration commands, one per line. End with CNTL/Z.test-100(config)# interface eth 0test-100(config-eth)# endtest-100#Related Commands
exit
The exit command exits ethernet interface configuration mode to global configuration mode, global configuration mode to user EXEC mode, and the current CLI session.
exit
To exit modes, use the exit command in ethernet interface configuration, global configuration and user EXEC modes.
exit
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
User EXEC.
Global configuration.
Ethernet interface configuration.
Command History
Usage Guidelines
The exit command exits ethernet interface configuration mode to global configuration mode, global configuration mode to user EXEC mode, and the current CLI session.
The end command exits ethernet interface configuration mode to user EXEC mode and global configuration mode to user EXEC mode.
Examples
The following example shows how to enter global configuration mode then exit using the exit command:
test-100# configEnter configuration commands, one per line. End with CNTL/Z.test-100(config)# exittest-100#Related Commands
end
Exits ethernet interface configuration mode to user EXEC mode and global configuration mode to user EXEC mode.
gir
To manage GIR settings, use the gir command in global configuration mode. To disable GIR settings, use the no form of this command.
gir {backup | remount | restore | setup}
no gir {backup | remount | restore | setup}
Syntax Description
Defaults
The default golden image repository is located on the VFrame Data Center Director.
Command Modes
Global configuration.
Command History
1.1
This command was introduced.
1.2
The keyword setup-ha-secondary was deprecated.
Usage Guidelines
To use this command, you must first use gir setup on the other system in the redundant pair, and configure an external repository on either an NFS volume or SAN LUN. Use this command to identify the location of the repository.
The gir command leads you through golden image repository configuration. You must know the location of the storage you select for the repository. If you are migrating an existing repository, you must also know the login information for the existing location.
Examples
The following example sets up a GIR at192.0.2.10 in the volume testvol1:
test-100# configEnter configuration commands, one per line. End with CNTL/Z.test-100(config)# gir setupWarning: Golden Image Repository setup will require shutting downsystem services, making VFDC temporarily unavailable andmigration of golden images might take a long time.Would you like to setup the GIR now (yes/no) [no] ? yesEnter the new GIR location type: Local, NFS or SAN (L/N/S) ? NEnter the Filer IP: 192.0.2.10Enter the Volume Name: testvol1Migrating to a NetApp filer.Please enter a username for 192.188.2.57: rootPlease enter a password for 192.188.2.57:Would you like to cleanup the old GIR after migration is complete? (yes/no): yesProceed with shutting down of system services? (yes/no): yesAttempting to mount new GIR to a temporary place.Mount successful.Waiting for services to shutdown...Stopped 2 of 2 servicesServices are down.Copying 847668 KB from /gir to /mnt/girtemp... copy is 100% completeAttempting to unmount the old GIR.Removing 847668 KB from /gir/*... remove is 100% completeUnmount successful.Remounting new GIR to permanent location.Remount successful.Starting VCC services.Updating System Configuration to reflect new GIR.GIR migrate is complete.test-100(config)#Related Commands
install
To manage patches, use the install command in user EXEC mode.
install {abort | update file-name [force]}
Syntax Description
Defaults
No default behavior or values.
Command Modes
User EXEC.
Command History
Usage Guidelines
Before you can install a patch, you must copy it into the staging area using the copy command. Following is the typical sequence of commands:
•
•
•
•
You cannot uninstall a patch. If you reinstall the entire system software, any patches in the staging area are erased.
Examples
The following example installs a patch called VFrameDebug:
test-100# install update VFrameDebugPROGRESS: extraction finished Fri Jul 28 11:04:59 PDT 2006PROGRESS: Start upgrade install scriptPROGRESS: Install completed OKtest-100#Related Commands
del install
Deletes a patch from the installation staging area.
show install
Displays information about packages in the installation staging area.
interface
To enter ethernet interface configuration mode, use the interface command in global configuration mode. To disable interface settings, use the no form of this command.
interface eth port-number
no interface eth port-number
Syntax Description
eth port-number
Accesses ethernet interface configuration mode. Specify the Ethernet port number in port-number. Valid port numbers are 0, 1 or 2.
Defaults
No default behavior or values.
Command Modes
Global configuration.
Command History
Usage Guidelines
Most interface configuration, such as specifying the IP address and subnet mask, is done using the setup command.
Examples
The following example shows you how to enter ethernet interface configuration mode:
test-100# configEnter configuration commands, one per line. End with CNTL/Z.test-100(config)# interface eth 0test-100(config-eth)#Related Commands
ip
To manage IP settings, use the ip command. To disable IP settings, use the no form of this command.
ip {dns {domain domain-name | server ip-address} | firewall eth port-number {management | data | open}} | start | stop | route network-ip gateway-ip [metric metric-value]}
no ip {dns {domain domain-name | server ip-address} | firewall eth port-number {management | data | open}} | start | stop | route network-ip gateway-ip [metric metric-value]}
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration.
Command History
Usage Guidelines
These are the firewall settings. Use the show ip iptables command to display more detailed information.
•
•
–
–
–
–
•
–
–
–
–
–
–
•
–
–
•
Examples
The following example adds a DNS server:
test-100# configEnter configuration commands, one per line. End with CNTL/Z.test-100(config)# ip dns server 192.168.1.4test-100(config)#The following example creates a management firewall on eth0:
test-100# configEnter configuration commands, one per line. End with CNTL/Z.test-100(config)# ip firewall eth 0 managementtest-100(config)# ip firewall starttest-100(config)#Related Commands
license
To install a license, use the license command in global configuration mode. To uninstall a license, use the no form of this command.
license install file-name
no license install file-name
Syntax Description
install file-name
Installs the product license. Specify the license file name in file-name. The maximum number of characters is 80.
Defaults
No default behavior or values.
Command Modes
Global configuration.
Command History
Usage Guidelines
VFrame has these types of product license:
•
To determine how many ports you using, open the VFrame GUI and select Help > About. The About dialog box displays your current licenses and how many ports you are using.
•
To obtain and install a product license, follow these steps:
1.
2.
3.
4.
5.
6.
7.
Examples
The following example installs a license:
test-100# configEnter configuration commands, one per line. End with CNTL/Z.test-100(config)# license install vfdc_20070531.txtSuccessfully installed license file!test-100(config)#Related Commands
copy url license
Retrieves a license file from a HTTP, TFTP, FTP or SCP server.
show license
Displays information about the VFrame product license.
ntp
To manage NTP settings, use the ntp command in global configuration mode. To disable NTP settings, use the no form of this command.
ntp {peer peer-name [prefer] | server server-name [prefer]}
no ntp {peer peer-name [prefer] | server server-name [prefer]}
Syntax Description
Defaults
NTP is not enabled.
Command Modes
Global configuration.
Command History
Usage Guidelines
If you disconnect from all NTP peers and servers, NTP is not used as the time protocol on your Director. The system clock is then maintained locally.
The system clock can change the peer clock, or the peer clock can change the system clock. The NTP server influences the system clock, but the system does not in turn influence the NTP server clock.
Examples
The following example specifies an NTP peer:
test-100# configEnter configuration commands, one per line. End with CNTL/Z.test-100(config)# ntp peer 10.100.40.16test-100(config)#The following example specifies an NTP server and identifies it as the preferred server:
test-100# configEnter configuration commands, one per line. End with CNTL/Z.test-100(config)# ntp server 10.100.40.17 prefertest-100(config)#Related Commands
show ntp
Displays the information about the NTP setup for the system.
show clock
Displays the current date and time.
ping
To test a remote system, use the ping command in user EXEC mode.
ping ip-address
Syntax Description
Defaults
No default behavior or values.
Command Modes
User EXEC.
Command History
Usage Guidelines
The command sends ICMP echo requests and waits for ICMP echo replies. A ping is successful when echo replies are received. A successful ping indicates that the remote system is alive and responsive.
The ping command sends four echo requests. Press Ctrl+C to end the ping before the four requests are finished.
Examples
The following example pings the remote system 192.0.2.10:
test-100# ping 192.0.2.10PING 192.0.2.10 (192.0.2.10) 56(84) bytes of data.From 10.100.30.1: icmp_seq=0 Redirect Host (New nexthop: 10.100.30.50)64 bytes from 192.0.2.10: icmp_seq=0 ttl=64 time=0.642 ms64 bytes from 192.0.2.10: icmp_seq=1 ttl=64 time=0.070 ms64 bytes from 192.0.2.10: icmp_seq=2 ttl=64 time=0.065 ms64 bytes from 192.0.2.10: icmp_seq=3 ttl=64 time=0.069 ms--- 192.0.2.10 ping statistics ---4 packets transmitted, 4 received, 0% packet loss, time 3011msrtt min/avg/max/mdev = 0.065/0.211/0.642/0.248 ms, pipe 2test-100#Related Commands
traceroute
Determines the router hops between the VFrame system and a remote system.
reboot
To restart the Director, use the reboot command in user EXEC mode.
reboot
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
User EXEC.
Command History
Usage Guidelines
The reboot command shuts down the system, and then restarts it. The shutdown command shuts down the system without restarting it.
After entering the reboot command, you are asked to confirm that you want to reboot the system. If you are connected to the system through an SSH client, you loose connection during the reboot and you must log in again.
If you are rebooting a system that is a member of a high-availability redundant pair and the system is the active member, use the redundancy resign command before the reboot command. Explicit resignation allows the standby system to take over active status without delay, making the transition smoother than if you simply reboot the system.
Examples
The following example reboots a VFrame Data Center Director:
test-100# rebootContinue with reboot? [y/n] yBroadcast message from root (pts/0) (Fri Jul 14 10:58:46 2006):The system is going down for reboot NOW!test-100#Related Commands
redundancy
To manage HA settings, use the redundancy command in global configuration mode. To disable HA settings, use the no form of this command.
redundancy {coup | enable | hellotime hellotime-seconds | holdtime holdtime-seconds | interface | peer host-name db-name ha-ipaddress server-ipaddress | resign}
no redundancy {enable | hellotime | holdtime | interface}
Syntax Description
Command Default
Redundancy is disabled.
Hello time is 10 seconds.
Hold time is 20 seconds.
Command Modes
Global configuration.
Usage Guidelines
You have to setup a remote GIR before you can enable redundancy.
You must enable high-availability during initial configuration for any of the redundancy commands to work. You also must install and configure the peer correctly.
If you disable redundancy, and reconfigure the system to use the local system as the backup location, the redundancy enable command prompts you to select a remote backup location.
If you did not configure the system to use an external database backup location during setup, the redundacy peer command prompts you to select a backup location. You must select a remote backup location to successfully configure redundancy.
Use the show redundancy status and show redundancy config commands to view the current status and configuration.
For redundancy to work correctly, the show system services command will show the hdrh and hsrp services as started. When VFrame is operating in standalone mode, the opposite state is normal for these services.
The coup command works only if the member is the standby member of the pair and redundancy is enabled.
The resign command works only if the member is the active member of the pair and redundancy is enabled.
Hold time is reset every time a heartbeat is received. After hold time is exceeded, the system assumes the peer is no longer functioning. If the system is currently the standby member of the pair, it takes over as the active member. To avoid unnecessarily quick failover, ensure that hold time is a multiple of hello time.
Command History
Examples
The following example identifies a peer and enables redundancy:
test-100# configEnter configuration commands, one per line. End with CNTL/Z.test-100(config)# redundancy peer vframepeer.example.com peerdb 192.0.2.10 192.0.2.11test-100(config)#The following example resigns active status for a member:
test-100# configEnter configuration commands, one per line. End with CNTL/Z.test-100(config)# redundancy resigntest-100(config)#The following example takes active status away from the peer:
test-100# configEnter configuration commands, one per line. End with CNTL/Z.test-100(config)# redundancy couptest-100(config)#Related Commands
db
Manages databases.
show redundancy
Displays information about high-availability settings.
setup
To perform system configuration, use the setup command in user EXEC mode.
setup
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
User EXEC.
Command History
Usage Guidelines
The setup command leads you through system configuration, asking for input based on previous input. In general, you should rerun this command only if you want to change the high-availability configuration.
Most changes require that you reinitialize the database, which erases all information in the database, including all items you or other users have created using the product. It also removes the golden image repository configuration.
Examples
The following is sample output from the setup command:
test-100# setupSetup is used to configure basic VFDC system parametersEntering System Configuration wizardPress Ctrl-C to abort configuration dialog at any prompt.Current/default settings are in square brackets '[]'.Press Enter to choose current/default value.Would you like to configure password for user 'admin' (yes/no) [no] ? yesChanging password for user admin.New password:BAD PASSWORD: it is based on a dictionary wordRetype new password:passwd: all authentication tokens updated successfully.Would you like to configure password for user 'macrouser' (yes/no) [no] ? yesChanging password for user macrouser.New password:Retype new password:passwd: all authentication tokens updated successfully.Enter hostname [test-100.nbv.cisco.com]:Enter Management (Northbound) Interface: eth [0]:Enter eth0 IP address [10.100.20.10]:Enter eth0 netmask [255.255.255.0]:Enter Server Communication Interface: eth [1]:Enter eth1 IP address []: 10.100.30.10Enter eth1 netmask []: 255.255.255.0Enter default gateway IP address [10.100.20.1]:Configure DNS Server (yes/no) [yes] ?Enter the DNS Server IP address [192.188.1.3]:Enter a unique Database Server name for this systemconsisting of up to 32 alphanumeric characters [vccids]:Would you like to configure HA interface (yes/no) [no] ?You have entered the following configuration:Hostname : test-100.nbv.cisco.comState : NormalManagement Interface : eth0Management IP/Netmask : 10.100.20.10 255.255.255.0Server Comn Interface : eth1Server Comn IP/Netmask : 10.100.30.10 255.255.255.0Default Gateway IP : 10.100.20.1DNS Domain Name : nbv.cisco.comDNS Server IP : 192.188.1.3VHA connection over SSL: yesStorage mode : Storage Template ArrayDB backup size estimate: 5000000DB Server Name : vccidsDB backup storage : localGIR Type : UnavailableHA Mode : standaloneWould you like to apply this configuration (yes/no) [yes] ? yesStopping servicesWaiting for 0 out of 16 processes to shutdownWaiting for IDS to go downWaiting for vcc_java to go downtest-100#Related Commands
clear setup
Clears the current setup configuration.
show redundancy
Displays information about high-availability.
show system
Displays information about the system.
show cdp
To display information about CDP settings, use the show cdp command in user EXEC mode.
show cdp {all | entry {all | name device-name} | global | neighbors [detail]}
Syntax Description
Defaults
No default behavior or values.
Command Modes
User EXEC.
Command History
Examples
The following is sample output from the show cdp global command:
test-100# show cdp globalGlobal CDP information:CDP enabled globallySending CDP packets every 60 secondsSending a holdtime value of 180 secondsSending CDPv2 advertisements is enabledtest-100#The following is sample output from the show cdp neighbors command:
test-100# show cdp neighborsCapability Codes: R - Router, T - Trans-Bridge, B - Source-Route-BridgeS - Switch, H - Host, I - IGMP, r - RepeaterDevice ID Local Intrfce Hldtme Capability Platform Port IDswitch1.example.com eth0 174 R S I WS-C6509-E Gig3/24switch1.example.com eth1 174 R S I WS-C6509-E Gig3/37test-100#Related Commands
show clock
To display the current date and time, use the show clock command in user EXEC mode.
show clock
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
User EXEC.
Command History
Examples
The following example displays the system clock:
test-100# show clockFri Jul 28 15:30:32 PDT 2006test-100#Related Commands
ntp
Enables NTP.
show ntp
Displays information about the Network Time Protocol (NTP) setup.
show fault
To display information about system errors, use the show fault command in user EXEC mode.
show fault {history system-errors | status}
Syntax Description
Defaults
No default behavior or values.
Command Modes
User EXEC.
Command History
Usage Guidelines
VFrame system fault alarms relate to the functioning of the VFrame Data Center Director instead of your data center equipment and service networks. You can configure notifications for these fault alarms in the SMTP system settings.
VFrame system fault state machines can have these states:
•
•
When you use the show fault history command, the fault alarm severity is represented by a number. The numbers have the following meanings:
•
•
•
•
The following are the VFrame system fault notifications:
•
To resolve the problem, use any of the following:
–
–
–
–
•
To resolve the problem, use any of the following:
–
–
•
To resolve the problem, use any of the following:
–
–
–
•
To resolve the problem, use any of the following:
–
•
To resolve the problem, use any of the following:
–
–
•
To resolve the problem, create space on the local disk.
Examples
The following is sample output from the show fault status command:
test-100# show fault statusSystem Fault State=====================================HA Peer Unreachable CLEARDB Down CLEARDB Backup Down CLEARVFDC service down CLEARGIR Unreachable CLEARVFDC in unlicensed state CLEARtest-100#Related Commands
show files
To display information about system files, use the show files command in user EXEC mode.
show files {inventory | logs | tftp}
Syntax Description
inventory
Displays files in the inventory directory.
logs
Displays files in the logs directory.
tftp
Displays files in the tftp directory.
Defaults
No default behavior or values.
Command Modes
User EXEC.
Command History
Examples
The following is sample output from the show files tftp command:
test-100# show files tftp/tftp/tftp/initrd-discos.img/tftp/WinuUdates-dummy.exe/tftp/setup.exe/tftp/vfdcInvTest.iso/tftp/initrd-discos.img.org/tftp/linux-discos/tftp/vha_simdc/tftp/tftp/tftp/pxelinux.cfg/tftp/pxelinux.cfg/default/tftp/bootlog/tftp/servers/tftp/pxelinux.0/tftp/vha-lnx.i386.rpm/tftp/vha-esx.i386.rpm/tftp/config.texttest-100#Related Commands
copy file
Copies a file to a remote URL.
show logging trend
Displays the debug log for the trend service.
show gir
To display information about the GIR, use the show gir command in user EXEC mode.
show gir
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
User EXEC.
Command History
Examples
The following is sample output from the show gir command:
test-100(config)# show girCurrent GIR Information: NFS - Filer: 192.0.2.10 Volume: testvol1Size Total (MB): 16384Size Used (MB): 10609Inodes Total: 553413Inodes Used: 198793test-100#Related Commands
show hardware
To display information about hardware, use the show hardware command in user EXEC mode.
show hardware
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
User EXEC.
Command History
Examples
The following is sample output from the show hardware command:
test-100# show hardwareSystem: VFDC ServerModel: HP ProLiant DL380 G4Serial No: USE547N3F2Processor: CPU 0Model: Intel(R) Xeon(TM) CPU 3.40GHzFreq: 3400.295 MHz, Cache: 1024 KBytesProcessor: CPU 1Model: Intel(R) Xeon(TM) CPU 3.40GHzFreq: 3400.295 MHz, Cache: 1024 KBytesProcessor: CPU 2Model: Intel(R) Xeon(TM) CPU 3.40GHzFreq: 3400.295 MHz, Cache: 1024 KBytesProcessor: CPU 3Model: Intel(R) Xeon(TM) CPU 3.40GHzFreq: 3400.295 MHz, Cache: 1024 KBytesEthernet: eth0MAC: 00:14:C2:C0:94:E7Max speed: 1000 Mb/sEthernet: eth1MAC: 00:14:C2:C0:94:E6Max speed: 1000 Mb/sEthernet: eth2MAC: 00:14:C2:44:FC:0CMax speed: 1000 Mb/sHost Bus Adapter: qla2300/0Model: QLA2312Node WWN: 200000e08b847b8e, Port WWN: 210000e08b847b8eDisk: /dev/cciss/c0d0Size: 69459 MBytestest-100#Related Commands
show interface
Displays configuration information about the Ethernet interfaces.
show ids
To display information about IDS, use the show ids command in user EXEC mode.
show ids {config | logs | parameters | status}
Syntax Description
config
Displays IDS configuration.
logs
Displays IDS logs.
parameters
Displays IDS parameters.
status
Displays IDS online status.
Defaults
No default behavior or values.
Command Modes
User EXEC.
Command History
Examples
The following is sample output from the show ids logs command:
test-100# show ids logsIBM Informix Dynamic Server Version 10.00.UC1 -- On-Line -- Up 9 days 02:02:57 -- 108388 KbytesPhysical LoggingBuffer bufused bufsize numpages numwrits pages/ioP-1 4 16 51332 5399 9.51phybegin physize phypos phyused %used1:9793 10000 6767 4 0.04Logical LoggingBuffer bufused bufsize numrecs numpages numwrits recs/pages pages/ioL-1 0 16 8804706 1129992 537159 7.8 2.1Subsystem numrecs Log Space usedOLDRSAM 8804706 1642982588address number flags uniqid begin size used %used483bd0b0 7 U-B---- 567 3:53 2000 2000 100.00483bd0f8 8 U-B---- 568 3:2053 2000 2000 100.00483bd140 9 U-B---- 569 3:4053 2000 2000 100.00483bd188 10 U-B---- 570 3:6053 2000 2000 100.00483bd1d0 11 U-B---- 571 3:8053 2000 2000 100.00483bd218 12 U-B---- 572 3:10053 2000 2000 100.00483bd260 13 U-B---- 573 3:12053 2000 2000 100.00483bd2a8 14 U-B---- 574 3:14053 2000 2000 100.00483bd2f0 15 U-B---- 575 3:16053 2000 2000 100.00483bd338 16 U-B---- 576 3:18053 2000 2000 100.00483bd380 17 U---C-L 577 3:20053 2000 957 47.85483bd3c8 18 U-B---- 562 3:22053 2000 2000 100.00483bd410 19 U-B---- 563 3:24053 2000 2000 100.00483bd458 20 U-B---- 564 3:26053 2000 2000 100.00483bd4a0 21 U-B---- 565 3:28053 2000 2000 100.00483bd4e8 22 U-B---- 566 3:30053 2000 2000 100.0016 active, 16 totaltest-100#Related Commands
show install
To display information about patches, use the show install command in user EXEC mode.
show install {history [detail [name patch-name] | short] | staged [detail [name patch-name]]}
Syntax Description
Command Default
The default for history is short.
Command Modes
User EXEC.
Command History
Usage Guidelines
Use the show install staged command after you copy a patch into the staging area to determine the exact name you will need to use on the install command.
Examples
The following is sample output from the show install staged command:
test-100# show install stagedPatches waiting in staging areaName Version Type Summary----------------- -------- ------- -------------------VFRAMEDebug 1.1 update VFRAME Debug patchtest-100#Related Commands
show interface
To display information about the Ethernet interfaces, use the show interface command in user EXEC mode.
show interface [eth port-number]
Syntax Description
eth port-number
(Optional) Identifies the Ethernet interface. Specify the port number in port-number. Valid port numbers are 0, 1 or 2.
Command Default
No default behavior or values.
Command Modes
User EXEC.
Command History
Examples
:The following is sample output from the show interface eth 0 command:
test-100# show interface eth 0eth0:IP address: 10.100.20.10, netmask: 255.255.255.0broadcast address: 10.100.20.255hardware address: 0:14:c2:c0:94:e7Up Broadcast IfIndex= 2Received: 114865 bytes, 892 packets, 0 input errors, 0 dropsTransmitted: 80600 bytes, 638 packets, 0 output errors, 0 dropstest-100#Related Commands
show ip
To display information about IP settings, use the show ip command in user EXEC mode.
show ip {dns | firewall [eth port-number] | iptables | route}
Syntax Description
Command Default
No default behavior or values.
Command Modes
User EXEC.
Command History
Usage Guidelines
For information on how to configure the settings displayed by this command, and on the various firewall settings, see the ip command.
Examples
The following is sample output from the show ip dns command:
test-100# show ip dnssearch example.comdomain example.comnameserver 192.168.1.3test-100#The following is sample output from the show ip firewall command:
test-100# show ip firewallfirewall eth0 : managementfirewall eth1 : datafirewall eth2 : opentest-100#Related Commands
ip
Manages IP settings.
show interface
Displays information about the Ethernet interfaces.
show license
To display information about licenses, use the show license command in user EXEC mode.
show license {file [all | name file-name] | hostid | status}
Syntax Description
Command Default
No default behavior or values.
Command Modes
User EXEC.
Command History
Usage Guidelines
The list that displays when you use the all command does not include downloaded license files.
Examples
The following is sample output from the show license hostid command:
test-100# show license hostid0014c2c094e7test-100#The following is sample output from the show license status command:
test-100# show license statusLicensed Feature License count--------------------------------------------------LicVFrameAccessSwitchPortsMax 100LicVFrameHA N/Atest-100#Related Commands
show logging
To display debug or system logs, use the show logging command in user EXEC mode.
show logging {daemons | database | dbmnt | dhcpwd | hdrh | hsrp | imagemgmt | ntpwd |
syscfgd | sysmgr | sysmnt | system | trend | vccjava | vccvha | vframe}Syntax Description
Command Default
No default behavior or values.
Command Modes
User EXEC.
Command History
Usage Guidelines
Enter q and press Enter if you want to stop the log display before reaching the end of the log.
The debug services command and the show logging command are similar. The difference is that debug displays in real time. It keeps the log open so that you see messages as they are added to the log. The show logging command displays the contents of the log at the time you enter the command.
Examples
The following is sample output from the show logging vframe command:
test-100# show logging vframedDec 26 12:50:28 test-100 sysmnt: Added signal handler for SIG_LOG_INITDec 26 12:51:13 test-100 dbmnt: Added signal handler for SIG_LOG_INITDec 26 12:51:37 test-100 aaad: Added signal handler for SIG_LOG_INITDec 26 12:52:07 test-100 dhcpwd: DHCPWD StartingDec 26 12:53:33 test-100 dhcpwd: No dhcp subnets defined in configtest-100#Related Commands
debug services
Displays debug or system logs in real time.
show tech
Displays information useful for system debugging.
show logins
To display information about CLI log ins, use the show logins command in user EXEC mode.
show logins cli [count user-logins]
Syntax Description
cli
Displays the login history.
count user-logins
(Optional) Displays a specific number of logins. Specify the number of logins in user-logins. The maximum number of characters is 4294967296.
Command Default
The default for count is 10.
Command Modes
User EXEC (Exec)
Usage Guidelines
The login information table displays the following information (from left to right):
•
•
•
•
If you want to view user login information in the GUI, use the VFrame Administration dialog box.
Command History
Examples
The following is sample output from the show login cli command:
test-100# show logins cliroot pts/0 Mon Jul 24 10:18 still logged in vpn.example.comroot pts/1 Fri Jul 21 15:54 - 16:33 (00:39) vpn.example.comroot pts/0 Fri Jul 21 15:42 - 16:37 (00:54) 192.168.216.147reboot system boot Fri Jul 21 15:41 (2+18:39) 10.100.20.5root pts/0 Fri Jul 21 14:07 - down (01:27) 192.168.216.147reboot system boot Fri Jul 21 14:06 (01:27) 10.100.20.5root pts/0 Fri Jul 21 13:54 - down (00:05) 192.168.216.147root pts/0 Fri Jul 21 11:42 - 13:54 (02:12) 192.168.216.147reboot system boot Fri Jul 21 11:41 (02:18) 10.100.20.5reboot system boot Fri Jul 21 11:34 (00:03) 10.100.20.5test-100#Related Commands
show ntp
To display information about NTP settings, use the show ntp command in user EXEC mode.
show ntp {config | status | trace}
Syntax Description
config
Displays a list of NTP servers and peers.
status
Displays clock accuracy and the polling interval.
trace
Displays a trace of NTP server relationships.
Defaults
No default behavior or values.
Command Modes
User EXEC.
Command History
Usage Guidelines
You must already have added NTP servers to the configuration to see any output.
Examples
The following is sample output from the show ntp config command:
test-100# show ntp configntp server 10.68.10.150 preferntp server 10.68.10.151test-100#The following is sample output from the show ntp trace command:
test-100# show ntp trace127.0.0.1: stratum 3, offset 0.000011, synch distance 0.10518171.68.10.80: stratum 2, offset 0.003159, synch distance 0.09409144.254.15.121: stratum 1, offset 0.003738, synch distance 0.00000, refid 'GPS'test-100#Related Commands
show process
To display information about processes running on the Director, use the show process command in user EXEC mode.
show process
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
User EXEC.
Command History
Examples
The following is sample output from the show process command:
test-100# show processPID TTY STAT TIME COMMAND5 ? SW 0:00 [migration/3]4 ? SW 0:00 [migration/2]3 ? SW 0:00 [migration/1]2 ? SW 0:00 [migration/0]1 ? S 0:07 init6 ? SW 0:00 [keventd]7 ? SWN 0:00 [ksoftirqd/0]8 ? SWN 0:00 [ksoftirqd/1]9 ? SWN 0:00 [ksoftirqd/2]10 ? SWN 0:00 [ksoftirqd/3]13 ? SW 0:00 [bdflush]11 ? SW 0:01 [kswapd]12 ? SW 0:02 [kscand]14 ? SW 0:06 [kupdated]15 ? SW 0:00 [mdrecoveryd]23 ? SW 0:00 [qla2300_dpc0]24 ? SW 0:00 [qla2300_dpc1]25 ? SW 0:00 [scsi_eh_0]26 ? SW 0:00 [scsi_eh_1]29 ? SW 0:15 [kjournald]72 ? SW 0:00 [khubd]193 ? SW 0:00 [kjournald]194 ? SW 0:00 [kjournald]195 ? SW 0:00 [kjournald]196 ? SW 0:00 [kjournald]557 ? S 0:00 syslogd -m 0561 ? S 0:00 klogd -x571 ? S 0:19 irqbalance581 ? S 0:00 portmap600 ? S 0:00 rpc.statd687 ? S 0:01 /usr/sbin/sshd10749 ? S 0:00 \_ sshd: admin@pts/010763 pts/0 S 0:00 \_ /bin/bash /opt/vcc/system/bin/vccsh.sh10764 pts/0 S 0:00 \_ /opt/vcc/system/bin/vccsh -s /opt/vcc/system/cfg/main_tree.par10804 pts/0 S 0:00 \_ /opt/vcc/system/bin/vccsh -s /opt/vcc/system/cfg/main_tree.par10806 pts/0 R 0:00 | \_ /bin/ps -ax --forest10805 pts/0 S 0:00 \_ more706 ? SW 0:00 [nfsd]707 ? SW 0:00 [nfsd]708 ? SW 0:00 [nfsd]709 ? SW 0:00 [nfsd]710 ? SW 0:00 [nfsd]711 ? SW 0:00 [nfsd]712 ? SW 0:00 [nfsd]713 ? SW 0:00 [nfsd]714 ? SW 0:00 [lockd]715 ? SW 0:00 [rpciod]719 ? S 0:00 rpc.mountd728 ? S 0:00 crond745 ? SW 0:00 [loop0]746 ? SW 0:00 [kjournald]772 ? S 0:02 /opt/vcc/system/bin/sysmgr_main start789 ? S 0:00 \_ /opt/vcc/system/bin/logger --logname /var/log/daemons.log --pidfile /var/run/vcc/sysmgrLogger.pid790 ? S 0:44 \_ /opt/vcc/system/bin/monit -s /opt/vcc/config/monit.state -Ic /opt/vcc/config/monitrc792 ? S 0:02 | \_ /opt/vcc/system/bin/monit -s /opt/vcc/config/monit.state -Ic /opt/vcc/config/monitrc793 ? S 0:04 | \_ /opt/vcc/system/bin/monit -s /opt/vcc/config/monit.state -Ic /opt/vcc/config/monitrc877 ? S 0:02 \_ /opt/vcc/system/bin/sysmgr_main start777 ttyS0 S 0:00 /sbin/agetty ttyS0 9600 vt100-nav778 tty1 S 0:00 /sbin/mingetty tty1779 tty2 S 0:00 /sbin/mingetty tty2780 tty3 S 0:00 /sbin/mingetty tty3781 tty4 S 0:00 /sbin/mingetty tty4782 tty5 S 0:00 /sbin/mingetty tty5783 tty6 S 0:00 /sbin/mingetty tty6785 ttyS1 S 0:00 /sbin/agetty -L 9600 ttyS1 vt102795 ? S 0:02 /opt/vcc/system/bin/mon_maild1003 ? S 0:00 /opt/vcc/system/bin/sysmnt1018 ? S 11:22 /opt/informix/10/bin/oninit -Sy1019 ? S 0:17 \_ /opt/informix/10/bin/oninit -Sy1020 ? S 0:14 \_ /opt/informix/10/bin/oninit -Sy1021 ? S 0:03 \_ /opt/informix/10/bin/oninit -Sy1022 ? S 0:18 \_ /opt/informix/10/bin/oninit -Sy1023 ? S 0:02 \_ /opt/informix/10/bin/oninit -Sy1024 ? S 0:03 \_ /opt/informix/10/bin/oninit -Sy1025 ? S 1:42 \_ /opt/informix/10/bin/oninit -Sy1026 ? S 0:02 \_ /opt/informix/10/bin/oninit -Sy1027 ? S 0:02 \_ /opt/informix/10/bin/oninit -Sy1028 ? S 0:02 \_ /opt/informix/10/bin/oninit -Sy1029 ? S 0:02 \_ /opt/informix/10/bin/oninit -Sy1030 ? S 0:02 \_ /opt/informix/10/bin/oninit -Sy1031 ? S 0:02 \_ /opt/informix/10/bin/oninit -Sy1302 ? S 0:00 /opt/vcc/system/bin/syscfgd1308 ? S 1:20 /opt/vcc/system/bin/dbmnt1332 ? S 0:01 /opt/vcc/system/bin/cdpd1335 ? S 0:00 /opt/vcc/system/bin/ntpwd1338 ? SL 0:09 \_ /usr/sbin/ntpd -b -n -U ntp -g -x1340 ? S 0:05 /opt/vcc/system/bin/radiusd1373 ? S 0:31 /opt/vcc/system/bin/aaad1398 ? S 0:00 /usr/sbin/in.tftpd -l -v -s /tftpboot1448 ? S 0:02 /opt/vcc/system/bin/image_mgmt1551 ? SN 0:00 /opt/vcc/system/bin/vcc_vha1553 ? SN 0:02 \_ /opt/vcc/system/bin/vcc_vha1554 ? SN 0:09 \_ /opt/vcc/system/bin/vcc_vha1555 ? SN 0:05 \_ /opt/vcc/system/bin/vcc_vha1571 ? S 0:00 /opt/vcc/system/bin/dhcpwd1573 ? S 0:02 \_ /opt/vcc/system/bin/dhcpwd1574 ? S 0:00 \_ /opt/vcc/system/bin/dhcpwd1579 ? S 1:21 /usr/bin/perl -w /home/informix/bin/phyll.pl24386 ? S 22:59 /usr/java/jre/bin/java -classpath /opt/vcc/java-app/cfg/jetty:/opt/vcc/java-app/classes:/opt/vcc/java-app/www/WEB-INF/lib/DMXMLExport.jar:/opt/vcc/java-app/www/WEB-INF/lib/HPiLOXMLTypes.jar:/opt/vcc/java-app/www/WEB-INF/lib/ImportExport.jar:/opt/vcc/java-app/www/WEB-INF/lib/LogicalServerXMLTy7759 ? S 0:00 /opt/informix/10/bin/ontape -ctest-100#Related Commands
show redundancy
To display information about redundancy settings, use the show redundancy command in user EXEC mode.
show redundancy {config | status}
Syntax Description
config
Displays information about redundancy settings.
status
Displays information about the HSRP and DB servers
Command Default
No default behavior or values.
Command Modes
User EXEC.
Command History
Examples
The following is sample output from the show redundancy config command:
test-100# show redundancy configHA Priority:100 Hellotime:10 Holdtime:20DB Server Name: vframehostHA Mode: pairDB backup storage: nfsNFS Server IP: 192.168.2.57Volume: vol/BackupVol1HA IP: 10.3.6.141Server Comn IP: 10.100.30.10Peer DB Server Name: vfpeerdbPeer HA IP: 10.3.6.132Peer Server Comn IP: 10.100.30.11Peer hostname: vframepeertest-100#The following is sample output from the show redundancy status command:
test-100# show redundancy statusLocal PeerHA state: ACTIVE_READY STANDBY_READYDB state: IDS_UP IDS_UPDB mode: Primary SecondaryDB hdr status: in synctest-100#Related Commands
show system
To display information about system services and settings, use the show system command in user EXEC mode.
show system {services | setup}
Syntax Description
services
Displays information about system services.
setup
Displays information about the system settings.
Command Default
None.
Command Modes
User EXEC.
Command History
Usage Guidelines
When you display the status of system services, the expected state differs depending on whether the system is part of an active redundant pair. If the status is OK, the state of that service is the expected state under the current operating conditions.
•
•
If the status of a service is listed as not OK, you can use the tech service reset command to restart the service. If the tech command cannot restart the service, you must reboot the system.
Examples
The following is sample output from the show system services command:
test-100# show system servicesService Status State-------------------------------------------------------mon_maild Ok Startedhsrp Ok Downhdrh Ok Downbackup Ok Startedids Ok Starteddhcpwd Ok Startedvcc_vha Ok Startedimage_mgmt Ok Startedvcc_java Ok Startedtftp Ok Startedaaad Ok Startedradiusd Ok Startedntpwd Ok Startedcdpd Ok Startedsyscfgd Ok Startedmts Ok Startedtest-100#The following is sample output from the show system setup command:
test-100# show system setupHostname : vframehost.example.comManagement Interface : eth0Management IP/Netmask : 10.100.20.10 255.255.255.0Server Comn Interface : eth1Server Comn IP/Netmask : 10.100.30.10 255.255.255.0Default Gateway IP : 10.100.20.1DNS Domain Name : example.comDNS Server IP : 10.100.50.25VHA connection over SSL: noStorage mode : Storage Template ArrayDB Server Name : vccidsDB backup storage : localGIR Type : NFSGIR NFS Filer : 10.100.50.25GIR NFS Volume : girvol1HA Mode : standalonetest-100#Related Commands
gir
Manages GIR settings.
setup
Performs system configuration.
tech
Manages advanced system debugging.
show tech
To display information useful for system debugging, use the show tech command in user EXEC mode.
show tech
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
User EXEC.
Command History
Usage Guidelines
The show tech command displays this information:
•
•
•
•
•
•
•
•
•
•
•
Examples
The following is sample output from the show tech command:
test-100# show techSerial Number: USE547N3F2Uptime15:05:07 up 5 days, 21:17, 1 user, load average: 0.00, 0.01, 0.00Memorytotal used free shared buffers cachedMem: 2055436 1442520 612916 0 56864 763928-/+ buffers/cache: 621728 1433708Swap: 2048136 0 2048136
Note
Related Commands
show version
To display the software version, use the show version command in user EXEC mode.
show version
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
User EXEC.
Command History
Examples
The following is sample output from the show version command:
test-100# show versionVFrame Data CenterVersion 1.1.0.687Compiled on Tue May 22 03:00:38 PDT 2007Copyright 2007 by Cisco Systems, IncVHA Versions:1.301.linux.1.3011.301.windows.1.302System Uptime is 0 days, 4 hours, 6 minutes 5 secsHostname is vframehost.example.comtest-100#Related Commands
shutdown
To disable an Ethernet interface, use the shutdown command in global configuration mode. To shutdown a Director, use the shutdown command in user EXEC mode. To enable an interface, use the no form of the command.
shutdown
no shutdown
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
User EXEC.
Ethernet interface configuration.
Command History
Usage Guidelines
If you shut down the system, reboot it using the iLO interface. If you want to shut down the system and restart it immediately, use the reboot command.
If you are shutting down a system that is a member of a high-availability pair and the system is the active member, use the redundancy resign command before using the shutdown command. Explicit resignation allows the standby system to take over active status without delay, making the transition smoother.
Examples
The following example shuts down eth2:
test-100# configEnter configuration commands, one per line. End with CNTL/Z.test-100(config)# interface eth 2test-100(config-eth)# shutdowntest-100(config-eth)#Related Commands
config
Provides access to global configuration mode.
end
Exits modes.
reboot
Restarts the Director.
ssh
To create an SSH connection to another network device, use the ssh command in user EXEC mode.
ssh ip-address user-name [port port-number [version {1 | 2}] | version {1 | 2}]
Syntax Description
Command Default
The default SSH port is 22.
The default SSH version is 2.
Command Modes
User EXEC.
Command History
Usage Guidelines
The ssh command creates a standard SSH client connection. Once connected, you are operating in the remote host mode until you quit the SSH connection, typically by entering the quit command.
If the remote device accepts the connection, you are prompted for the user password.
Specify a port number only if the remote system is configured to use a port other than the default port for SSH.
Examples
The following example creates an SSH connection to the host 192.0.2.10 using the root user account:
test-100# ssh 192.0.2.10 rootroot@192.0.2.10's password:Related Commands
tech
To manage advanced system debugging, use the tech command in user EXEC mode.
tech {dumptcp port-number [count packets-dumped] | dumpthreads | renable | service reset service-name | unenable | verify}
Syntax Description
Command Default
No default behavior or values.
Command Modes
User EXEC.
Command History
Usage Guidelines
If you do not specify the count parameter, all packets are dumped to the console.
Press Ctrl+C to stop a dump.
You must have advanced knowledge of TCP/IP in order to read and understand the information dumped to the console. The information is meant to help advanced users diagnose connection problems in the network.
Examples
The following example dumps three TCP packets:
test-100# tech dumptcp 0 count 3tcpdump: listening on eth015:38:05.196657 test-100.nbv.cisco.com.ssh > dhcp-171-71-27-217.cisco.com.2586: P 2316986119:2316986183(64) ack 3375521822 win 16320 (DF) [tos 0x10]15:38:05.197261 dhcp-171-71-27-217.cisco.com.2586 > test-100.nbv.cisco.com.ssh: . ack 64 win 64592 (DF)15:38:05.222923 test-100.nbv.cisco.com.32774 > nbv-dns1.nbv.cisco.com.domain: 27830+ PTR? 217.27.71.171.in-addr.arpa. (44) (DF)9 packets received by filter0 packets dropped by kerneltest-100#Related Commands
show fault
Displays information about system errors.
show tech
Displays information useful for system debugging.
telnet
To create a Telnet connection to another network device, use the telnet command in user EXEC mode.
telnet ip-address [port port-number]
Syntax Description
Command Default
The default Telnet port is 23.
Command Modes
User EXEC.
Command History
Usage Guidelines
If the remote host accepts your connection, you are prompted for a username and password to log into the system, if one is required.
If the remote host supports SSH, use the ssh command to create a secure connection to the remote host.
Examples
The following example creates a Telnet connection with the host 192.0.2.10 using the root user account:
test-100# telnet 192.0.2.10Trying 192.0.2.10...Connected to 192.0.2.10.Escape character is '^]'.User Access VerificationUsername: rootPassword:remotehost>Related Commands
traceroute
To determine the number of router hops between a Director and a remote system, use the traceroute command in user EXEC mode.
traceroute ip-address
Syntax Description
Command Default
No default behavior or values.
Command Modes
User EXEC.
Command History
Usage Guidelines
The traceroute command sends three ICMP packets to each hop along the route, and displays the number of milliseconds it took to get a response. The output lists each hop. An asterisk appears if the next hop cannot be determined or if no response is received.
Press Ctrl+C to stop traceroute if it does not end normally.
Examples
The following example traces a route to host 192.0.2.10:
test-100# traceroute 192.0.2.10traceroute to 192.0.2.10 (192.0.2.10), 30 hops max, 38 byte packets1 192.0.2.27 0.435 ms 0.170 ms 0.157 ms2 192.0.2.101 0.478 ms 0.312 ms 0.296 ms3 192.0.2.10 0.527 ms 0.083 ms 0.084 mstest-100#Related Commands
user password
To mange passwords for the user accounts, use the user password command in global configuration mode. To disable the password for the admin or macrouser user accounts, use the no form of this command.
user password {admin | macrouser}
no user password {admin | macrouser}
Syntax Description
admin | macrouser
Sets the password for the admin or macrouser account. Choose either admin or macrouser.
Command Default
No default behavior or values.
Command Modes
Global configuration.
Command History
Usage Guidelines
The admin account is the default superuser account. The password you configure controls the password for SSH, console sessions, and for logging into the GUI.
After entering the user password command, you are prompted for the password and asked to enter it again to confirm it. As you are typing, the password does not appear on your screen, but the system accepts the typed input.
If the system judges the password to be inadequately secure, it notifies you with a BAD PASSWORD message. However, you can ignore the prompt and reenter the password to confirm it.
If you want to choose a different password after receiving the BAD PASSWORD message, you can press Enter without reentering the password at the retry password prompt, and you are prompted for a new password.
Examples
The following example changes the admin password:
test-100# configEnter configuration commands, one per line. End with CNTL/Z.test-100(config)# user password adminChanging password for user admin.New password:BAD PASSWORD: it is based on a dictionary wordRetype new password:passwd: all authentication tokens updated successfully.test-100(config)#
Note
Related Commands
vha connection
To create an SSL connection with the VFrame host agent, use the vha command in global configuration mode. To disable an SSL connection with the VFrame host agent, use the no form of this command.
vha connection ssl
no vha connection ssl
Syntax Description
Command Default
The VFrame host agent automatically connects to port 3010, the SSL port.
Command Modes
Global configuration (config)
Command History
Usage Guidelines
Do not create an SSL connection between the VFrame host agent and the model test server.
If the VFrame host agent fails to connect to port 3010, it automatically connects to port 3000, the TCP port.
You do not need to create a certificate for SSL. VFrame generates a self-signed certificate for SSL.
Examples
The following example creates an SSL connection between the Director and the VFrame host agent:
test-100# configEnter configuration commands, one per line. End with CNTL/Z.test-100(config)# vha connection ssltest-100(config)#Related Commands
show system
Displays information about system services and configurations.
ssh
Creates an SSH connection with another device.
