|
|
You can start all TrafficDirector executable files and utilities directly from the command line or by including them in a UNIX script or DOS BAT file.
This section lists each executable file and utility, along with a short description. To list the arguments for an executable file or utility, enter its name at the command prompt, followed by a space, and press Enter. The TrafficDirector application lists the arguments, if any.
The following topics describe how you work with the command-line utilities:
Command-line utilities are an alternative way to start applications, graphs, daemons, and other utilities from outside the TrafficDirector graphical user interface (GUI). Most of the command-line utilities in this chapter have a direct counterpart you can use in the GUI. The functionality is the same, whether you start from the GUI or from a command-line utility.
Each utility has separate arguments. For more information about exact syntax and arguments to use with a command-line utility, see the on-line man pages. You can use the command-line utilities in many different situations.
Table E-1 lists all command-line utilities in alphabetical order.
| This Utility... | Performs This Function |
|---|---|
ATM Monitor; displays ATM Cell rate, Call and Call Attempt rates for both CbrAndVbr and AbrAndUbr service classes in bar chart format. | |
A graphical application that displays TopN conversations for a specified domain. Started for ALLNL, shows top n network-layer conversations for all domains for which conversations are enabled. Started for ALLAL, shows TopN application-layer conversations for all domains for which has conversations are enabled. A topn-conv variable, in $NSHOME/usr/default.dvp is used to determine how many pairs of hosts are going to be displayed. The default is 10. | |
Displays a real-time graph of a domain-based conversation between two hosts. | |
Displays simultaneous domain activity graph for multiple agents and domains in bar or pie chart format. | |
Protocol Zoom; displays simultaneous domain activity graph with parent-children domain relationships for a single agent. | |
Segment History; displays a short- or long-term historical graph of segment statistics for a specified generic domain. | |
Displays a bar chart of the top 20 hosts that meet sort criteria you define for the specified domain. | |
Host Stats; displays a graph of domain-based traffic for a selected host. | |
Host Zoom; displays a bar chart of the top 16 host conversations that meet the sort criteria you define. | |
Traffic Monitor; displays segment activity for multiple agents and domains in bar or pie chart format. | |
SMON Monitor. | |
Segment Details; displays segment statistics for the agent and generic domain you specify. | |
Segment Zoom; displays statistical graphs for the agent and generic domain you specify. | |
A graphical real time application that lets you periodically poll particular statistics and variables and view that data based on user-defined parameters. | |
Lets you select and generate trend reports (the design of each trend report is determined in the Report Editor application). Corresponds to the Trend Reporter GUI. | |
Starts the main TrafficDirector window that you use to configure switches, agents, and agent groups. Also lets you launch other GUI tools. | |
Alert Monitor; displays SNMP traps collected from SwitchProbe devices. | |
Displays a list of client-server conversations with Application Response Time statistics for a specified domain. | |
Displays cumulative conversation traffic for all hosts in a specified domain. | |
Displays a list of cumulative conversation traffic for all ATM hosts in a specified domain. | |
Starts an agent data capture session. Lets you configure an agent data capture session by specifying filter information, buffer and slice size, and so on. Also lets you upload captured data from the agent buffer to a disk file; you can analyze the data later using Protocol Decode. | |
Lets you create, edit, or view a domain definition or get a list of all defined domains. | |
Lets you view installed domains for a single agent or a group or agents. Also gives a summary of current domain activity for specified agents and domains. | |
Lists FDDI ring stations. Displays a list of stations on the agent FDDI ring you specify, including ring status and configuration information for each station. | |
Lets you create, edit, or view a filter definition. Also lets you get a list of all defined filters. | |
Displays a list of cumulative inbound and outbound traffic for all hosts in a specified domain. | |
Displays a list of cumulative inbound/outbound traffic for all ATM hosts in a specified domain. | |
Displays current domain-based traffic activity for the specified host, including a list of top conversations with other hosts. | |
Displays current domain-based traffic activity for the specified ATM host including a list of top conversations with other hosts. Host Zoom. Displays current domain-based traffic activity for the specified ATM host, including a list of top conversations with other hosts. | |
Provides remote access to a SwitchProbe configuration menu, without requiring local serial port connections. | |
Decodes packets captured and uploaded from an agent using the Data Capture application. | |
Lets you create, view and edit agent properties files; configure SNMP traps and Round Trip delays on a agent. | |
Allows configuration of the specified agent to perform proxy pings or SNMP polls. SNMP MIB files used to define SNMP variables are installed into directory $NSHOME/usr with filename extension .mib (for example, ibm.mib). You must enable the Resource Manager option for the specified agent. | |
Allows you to create and edit your own report template (*.rt) files used to generate graphical and ASCII reports. | |
Displays (in tabular form) a summary of segment traffic for a specified generic domain. | |
Ring Monitor Token Ring Station display. Displays a list of stations on the specified Token Ring agent, including ring status and configuration information for each station. | |
Displays source routing information for the specified Token Ring agent. Corresponds to the Source Route Monitor GUI. |
This section lists the following types of utilities you can run from the command line:
The following section provides more information:
To view the arguments required for an executable or utility, enter the executable name or utility name in the $NSHOME/bin directory and press Enter. The TrafficDirector application identifies the arguments required.
Table E-2 lists all command line utilities in alphabetical order with a description of each utility.
Each utility has separate arguments. For more information about exact syntax and arguments to use with a command-line utility, see the on-line man pages.
| This Utility... | Performs This Function |
|---|---|
Converts packet capture files to Sniffer 5.0, Ethernet, Token Ring, and FDDI compatible format. On Windows platforms, you must run this command from the DOS prompt. | |
Lets you add or delete hosts to receive SNMP traps from the specified agent, port, or DLCI. Maintains the trap destination admin table in the agent you specify. Use dvadmin to list all entries in the agent trap-target table, and to add or delete target host entries. | |
Lists the contents of ATMRMON conversation table for the specified Port Select Group on specified ATM agent or ATM switch port. | |
Provides ASCII text dump of control entries related ATMRMON MIB tables found in ATM agents or switches. | |
Lists the contents of ATMRMON host table for the specified Port Select Group on specified ATM agent or ATM switch port. | |
Provides a snapshot of segment, host, or conversation statistics groups of ATMRMON MIB for short periods for specified Port Select Group of the specified ATM agent or ATM switch port. | |
Lists the contents of current report of ATMRMON TopN Conversation table for the specified Port Select Group on specified ATM agent or ATM switch port. | |
Assigns a new monitor port on a switch for roving. Attaches or roves the monitor_port to the analyzer port on a switch. The monitor port can be either a port name or a VLAN name. The monitor_port definition should be in either the switch_name.swp file or the switch_name.vln file in the $NSHOME/usr directory. Port names should not be duplicated as VLAN names; if they are, port names take precedence. The dvattach command requires that the agent.lst and switch.lst files are present in the $NSHOME/usr directory. | |
Installs any domains, resource monitor variables, and/or traps found in the corresponding properties files onto the agent, switch, or Frame Relay agent. Command-line equivalent of starting the Configuration Manager (a tool bundled within rmonmgr), selecting an agent, switch, or Frame Relay agent, and clicking Install. Running dvcfg installs any domains, resource monitor variables, and/or traps found in the corresponding properties files onto the agent, switch, or Frame Relay agent. It also initiates any logging of data for this agent, switch, or Frame Relay agent. | |
Gets a text dump of conversation table for the specified agent, switch port, or DLCI and domain. Lists contents of the conversation table for the agent and domain you specify. Use this utility to get a full or partial list of a conversation table associated with a specific domain on an agent or Frame Relay DLCI. | |
Deletes some or all MIB tables from the agent you specify. By using the type argument, you can specify certain types of tables to delete. You can omit the type argument to delete all tables (doing so is the same as a soft reset on the agent). If you use this utility for a multi-interface agent, it deletes MIB tables for all interfaces, not just the interface associated with that agent name. | |
Captures packets in the agent associated with given filters. It can also be used to stop data capture, upload captured packets from an agent into a file, and delete a data capture in an agent. | |
Detaches an agent from a switch monitor port. Detaches the monitor_port from the analyzer port. The monitor port can be either a port name or a VLAN name. The monitor_port definition should be in either the switch_name.swp or switch_name.vln file in the $NSHOME/usr directory. Port names should not be duplicated as VLAN names; if they are, port names take precedence. The dvdetach command also requires the agent.lst and switch.lst files to be present in the $NSHOME/usr directory. | |
Gets the channel number (instance) associated with a specific domain and write the result to stdout (if the result is 0, the domain you specified is not installed). Use this utility when you need to launch non-TrafficDirector applications that might require the instance of tables associated with a specific domain. | |
Provides ASCII text dump of control entries related to MIB2, RMON1, enhanced RMON, and RMON2 tables found in TrafficDirector agents, switches, and Frame Relay agents. Use this utility to troubleshoot, by looking at details of the agent MIB tables or by looking at agent information, including the IP address, IFN, IFTYPE, and MAC address. If you use this utility to dump agent MIB table information, you can specify that only certain types of MIB tables are dumped, or that all MIB table types are dumped. | |
Gets agent event logs associated with a domain installed on a particular agent, switch port, or Frame Relay DLCI. Use this utility to dump internal agent logs of events associated with a specific domain (event logs usually correspond to alarms the agent sends when a threshold is reached or exceeded). | |
Manages and monitors an FDDI agent's ring station list. Use this utility when you need to create or delete a ring station table that a specific FDDI agent maintains. You can also use this utility to list status for all stations on the ring or get configuration information for an individual station. | |
Downloads Frame Relay DLCI configuration information or expert data reduction filter information to an agent. | |
Displays the SNMP variable you specify. Use this utility when you want to see the value of a specific SNMP variable. This command fails if you do not specify the proper SNMP community string. | |
Lists contents of the agent history table for a specified domain. Use this utility to get a full or partial ASCII text dump of the short- and long-term history buckets associated with a generic domain or the RMON domain on an agent, switch port, or Frame Relay DLCI. You can get either long- or short-term history, and for Token Ring agents, either the default promiscuous or non-promiscuous, MAC-level history. | |
Lists contents of the host table for the specified agent and domain. Use this utility to get a full or partial text dump of a host table associated with a specific domain on an agent, switch port, or Frame Relay DLCI. | |
Learns the ports in the switch and DLCIs on Frame Relay agents. For Catalyst 5000-series switches, dvlearn also learns all the VLANs in the switch. The switch list is saved to the switch_name.swp file. The DLCI list is saved to the fragent_name.frp file. The VLAN list is saved to the switch_name.vln file. These files are stored in the $NSHOME/usr directory. The dvlearn command requires that the fragent.lst and switch.lst files be present in the $NSHOME/usr directory. | |
Displays a list of all domains installed on specified agent. Use this utility to display a list, including the host mode the domain uses for host and conversation tables, and the yes/no flags that indicate which tables are installed that are associated with the domain. | |
Displays the media independent stats in the agent. | |
Configures IP address, netmask or default gateway on a SwitchProbe device. | |
Gets and displays the contents of the SNMP variable found sequentially after the OID value found. This command will fail if the SNMP community string value specified does not match the one found on the host machine where you are doing the query. | |
Updates the RMON2 address map table found on RMON2 agents. | |
Displays the RMON2 protocol distribution counters for all protocol domains configured in the agent. | |
Takes the port name of a switch and returns the corresponding interface number. If a port of that name does not exist, a value of -1 is returned. | |
Configures or displays the serial configurations of an agent. | |
Sets the value of an SNMP variable you specify to an OID type (-i for integer, -s for string, -h for MAC address, and -o for object identifier) and a corresponding value. Use this utility to change the type and value of an SNMP variable. This command will fail if you specify an invalid SNMP community string. | |
Displays SMON statistics for VLANs in an agent. | |
Provides a snapshot of domain activity for a short-term period. Use this utility to display segment, host, or conversation statistics for an agent, switch port, or Frame Relay DLCI. | |
Converts time intervals to timestamps for use with dvreport utility. Use this utility to help generate daily, weekly, or monthly reports non-interactively. You can pass the output of dvtime as start time and end time timestamp command line arguments to the dvreport utility. The start time returned is n number of days or months prior to today's date; today's date is the end time. | |
Lists TopN hosts for the specified domain present on an agent, switch port, or Frame Relay DLCI. | |
Displays the TopN matrix conversations in the agent. | |
Listens for and logs SNMP trap messages. Listens and responds to agent configuration requests. Controls all logging activity log and error message redirection. | |
Displays Source Routing in Token Ring agent. Manages and monitors a Token Ring agent's source routing table. Use this utility to create or delete the source routing table that a Token Ring agent maintains. You can also use this utility to list the contents of the table. | |
Manages and monitors a Token Ring agent ring station table. Provides a method for creating or deleting the ring station table maintained by a Token Ring agent, to list status for all stations on the ring, to obtain configuration information for an individual station, or to remove a specified station from the ring. Token Ring SwitchProbe devices automatically self-configure a ring station table at power-up. You can delete this table or recreate it using the dvtrstn delete and add options. | |
Displays or configures the user history in the agent. | |
Upgrades the agent software to a new revision. | |
dvwalk | Displays contents of all SNMP variables defined in a MIB, starting from a variable you specify. This command will fail if the specified SNMP read community string does not match the read community string of the host on which you want to perform the MIB walk. |
Imports agent and switch definitions from the specified TrafficDirector location and merge them into the local TrafficDirector agent.lst, switch.lst, and other configuration files. Each imported agent or switch is defined as a remote agent. This means that you cannot install property files on the remote agents or switches from the local TrafficDirector installation. | |
Initializes AutoReporter with a default configuration and generates predefined reports on demand (Mixed Segment History, Protocol Usage, Protocol Distribution, Host Summary, Segment Summary, Segment History, DLCI Usage, and WAN Usage). | |
Runs the SwitchProbe upgrade utility. | |
Starts a separate console window to run a specified program or command. Takes as arguments the name of a command/program and its command-line arguments. The console window title displays the executed command name plus day/time. | |
Prints the SCCS id strings for each file. |
The TrafficDirector daemons listed in Table E-3 are started automatically when you start the TrafficDirector application:
Database autoreporter daemon. | |
Database extraction daemon. | |
Database rollup daemon. | |
Database snapshot daemon. | |
Agent configuration daemon. | |
SNMP trap daemon. | |
Process that checks to make sure all other daemons are running. |
Posted: Mon Apr 5 13:15:36 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.