-
Cisco VFrame Data Center 1.1 Administration Guide
-
Preface
-
Getting Started with VFrame Data Center
-
Managing Roles and Local Users
-
Setting Up the Physical Network
-
Managing Device Credentials
-
Configuring DHCP for VFrame
-
Discovering Devices
-
Managing Devices
-
Managing Server Images
-
Managing Resource Pools
-
Managing Virtual Contexts
-
Designing Templates
-
Managing Macros and Variable Group Types from the Library Manager
-
Designing Service Networks
-
Operating Service Networks
-
Managing Faults
-
Viewing Reports
-
Maintaining Devices
-
Managing the VFrame System
-
System Actions and Default Variables
-
Index
-
Table Of Contents
Backing Up and Recovering the VFrame Database
Understanding How VFrame Creates Automatic Backups
Recovering the Most Recent Automatic Backup
Creating Your Own Database Backup
Recovering Your Own Database Backup
Configuring SMTP Credentials for E-Mail Notifications
Configuring Syslog Server Notifications
Migrating the Golden Image Repository
Managing High Availability (Redundancy)
Understanding VFrame High Availability
Changing the Active Status of a System
Using the Command Line on the Server
Command Processing Environment
Server Administration Reference
SMTP Tab, System Settings Dialog Box
Syslog Tab, System Settings Dialog Box
VFrame Routing Table, System Settings Dialog Box
Device Manager Tab, System Settings Dialog Box
Device Manager Parameter Variables
Managing the VFrame System
These topics describe various management tasks related to maintaining the VFrame system, as opposed to managing a server farm.
•
Backing Up and Recovering the VFrame Database
•
•
•
•
Backing Up and Recovering the VFrame Database
Data backup is critical to reducing the risk of unexpected outages. These topics describe VFrame backup and recovery:
•
•
•
•
Understanding How VFrame Creates Automatic Backups
VFrame automatically backs up its database at regular intervals. You also can create your own backups whenever you want to take a snapshot of your data, in case you need to recover the database to the version that existed at that time.
There are two types of automatic backup:
•
•
Because VFrame replaces these files at least every hour, you should not rely on them for maintaining your system. Periodically create your own backup files at critical milestones to ensure that you can recover your system to a state that is meaningful to your organization.
Recovering the Most Recent Automatic Backup
If you corrupt your database and notice the problem right away, you can recover the most recent automatic backup file to restore your database. However, be aware that the automatic backup file mentioned in this procedure has at most a one-hour lifetime before it is replaced with a new backup file.
Before You Begin
Users should not be logged into VFrame. The recovery process stops system services, so users will be disconnected during the recovery.
Procedure
Step 1
Step 2
vframe# configEnter configuration commands, one per line. End with CNTL/Z.vframe(config)# no redundancy enableStep 3
Step 4
vframe# db restore /nwdisks/1/backupBackup file will be retrieved from /nwdisks/1Stopping 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 servicesIf you do not include the path, the backup file is retrieved from the default location /nwdisks/2.
Step 5
vframe# configEnter configuration commands, one per line. End with CNTL/Z.vframe(config)# redundancy enableRelated Topics
•
•
•
Creating Your Own Database Backup
To guard against accidental data corruption (through user error) or general system problems, you should periodically back up the database. Create backups at significant milestones so that you can recover your system to a known and desirable configuration.
Procedure
Step 1
Step 2
vframe# db backup sample.backupBackup file will be saved in /nwdisks/2waiting for physical backup to completePhysical backup is completed.Save backup fileThe backup location /nwdisks/2 is the default location. You can include a path in the filename to back up the file to a different location. However, the directory must either reside in the location identified as the backup location during initial system configuration or be mounted on it.
Related Topics
•
•
Recovering Your Own Database Backup
If you find that you need to return to a previous version of the database, due to data corruption or other system problems, recover a previous backup file that you created. If you need to try to recover the most recent automatic backup, see Recovering the Most Recent Automatic Backup.
Before You Begin
Users should not be logged into VFrame. The recovery process stops system services, so users will be disconnected during the recovery.
Procedure
Step 1
Step 2
vframe# configEnter configuration commands, one per line. End with CNTL/Z.vframe(config)# no redundancy enableStep 3
Step 4
vframe# db restore sample.backupBackup file will be retrieved from /nwdisks/2Stopping 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 servicesThe /nwdisks/2 directory is the default location. If you created the backup in a different directory, enter the full path with the filename. For example, to recover a file in the /repository/ directory, enter:
vframe# db restore /repository/sample.backupStep 5
vframe# configEnter configuration commands, one per line. End with CNTL/Z.vframe(config)# redundancy enableRelated Topics
•
•
•
Configuring System Settings
Several system-level settings affect how the product functions. These sections describe how to configure these settings:
•
•
Configuring SMTP Credentials for E-Mail Notifications
You can configure fault notifications for resources or service networks to send e-mail notifications to selected users. Before VFrame can send these notifications, you must configure an e-mail address for the product to use.
Before You Begin
•
•
Procedure
Step 1
Step 2
Step 3
Step 4
Step 5
Configuring Syslog Server Notifications
You can identify a syslog server that should receive messages from VFrame. You can then use your syslog server to monitor the VFrame system.
Before You Begin
Log into the Admin context to change syslog notification settings.
Make sure that the syslog server exists and is configured. VFrame does not configure or manage the syslog server.
Procedure
Step 1
Step 2
Step 3
Step 4
Step 5
Configuring Static Routes
VFrame must have a route to any address range it manages, that is, any address range you include in IP Address Range resource pools. If the default gateway you configure for VFrame has routes to all of these address ranges, you do not need to configure any static routes. Configure static routes only if VFrame is unable to route packets to a managed network.
To configure static routes, you can use this procedure, or you can use the ip route command in a VFrame CLI session, as described in ip. There is no difference between the methods.
Before You Begin
Log into the Admin context to change the routing table.
Procedure
Step 1
Step 2
Step 3
a.
b.
•
•
•
•
c.
Step 4
Related Topics
Configuring Device Managers
When you view devices on the Resources or Pools tabs, or on the Acquired Resources tab on the Operations tab, you can right-click on the device to get a shortcut menu. One of the commands on the menu, Device Manager, allows you to start an external program to connect to the device. For example, you could start an SSH client session with a Catalyst switch.
Before you can use the Device Manager command, you must configure the applications that users can select from.
Before You Begin
Log into the Admin context to configure device managers.
Procedure
Step 1
Step 2
Step 3
a.
b.
•
•
•
To select a Windows command-line utility, find it in the Windows/system32 (or equivalent) folder.
•
To add variables to the parameters list, select them in the variables list in the order in which they should appear on the command. The available variables differ depending on the device type, so you must first select a device type before selecting variables. VFrame replaces the variables with the specific properties of the device selected when the Device Manager command is used. You must select only those variables that your device manager is expecting. For an explanation of the available variables, see Device Manager Parameter Variables.
c.
Step 4
Step 5
Step 6
Related Topics
•
Migrating the Golden Image Repository
The golden image repository is the disk space that you use to store golden images. Eventually, you might need to move the repository from its current location to a new one. For example, you might be replacing the physical storage device, or you might be running out of space in the current repository.
To view information about the current location of the repository, and its available space, select Tools > Server Images and click View Repository Setup.
These are your options for the golden image repository:
•
•
•
If you are configuring VFrame for high availability, you must configure the golden image repository on a LUN or volume.
If you will be storing a large number of golden images, it is also best to use a LUN or volume because of the relatively more limited space on the VFrame Data Center Director. We recommend that you do not use the repository's volume or LUN for other purposes. Instead, devote its use to the repository.
Because golden image repository configuration requires the shutdown of some services, it is a disruptive process. It is best to choose a location with sufficient storage during initial system configuration.
Note
Before You Begin
You cannot migrate the repository to a volume or LUN that is currently managed in VFrame.
Create or locate a location for the repository, and gather the information you will need to identify the location. You will be asked for this information:
•
–
–
–
•
–
–
Procedure
Step 1
Step 2
vframehost# configEnter configuration commands, one per line. End with CNTL/Z.Step 3
vframehost(config)# gir migrateWarning: Migrating Golden Image Repository will requireshutting down all system services and migrationof golden images might take a long time.Would you like to migrate the GIR now (yes/no) [no]? yesStep 4
Enter the new GIR location type: Local, NFS or SAN (L/N/S)? NEnter the Filer IP: 10.100.30.55Enter the Volume Name: girvolMigrating to a NetApp filer.Please enter a username for 10.100.30.55: rootPlease enter a password for 10.100.30.55:Step 5
Migrating from a NetApp filer.Please enter a username for 10.100.30.66: rootPlease enter a password for 10.100.30.66:Step 6
Would you like to cleanup the old GIR after migration is complete? (yes/no): yesStep 7
After shutting down services, VFrame copies the golden images to the new location, deletes the contents of the old repository if you elected to do so, and restarts services:
Java and image management need to be down to run migration.Is it ok to shut down these 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 9499368 KB from /gir to /mnt/girtemp... copy is 100% completeAttempting to unmount the old GIR.Removing 9499368 KB from /gir/vfdc_gir... remove is 100% completeUnmount successful.Remounting new GIR to permanent location.Remount successful.Starting VCC services.Updating database and fstab to reflect new GIR.GIR migration is complete.vframehost(config)#To verify the repository configuration, you can enter the show gir command in User EXEC mode, or the do show gir command in configure mode.
Step 8
Related Topics
•
•
Managing High Availability (Redundancy)
You can configure two VFrame Data Center Directors as a redundant pair. This high-availability configuration ensures that there is a backup system available in case the primary system fails. These sections help you understand and manage redundancy. Redundancy must be configured during initial system setup, as explained in the Cisco VFrame Data Center 1.1 Installation and Configuration Guide. These sections give you further information about redundancy and how to manage it in a functioning system.
•
•
Understanding VFrame High Availability
You can configure two VFrame Data Center Directors as peers in a single redundant pair. In a redundant pair, only one member of the pair is the active system; the other member is the standby. If the active peer stops functioning, the standby takes over for it, so that the time the VFrame system is down is minimized. This provides a high-availability setup required by many data centers.
When configured as a redundant pair, any update to the VFrame database requires a concurrent update to the database of the standby system. This maintains consistent databases and minimizes data loss caused by system problems.
During initial system configuration, the first system that you configure becomes the active peer. If the active system reboots, shuts down, or otherwise becomes unavailable, the standby system takes over and becomes the active system. It remains active unless it becomes unavailable for some reason. No member of the pair is the "default" active member. If you reboot the systems, whichever finishes booting first becomes the active member (in case the both finish rebooting at the same time, the system with the higher IP address becomes the active member). You can, however, force a system to become the active or standby peer if you need to for any reason (see Changing the Active Status of a System).
From a user's perspective, there is one difference between a system running as a redundant pair and one running standalone. Instead of logging into the system using the system's management interface IP address, users log in using the virtual IP (VIP) address of the management interface. The VIP address is the same for both members of the redundant pair so user connections are completed no matter which device is active. If you need to use the CLI, however, you need to log into the management interface IP address to ensure that you are configuring the expected system.
If you need to reboot or shut down the active member of a redundant pair, first use the redundancy resign command to give up active status. Explicit resignation prevents a delay in the standby member taking over active status.
Changing the Active Status of a System
In a redundant pair, one peer is active, the other is standby. You can force the active/standby status to change if necessary. For example, you might want to change the active peer to the standby peer to do system maintenance or to recover the database.
Procedure
Step 1
If you are not sure about the status of the system, use the show redundancy status command to determine if the system is the active or the standby system.
Step 2
vframehost# configEnter configuration commands, one per line. End with CNTL/Z.Step 3
•
vframehost(config)# redundancy resign•
vframehost(config)# redundancy coupRelated Topics
•
Using the Command Line on the Server
You can perform several server management tasks from an SSH or console session. These sections describe how to use the command line and the various commands that you can enter when logged into the VFrame server using an SSH client:
•
Command Processing Environment
When you connect to the VFrame server using SSH or the console port, you are logging into the Admin context. You must log in using the admin user account; no other account can log into the server.
VFrame does not evaluate role permissions for the admin user when this user is logged into a command-line session. The admin user is permitted to use any command.
In a command-line session, the commands you can enter depend on the mode in which you are operating. You can enter these command modes:
•
•
•
When you are in one of the configure modes, you can execute User EXEC commands using the do command. For example, to enter the show version command in configure mode, you would enter do show version.
Getting Help about Commands
You can get help information about commands when you are logged into the server through the console or an SSH session.
•
•
–
–
If you enter part of a command and press the Tab key, you will see the same results as if you typed ? in the last space. However, if the characters you entered only match one string, VFrame automatically completes the command or parameter for you.
Command Reference
The following sections describe the commands that you can use on the VFrame command line.
clear
Use the clear command to reset the system to the factory defaults. Resetting the system erases all configuration information. Use this command with care.
clear setup
Syntax Description
Defaults
None.
Command Modes
User EXEC mode.
Usage Notes
The system reboots after resetting the configuration.
Examples
This is an example of using the clear command to reset the system configuration:
vframe# 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!Related Commands
config
Use the config command to enter configure mode so that you can enter commands that change the system configuration.
config [terminal]
Syntax Description
terminal
This optional keyword does not affect the command actions. Entering config or config terminal results in the same action.
Defaults
None.
Command Modes
User EXEC mode.
Usage Notes
None.
Examples
This is an example of issuing the config command to enter configure mode:
vframehost# configEnter configuration commands, one per line. End with CNTL/Z.vframehost(config)#Related Commands
Enter ? in configure mode for a list of available commands.
copy
Use the copy command to copy certain types of files to the VFrame Data Center Director or to copy them from the system to a remote FTP or SCP server.
copy {
backup setup |
logs url {scp:// | ftp://} server_path_only |
setup {backup | url {scp:// | ftp://} path_and_filename} |
url {cdrom | protocol://server_path_filename} {install | license | setup}
}Syntax Description
Defaults
None.
Command Modes
User EXEC mode.
Usage Notes
Use the copy command to copy license files or update packages or patches to the system so that you can install them. Typically, you will obtain these licenses or packages from Cisco.com. You must set up a server running a supported protocol, and put the license or package on the server in a directory that will result in a total URL length of 80 characters or less, including the protocol part of the URL (for example, http://).
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.
Examples
This is an example of copying a patch to the installation staging area from an HTTP server that does not require user authentication. When prompted for a username, press Enter without entering a name.
vframehost# 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]vframehost#This is an example of recovering a local backup of the system setup file and reinitializing the database. Not all output is shown.
vframehost# copy backup setupRe-initialize the database. Warning erases and initializes all data in the database: (yes/no) [no]? yesStart database sent mts message to system managerRe-initializing the database... This will take some time...Related Commands
•
db
Use the db command to back up and recover the VFrame database.
db {backup filename | restore filename}
Syntax Description
Defaults
The default path is /nwdisks/2.
Command Modes
User EXEC mode.
Usage Notes
Before using this command, read the usage information in Backing Up and Recovering the VFrame Database. Be sure to disable redundancy if you are using a redundant setup before you restore a database. Also ensure that no one is logged into the system.
Examples
This is an example of backing up the database to a file named Jul2006.backup in the /workspace directory:
vframehost# db backup /workspace/Jul2006.backupwaiting for physical backup to completePhysical backup is completed.Save backup filevframehost#This is an example of restoring the backup file named Jul2006.backup:
vframe# 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 servicesRelated Commands
debug
Use the debug command to display debugging or system logs in real time.
debug services {
aaad |
daemons |
database |
dbmnt |
dhcpwd |
hdrh |
hsrp |
imagemgmt |
syscfg |
sysmgr |
sysmnt |
system |
trend |
vccjava |
vccvha |
vframe
}Syntax Description
Defaults
None.
Command Modes
User EXEC mode.
Usage Notes
Press Ctrl+C to end the log display.
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.
Examples
This is an example of displaying the AAA debugging log:
vframehost# 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()Related Commands
del
Use the del command to delete a package from the installation staging area.
del install staged package_name
Syntax Description
install staged package_name
Delete the specified package from the installation staging area. Use the show install staged command to determine the package name.
Defaults
None.
Command Modes
User EXEC mode.
Usage Notes
Deleting a package from the installation staging area does not uninstall the package. You cannot uninstall a package that you installed using the install command.
Examples
This is an example of deleting the VFRAMEDebug package from the staging area:
vframehost# del install staged VFRAMEDebugvframehost#Related Commands
•
do
Use the do command to run a User EXEC mode command while in one of the configure modes.
do User_EXEC_command
Syntax Description
Command Modes
Configure mode.
Configure interface mode.
Examples
This is an example of entering the ping command while in configure mode:
vframehost# configEnter configuration commands, one per line. End with CNTL/Z.vframehost(config)# do ping 10.100.10.12Related Commands
Enter do ? for a list of available commands.
end
Use the end command to leave either of the configure command modes and return to User EXEC mode.
end
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
Configure mode.
Configure interface mode.
Usage Notes
The difference between the end command and the exit command is that the end command always returns you to User EXEC mode (even if you are in configure interface mode) whereas the exit command takes you to the previous mode (in configure interface mode, it returns you to configure mode).
Examples
This is an example of entering the end command to leave configure mode:
vframehost# configEnter configuration commands, one per line. End with CNTL/Z.vframehost(config)# endvframehost#Related Commands
•
exit
Use the exit command to end the command mode session in which you are operating. If you use this command in User EXEC mode, it logs you out of the system.
exit
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
User EXEC mode.
Configure mode.
Configure interface mode.
Usage Notes
The difference between the end command and the exit command is that the end command always returns you to User EXEC mode (even if you are in configure interface mode) whereas the exit command takes you to the previous mode (in configure interface mode, it returns you to configure mode).
Examples
This is an example of using the exit command to leave configure mode:
vframehost# configEnter configuration commands, one per line. End with CNTL/Z.vframehost(config)# exitvframehost#Related Commands
•
gir
Use the gir command to configure the golden image repository. This command does not back up the repository. Instead, the command moves or remounts the repository.
gir {migrate | setup-ha-secondary | remount}
Syntax Description
Defaults
The default golden image repository location is on the VFrame Data Center Director.
Command Modes
Configure mode.
Usage Notes
The gir command leads you through golden image repository configuration. You must know the location information of the storage location you select for the repository. If you are migrating an existing repository, you must also know the login information for the existing location. For detailed information, see Migrating the Golden Image Repository.
Examples
For an example, see Migrating the Golden Image Repository.
Related Commands
install
Use the install command to install software upgrades or other patches.
install {
abort |
update filename [force]
}Syntax Description
Defaults
The install command does not install a package if it determines that the package is already installed.
Command Modes
User EXEC mode.
Usage Notes
Before you can install an update or patch, you must copy it into the staging area using the copy command. This is the typical sequence of commands:
•
•
•
•
You cannot uninstall a patch.
If you reinstall the entire system software, for example, by recovering the system, any packages in the staging area are erased.
Examples
This is an example of installing a patch called VFRAMEDebug:
vframehost# install update VFRAMEDebugPROGRESS: extraction finished Fri Jul 28 11:04:59 PDT 2006PROGRESS: Start upgrade install scriptPROGRESS: Install completed OKvframehost#Related Commands
•
•
interface
Use the interface command to enter configure interface mode for the specified interface.
interface eth int_number
Syntax Description
Defaults
None.
Command Modes
Configure mode.
Usage Notes
Most interface configuration, such as specifying the IP address and subnet mask, is done using the setup command.
Examples
This is an example of entering the configure interface mode for the eth2 interface (typically used as the high-availability interface):
vframehost# configEnter configuration commands, one per line. End with CNTL/Z.vframehost(config)# interface eth 2vframehost(config-eth)#Related Commands
•
ip
Use the ip command to configure IP-related settings such as the DNS configuration, static routes, and firewall settings.
[no] ip {
default-gateway IP_address |
dns {domain name | server IP_address} |
firewall eth number {management | data | open} |
firewall {start | stop} |
route Network_IP Netmask Gateway_IP [metric num]
}Syntax Description
Defaults
Firewalls are not configured on any interface.
Command Modes
Configure mode.
Usage Notes
These are the firewall settings. Use the show ip iptables command to display more detailed information.
•
•
–
–
–
–
•
–
–
–
–
–
–
•
–
–
•
Examples
This is an example of adding a DNS server:
vframehost# configEnter configuration commands, one per line. End with CNTL/Z.vframehost(config)# ip dns server 192.168.1.4vframehost(config)#This is an example of configuring the eth0 interface to use the management interface firewall and starting the firewall:
vframehost# configEnter configuration commands, one per line. End with CNTL/Z.vframehost(config)# ip firewall eth 0 managementvframehost(config)# ip firewall startvframehost(config)#Related Commands
license
Use the license command to install a VFrame product license file.
license install filename
Syntax Description
install filename
Install the license with the specified filename. Before you use this command, use the copy command to download the license file to the VFrame Data Center Director.
Defaults
None.
Command Modes
Configure mode.
Usage Notes
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
This is an example of installing a license file:
vframehost# configEnter configuration commands, one per line. End with CNTL/Z.vframehost(config)# license install vfdc_20070531.txtSuccessfully installed license file!vframehost(config)#Related Commands
•
ntp
Use the ntp command to configure Network Time Protocol (NTP) settings, which control the system clock.
[no] ntp {
peer name [prefer] |
server name [prefer]
}Syntax Description
Defaults
NTP is not used.
Command Modes
Configure mode.
Usage Notes
If you remove all NTP peers and servers, NTP is not used as the time protocol. The system clock is kept locally.
Examples
This is an example of specifying an NTP peer:
vframehost# configEnter configuration commands, one per line. End with CNTL/Z.vframehost(config)# ntp peer 10.100.40.16vframehost(config)#This is an example of specifying an NTP server and identifying it as the preferred server:
vframehost# configEnter configuration commands, one per line. End with CNTL/Z.vframehost(config)# ntp server 10.100.40.17 prefervframehost(config)#Related Commands
ping
Use the ping command to test whether a remote system can receive ICMP packets. The command sends ICMP echo requests and waits for ICMP echo replies. A successful ping indicates that the remote system is alive and responsive.
ping IP_address
Syntax Description
Defaults
None.
Command Modes
User EXEC mode.
Usage Notes
The ping command sends four echo requests. Press Ctrl+C to end the ping before the four requests are finished.
Examples
This is an example of pinging the remote system 10.100.30.50:
vframehost# ping 10.100.30.50PING 10.100.30.50 (10.100.30.50) 56(84) bytes of data.From 10.100.30.1: icmp_seq=0 Redirect Host (New nexthop: 10.100.30.50)64 bytes from 10.100.30.50: icmp_seq=0 ttl=64 time=0.642 ms64 bytes from 10.100.30.50: icmp_seq=1 ttl=64 time=0.070 ms64 bytes from 10.100.30.50: icmp_seq=2 ttl=64 time=0.065 ms64 bytes from 10.100.30.50: icmp_seq=3 ttl=64 time=0.069 ms--- 10.100.30.50 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 2vframehost#Related Commands
reboot
Use the reboot command to reboot the VFrame Data Center Director. Rebooting shuts down the system, and then restarts it. In comparison, the shutdown command shuts down the system without restarting it.
reboot
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
User EXEC mode.
Usage Notes
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. Enter y to continue, or enter n to stop the command and not reboot the system.
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
This is an example of rebooting the system:
vframehost# 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!vframehost#Related Commands
redundancy
Use the redundancy command to configure the high-availability features of VFrame. These settings determine how the members of a redundant pair function together. For more information on high availability, see Managing High Availability (Redundancy).
redundancy {
coup |
enable |
hellotime seconds |
holdtime seconds |
peer hostname DB_name HA_IP_address Server_Comm_IP_Address |
resign
}no redundancy {
enable |
hellotime |
holdtime
}Syntax Description
Defaults
Redundancy is disabled. Hello time is 10 seconds. Hold time is 20 seconds.
Command Modes
Configure mode.
Usage Notes
You must configure high-availability parameters using the setup command for any of the redundancy commands to work. You also must install and configure the peer correctly. See the Cisco VFrame Data Center 1.1 Installation and Configuration Guide for information on initial system configuration.
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 hdrh service is the high-availability data replication helper; the hsrp service is the Hot Standby Router Protocol.)
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.
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.
Examples
This is an example of identifying a peer and enabling redundancy:
vframehost# configEnter configuration commands, one per line. End with CNTL/Z.vframehost(config)# redundancy peer vframepeer.example.com peerdb 10.100.40.25 10.100.30.15This is an example of resigning active status to the peer:
vframehost# configEnter configuration commands, one per line. End with CNTL/Z.vframehost(config)# redundancy resignThis is an example of taking active status away from the peer:
vframehost# configEnter configuration commands, one per line. End with CNTL/Z.vframehost(config)# redundancy coupRelated Commands
•
setup
Use the setup command to perform the initial system configuration. Normally, you run this command only once.
setup
Syntax Description
This command has no arguments or keywords.
Defaults
If you rerun this command, default settings are based on your previous inputs.
Command Modes
User EXEC mode.
Usage Notes
The setup command leads you through system configuration, asking for various inputs based on your previous inputs. 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.
For detailed information about using this command, see the Cisco VFrame Data Center 1.1 Installation and Configuration Guide.
Examples
This is an example of running the setup command. Password input is displayed, although passwords are not displayed in the actual command interaction. In this example, <enter> indicates that you press the Enter key without entering any text.
vframehost# setupSetup is used to initialize the basic system parametersneeded for VFrame to start running.Entering System Configuration wizardUse ctrl-c to abort configuration dialog at any prompt.Current/default settings are in square brackets '[]'.Hit enter to choose current/default value.Would you like to configure admin password (yes/no) [no]? yesChanging password for user admin.New password: adminBAD PASSWORD: it is too shortRetype new password: adminpasswd: all authentication tokens updated successfully.Would you like to configure password for user 'macrouser' (yes/no) [no]? yesChanging password for user macrouser.New password: macrouserRetype new password: macrouserpasswd: all authentication tokens updated successfully.Enter hostname [localhost.localdomain]: vframehost.example.comEnter Management (Northbound) Interface: eth [0]: 0Enter eth0 IP address []: 10.100.20.10Enter eth0 netmask []: 255.255.255.0Enter Server Communication Interface: eth [1]: 1Enter eth1 IP address []: 10.100.30.10Enter eth1 netmask []: 255.255.255.0Enter default-gateway IP address []: 10.100.20.1Configure DNS Server (yes/no) [yes]? <enter>Enter the DNS Server IP address []: 10.100.20.55Please enter DB backup file storage type 0:local, 1:nfs, 2:san [0] 0Please enter a unique Database Server name for this systemconsisting of (at most 32) alphanumeric chars [vccids]: <enter>Manage storage arrays through storage array macros?Answering "no" will require LUN zoning on MDS withstorage array security turned off. (yes/no) [yes]? yesWould you like to configure HA interface (yes/no) [no]? <enter>You have entered the following configuration:Hostname : vframe.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.20.55VHA connection over SSL: noStorage mode : Storage Template ArrayDB Server Name : vccidsDB backup storage : localHA Mode : standaloneWould you like to apply this configuration (yes/no) [yes] ? <enter>Stopping servicesWaiting for 12 out of 14 processes to shutdownWaiting for 10 out of 14 processes to shutdownWaiting for 8 out of 14 processes to shutdownWaiting for 6 out of 14 processes to shutdownWaiting for 4 out of 14 processes to shutdownWaiting for 2 out of 14 processes to shutdownWaiting for 0 out of 14 processes to shutdownWait for IDS to go downWait for vcc_java to go down................Starting servicesvframehost#Related Commands
show cdp
Use the show CDP command to display information about the system's Cisco Discovery Protocol (CDP) settings and neighbors.
show cdp {
all |
entry {all | name device_name} |
global |
neighbors [detail]
}Syntax Description
Defaults
None.
Command Modes
User EXEC mode.
Usage Notes
See the Cisco IOS Software documentation for detailed information about CDP, including how to configure and manage it in your network.
Examples
This is an example of displaying global CDP configuration information:
vframehost# show cdp globalGlobal CDP information:CDP enabled globallySending CDP packets every 60 secondsSending a holdtime value of 180 secondsSending CDPv2 advertisements is enabledvframehost#This is an example of displaying the list of CDP neighbors:
vframehost# 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/37vframehost#Related Commands
show clock
Use the show clock command to view the current date and time as defined on the system.
show clock
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
User EXEC mode.
Usage Notes
None.
Examples
This is an example of displaying the system clock:
vframehost# show clockFri Jul 28 15:30:32 PDT 2006vframehost#Related Commands
•
show fault
Use the show fault command to display information about VFrame system fault state machines.
show fault {history | status}
Syntax Description
history
Display historical information about VFrame system fault alarms. If there have not been any alarms, no output is shown.
status
Display the current status of all VFrame system fault alarms.
Defaults
None.
Command Modes
User EXEC mode.
Usage Notes
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 (see SMTP Tab, System Settings Dialog Box).
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 state machines:
•
To resolve the fault:
–
–
–
–
•
To resolve the problem, use the show system status command to determine if any database-related services are down. If they are, use the tech service reset command to restart the service. If this does not solve the problem, reboot the system.
•
To resolve the problem, check the system on which the database backup is running. If the system is functioning correctly, ensure that there is network access between VFrame and the backup system. If this does not solve the problem, reboot the VFrame system.
•
To resolve the problem, use the show system status command to determine which services are down, then use the tech service reset command to restart the service. If this does not solve the problem, reboot the system.
•
To resolve the problem, check the system on which the GIR is running. If the system is functioning correctly, ensure that there is network access between VFrame and the GIR system. If this does not solve the problem, reboot the VFrame system.
•
Examples
This is an example of displaying the current status of VFrame system fault alarms:
vframehost# show fault statusSystem Fault State=====================================HA Peer Unreachable CLEARDB Down CLEARDB Backup Down CLEARVFDC service down CLEARGIR Unreachable CLEARVFDC in unlicensed state CLEARvframehost#Related Commands
•
•
show gir
Use the show gir command to display information about the golden image repository setup.
show gir
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
User EXEC mode.
Usage Notes
None.
Examples
This is an example of displaying golden image repository setup information:
vframehost(config)# show girCurrent GIR Information: NFS - Filer: 10.100.30.55 Volume: girvolSize Total (MB): 16384Size Used (MB): 10609Inodes Total: 553413Inodes Used: 198793vframehost(config)#Related Commands
•
show hardware
Use the show hardware command to display information about the system's hardware, including processor and interface details such as MAC addresses.
show hardware
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
User EXEC mode.
Usage Notes
None.
Examples
This is an example of displaying hardware information:
vframehost# 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 MBytesRelated Commands
show install
Use the show install command to display information about packages available in the installation staging area or a history of packages installed on the system.
show install {
history [detail [name package_name] | short] |
staged [detail [name package_name]]
}Syntax Description
Defaults
The default is to display the short version of the history or installation staging area information.
Command Modes
User EXEC mode.
Usage Notes
Use the show install staged command after you copy a package into the staging area to determine the exact name you will need to use on the install command.
Examples
This is an example of displaying the list of packages available in the installation staging area:
vframehost# show install stagedPatches waiting in staging areaName Version Type Summary----------------- -------- ------- -------------------VFRAMEDebug 1.1 update VFRAME Debug patchvframehost#Related Commands
•
•
show interface
Use the show interface command to display configuration information about the system's Ethernet interfaces.
show interface [eth number]
Syntax Description
eth number
(Optional.) The specific Ethernet interface about which you want to display information. The number can be 0, 1, or 2.
Defaults
Information about all interfaces is shown.
Command Modes
User EXEC mode.
Usage Notes
None.
Examples
This is an example of displaying information about the eth0 interface:
vframehost# 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 dropsvframehost#Related Commands
show ip
Use the show ip command to display information about IP-related settings such as static route tables and DNS and firewall settings.
show ip {
dns |
firewall [eth number] |
iptables |
route
}Syntax Description
Defaults
None.
Command Modes
User EXEC mode.
Usage Notes
For information on how to configure the settings displayed by this command, and on the various firewall settings, see the ip command.
Examples
This is an example of displaying the DNS configuration:
vframehost# show ip dnssearch example.comdomain example.comnameserver 192.168.1.3vframehost#This is an example of displaying the firewall configuration.
vframehost# show ip firewallfirewall eth0 : managementfirewall eth1 : datafirewall eth2 : openvframehost#Related Commands
•
show license
Use the show license command to display information about the VFrame product license.
show license {
file [all | name filename] |
hostid |
status
}Syntax Description
Defaults
None.
Command Modes
User EXEC mode.
Usage Notes
For information on installing a product license, see license.
Examples
This is an example of showing the system's host ID:
vframehost# show license hostid0014c2c094e7vframehost#This is an example of displaying the current license information for the system:
vframehost# show license statusLicensed Feature License count--------------------------------------------------LicVFrameAccessSwitchPortsMax 100LicVFrameHA N/ARelated Commands
•
show logging
Use the show logging command to display debugging or system logs.
show logging {
aaad |
daemons |
database |
dbmnt |
dhcpwd |
hdrh |
hsrp |
imagemgmt |
syscfg |
sysmgr |
sysmnt |
system |
trend |
vccjava |
vccvha |
vframe
}Syntax Description
Defaults
None.
Command Modes
User EXEC mode.
Usage Notes
Enter q and press Enter if you want to stop the log display before reaching the end of the log.
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.
Examples
This is an example of showing the AAA debugging log:
vframehost# show logging 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()vframehost#Related Commands
show logins
Use the show logins command to display information about when users logged into the VFrame Data Center Director's command-line interface.
show logins cli [count number]
Syntax Description
cli
Show login information for the command-line interface.
count number
(Optional.) Display information on this number of the most recent user logins. The default is 10.
Defaults
Display information on the 10 most recent user logins.
Command Modes
User EXEC mode.
Usage Notes
The login information table displays the following information (from left to right):
•
•
•
•
If you want to view user login information for the product's graphical user interface (GUI), use the user audit report from the GUI.
Examples
This is an example of showing login information for the VFrame Data Center Director:
vframehost# 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.5vframehost#Related Commands
show ntp
Use the show ntp command to display the information about the network time protocol (NTP) setup for the system. NTP controls the system clock.
show ntp {config | status | trace}
Syntax Description
config
Show the list of NTP servers.
status
Show the current NTP status, including information on clock accuracy.
trace
Show a trace of NTP server relationships.
Defaults
None.
Command Modes
User EXEC mode.
Usage Notes
You must already have added NTP servers to the configuration to see any output.
Examples
This is an example of displaying the NTP configuration:
vframehost# show ntp configntp server 10.68.10.150 preferntp server 10.68.10.151vframehost#Related Commands
•
show process
Use the show process command to display information about the processes running on the system. This information might be helpful during system debugging.
show process
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
User EXEC mode.
Usage Notes
None.
Examples
This is an example of displaying process information. The output is not shown.
vframehost# show processRelated Commands
show redundancy
Use the show redundancy command to display information about the high-availability redundancy setup for the system.
show redundancy {config | status}
Syntax Description
config
Display information about the redundancy configuration.
status
Display information about the status of the redundant pair.
Defaults
None.
Command Modes
User EXEC mode.
Usage Notes
None.
Examples
This is an example of displaying information about the redundancy configuration:
vframehost# 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: vframepeerThis is an example of displaying information about redundancy status:
vframehost# show redundancy statusLocal PeerHA state: ACTIVE_READY STANDBY_READYDB state: IDS_UP IDS_UPDB mode: Primary SecondaryDB hdr status: in syncIn this example, the DB hdr status indicates whether the database in the peers are synchronized (they contain the same information). It also indicates which system is active and which is standby.
Related Commands
show system
Use the show system command to display information about the status of system services and configurations.
show system {services | setup}
Syntax Description
services
Display information about the status of system services.
setup
Display information about the system configuration.
Defaults
None.
Command Modes
User EXEC mode.
Usage Notes
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 shown as 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
This is an example of displaying the status of system services:
vframehost# 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 Startedvframehost#This is an example of displaying information about the system configuration:
vframehost# 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 : standalonevframehost#Related Commands
•
•
show tech
Use the show tech command to display technical information that might be useful for system debugging.
show tech
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
User EXEC mode.
Usage Notes
The show tech command displays this information:
•
•
•
•
•
•
•
•
•
•
•
Examples
This is an example of entering the show tech command. Output is not shown.
vframehost# show techRelated Commands
•
show version
Use the show version command to display information about the system software version and how long the system has been running.
show version
Syntax Description
This command has no arguments or keywords.
Defaults
None.
Command Modes
User EXEC mode.
Usage Notes
None.
Examples
This is an example of displaying version information:
vframehost# 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.comvframehost#Related Commands
shutdown
Use the shutdown command to disable, or shut down, the system or an interface. The system shuts down if you enter the command in User EXEC mode. If you are in configure interface mode, the command shuts down the interface you are configuring, which prevents communication through the interface.
The no shutdown command is available only in configure interface mode. It reenables the interface, allowing communication to resume.
shutdown
no shutdown
Syntax Description
This command has no arguments or keywords.
Defaults
Interfaces are not shut down if you configure their IP addresses with the setup command.
Command Modes
User EXEC mode.
Configure interface mode.
Usage Notes
If you shut down the system, reboot it using the iLO interface (lights-out management). 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 redundant pair, and the system is the active member, use the redundancy resign command before the shutdown command. Explicit resignation allows the standby system to take over active status without delay, making the transition smoother than if you only shut down the system.
Examples
This is an example of entering configure interface mode for the eth2 interface, shutting down the interface, and then reenabling it:
vframehost# configEnter configuration commands, one per line. End with CNTL/Z.vframehost(config)# interface eth 2vframehost(config-eth)# shutdownvframehost(config-eth)# no shutdownvframehost(config-eth)#Related Commands
•
ssh
Use the ssh command to establish an SSH connection to another device.
ssh IP_Address user_name [port number] [version {1 | 2}]
Syntax Description
Defaults
The default port is 22. The default version is 2.
Command Modes
User EXEC mode.
Usage Notes
The ssh command creates a standard SSH client connection. Once connected, you are operating in the remote host until you quit the SSH connection, typically by entering the quit command.
Examples
This is an example of making an SSH connection to the host 10.100.10.12 using the root user account. When you enter the password, nothing appears on the screen, but the keystrokes are accepted and evaluated by the remote host.
vframehost# ssh 10.100.10.12 rootroot@10.100.10.12's password:Related Commands
tech
Use the tech command to perform advanced system debugging.
tech {
dumptcp interface [count number] |
dumpthreads |
renable |
service reset service_name |
unenable |
verify
}Syntax Description
Defaults
None.
Command Modes
User EXEC mode.
Usage Notes
If you do not specify a count when performing a TCP dump, press Ctrl+C to stop the 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
This is an example of running a TCP dump on interface eth0 to display three TCP packets. Output is not displayed.
vframehost# tech dumptcp 0 count 3Related Commands
telnet
Use the telnet command to establish a Telnet connection to another device.
telnet IP_Address [port number]
Syntax Description
Defaults
Default port is 23.
Command Modes
User EXEC mode.
Usage Notes
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
This is an example of making a Telnet connection to the host 10.100.10.12 using the root user account. When you enter the password, nothing appears on the screen, but the keystrokes are accepted and evaluated by the remote host.
vframehost# telnet 10.100.10.12Trying 10.100.10.12...Connected to 10.100.10.12.Escape character is '^]'.User Access VerificationUsername: rootPassword:remotehost>Related Commands
•
traceroute
Use the traceroute command to determine the router hops between the VFrame system and the remote system. This information can help you diagnose connectivity problems.
traceroute IP_address
Syntax Description
Defaults
None.
Command Modes
User EXEC mode.
Usage Notes
The traceroute command sends three ICMP packets to each hop along the route, and displays the number of milliseconds (ms) it took to get a response. The output lists each hop along the route. An asterisk (*) appears if the next hop cannot be determined or if no response is received. Press Ctrl+C to stop the traceroute if it does not end normally.
Examples
This is an example of tracing the route to host 192.168.2.57:
vframehost# traceroute 192.168.2.57traceroute to 192.168.2.57 (192.168.2.57), 30 hops max, 38 byte packets1 10.100.20.1 0.435 ms 0.170 ms 0.157 ms2 10.100.0.1 0.478 ms 0.312 ms 0.296 ms3 192.168.2.57 0.527 ms 0.083 ms 0.084 msRelated Commands
•
user password
Use the user password command to change the password for the admin or macrouser user account. These passwords are initially configured by the setup command.
user password {admin | macrouser}
Syntax Description
Defaults
None.
Command Modes
Configure mode.
Usage Notes
After entering the user password command, you are prompted for the password, and asked to enter it again to confirm it. 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
This is an example of changing the admin password to one that satisfies the system's rules for adequate passwords. The text shown in this example as the password is not displayed on your screen.
vframehost# configEnter configuration commands, one per line. End with CNTL/Z.vframehost(config)# passwordChanging password for user admin.New password: AW1dfgRetype new password: AW1dfgpasswd: all authentication tokens updated successfully.vframehost(config)#This is an example of changing the admin password to one that does not satisfy the system's rules for adequate passwords. The text shown in this example as the password is not displayed on your screen.
vframehost(config)# passwordChanging password for user admin.New password: adminBAD PASSWORD: it is too shortRetype new password: adminpasswd: all authentication tokens updated successfully.vframehost(config)#Related Commands
vha
Use the vha command to configure settings for the VFrame Host Agent (VHA). The VHA runs on managed servers to communicate status and health information to VFrame.
vha connection ssl
no vha connection ssl
Syntax Description
connection ssl
Use Secure Sockets Layer (SSL) for communications between the VHA and VFrame. Use the no version of the command to change from SSL to TCP communications.
Defaults
The VHA uses SSL to communicate with VFrame.
Command Modes
Configure mode.
Usage Notes
You do not configure the VHA connection type on model servers when you install the VHA. The VHA always tries to connect to the VFrame Data Center Director using port 3010, for SSL connections. If that fails, it tries port 3000, for TCP connections. Thus, the connection should succeed whether you configure TCP or SSL for the connection type on the VFrame Data Center Director.
You do not need to create a certificate for SSL. VFrame generates a self-signed certificate for SSL.
Examples
This is an example of setting the communications protocol for the VHA to VFrame connection to SSL.
vframehost# configEnter configuration commands, one per line. End with CNTL/Z.vframehost(config)# vha connection sslvframehost(config)#Related Commands
Server Administration Reference
These topics describe the main tabs and dialog boxes that relate to VFrame system administration:
System Settings Dialog Box
The System Settings dialog box includes tabs for various system-level settings, which affect system-wide behaviors. You can configure these settings only in the Admin context.
How to Get to This Dialog BoxSelect File > System Settings to open the System Settings dialog box.
Related TopicsField Reference
Table 18-1 System Settings Dialog Box
The e-mail address and SMTP server that VFrame should use when sending e-mail notifications.
For information about these fields, see SMTP Tab, System Settings Dialog Box.
The syslog servers to which VFrame should send syslog messages.
For information about these fields, see Syslog Tab, System Settings Dialog Box.
The VFrame routing table contains static routes for managed networks (those included in the IP Address Range resource pool).
For information about these fields, see VFrame Routing Table, System Settings Dialog Box.
Various system properties.
Database Pruning
Properties that control how long certain types of data is kept in the database.
•
•
SNMP Properties
Properties that control how SNMP queries are handled.
•
•
SSH Session Settings
Properties that control how SSH sessions from VFrame are handled.
•
•
•
•
•
User-Defined CLI Prompt Settings
Properties that identify the prompts for the command-line interface (CLI) for devices. These settings are required for VFrame to connect to the devices using SSH. If you configure prompts that are different from the Cisco IOS software defaults, you must update this preference:
•
The Device Managers tab contains programs that you access using the Device Manager command on the Resources or Pools tabs, or on the Acquired Resources tab on the Operations tab. You can define different device managers for each type of device that VFrame supports.
For information about these fields, see Device Manager Tab, System Settings Dialog Box.
SMTP Tab, System Settings Dialog Box
Use the SMTP tab in the System Settings dialog box to identify the e-mail account that VFrame should use for sending e-mail. VFrame can send e-mail notifications for various reports and monitoring policies. If you want to create these types of notifications, you must configure the SMTP credentials for the product.
How to Get to This TabSelect File > System Settings to open the System Settings Dialog Box, and then click the SMTP tab.
Related Topics•
Field Reference
Table 18-2 SMTP Tab, System Settings Dialog Box
Mail Server (SMTP)
The IP address or DNS name of the SMTP server the product should use to send e-mails, for example, mailserver.example.com.
Port
The SMTP server port for sending e-mail. The default is 25. Change this only if your SMTP server is configured to use a different port.
From
The existing e-mail account name that the product should use when sending e-mail, for example, vframe@example.com.
Notification for System Errors
The e-mail address of the person or group who should be notified in the case of VFrame system errors. For information on the system faults that can result in a notification being sent to this address, see show fault.
You can enter only one e-mail address in this field.
Server Requires Authentication
Whether the SMTP server is configured to require users to log in before sending e-mail. If you select this, you must fill in these fields:
•
•
Test Settings
Click this button to test whether the product can use the SMTP credentials you entered. You are prompted to enter an e-mail address to receive the test message.
Syslog Tab, System Settings Dialog Box
Use the Syslog tab in the System Settings dialog box to identify the syslog server that should receive messages from the product. You can then use your syslog server to monitor the VFrame system.
How to Get to This TabSelect File > System Settings to open the System Settings Dialog Box, and then click the Syslog tab.
Related Topics•
Field Reference
VFrame Routing Table, System Settings Dialog Box
Use the VFrame Routing Table to configure static routes for networks or hosts that VFrame manages. VFrame must have a route to any address range you include in IP Address Range resource pools. If the default gateway you configure for VFrame has routes to all of these address ranges, you do not need to configure any static routes. Configure static routes only if VFrame is unable to route packets to a managed network.
Configuring static routes in this table is equivalent to using the ip route command in a VFrame CLI session, as described in ip.
How to Get to This TabSelect File > System Settings to open the System Settings Dialog Box, and then click the VFrame Routing Table tab.
Related TopicsField Reference
Device Manager Tab, System Settings Dialog Box
Use the Device Manager tab to configure programs that you access using the Device Manager command on the Resources or Pools tabs, or on the Acquired Resources tab on the Operations tab. When you select a device, and then select the Device Manager command from the right-click shortcut menu, you can select a program that you configured for the device, and VFrame starts the program for you. For example, you can configure an SSH client as a device manager for Catalyst switches, and start an SSH connection to the switch from the VFrame interface.
How to Get to This TabSelect File > System Settings to open the System Settings Dialog Box, and then click the Device Manager tab.
Related TopicsField Reference
Table 18-5 Device Manager Tab, System Settings Dialog Box
Device Type
The type of device for which this device manager is defined.
Display Name
The name for this device manager. The name appears here and also in the selection list when you select the Device Manager command on the Resources or Pools tabs, or on the Acquired Resources tab on the Operations tab.
Application
The path and filename of the application that will be started if the user selects this device manager.
Parameters
The parameters that will be added to the application's executable command when it is started. For example, the management IP address ($MgmtAddr).
New button
Click this button to add a device manager to the table. You are prompted to enter the information described above for the route. Keep these tips in mind:
•
•
You must also type in any nonvariable keywords required by the application. For example, if you are configuring an SSH client and want to pass the client the switch's IP address, you probably need to pass the $MgmtAddr variable on the -h parameter. To do this, type in -h and then insert $MgmtAddr:
-h $MgmtAddr
Edit button
Click this button to edit the selected device manager's properties.
Delete button
Click this button to delete the selected device manager.
OK button
Click this button to save any changes that you made to the device manager table. Making changes in the table is not sufficient to save your changes.
Device Manager Parameter Variables
When you configure a device manager as described in Configuring Device Managers, you can include variables as parameters on the application executable. For example, with an SSH client, you can pass it an IP address as a parameter, which makes a connection directly to the device, instead of just starting the SSH client.
The parameters you can use depend on what the application can accept and on what variables VFrame makes available to you (they are limited by device type). Select only those variables that your application can accept.
When configuring device manager parameters, the following variables are available for use. Unless otherwise noted, the variables are available for all device types.
Keep in mind that you must follow the parameter rules of the application. For example, if you must include a keyword parameter to pass one of these variables, type in the parameter before adding the variable. For example, an SSH client might require the -h parameter to pass the $MgmtAddr variable: -h $MgmtAddr.
To see the values of these variables for a specific device, right-click the device on the Resources or Pools tabs, or on the Acquired Resources tab on the Operations tab, and select Properties. On the Properties dialog box, select the Device Managers tab, and the variables with their values are listed in the bottom part of the dialog box.
The following variables are available for use as device manager parameters:
•
–
–
–
–
–
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
