|
|
You can launch all TrafficDirector executable files and utilities directly from the command line. This appendix lists each executable file and utility 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. TrafficDirector lists the arguments, if any.
Command line utilities are an alternative way of launching applications, graphs, daemons, and other utilities from outside the TrafficDirector GUI. Most of the command line utilities in this chapter have a direct counterpart that you can use in the GUI. The functionality is the same, whether you launch something from the GUI or from a command line utility.
Keep in mind that each utility has separate arguments that you might want to use. For more details about exact syntax and arguments to use with a command line utility, see the online documentation.
To run command line utilities, select TrafficDirector Shell from the TrafficDirector Main menu. A window appears with a command line. Enter the utilities described in this chapter on the TrafficDirector Shell command line.
The TrafficDirector Shell lets you run dv commands only. However, you can use dvbatch to run any DOS batch file or nsrun to run any DOS *.exe file.
To help you find a specific utility, Table A-1 lists all the utilities in alphabetical order and the sections in this appendix.
| Utility | Description | Section |
|---|---|---|
| dbautod | daemon | "Background Daemons" |
| dbextrad | daemon | "Background Daemons" |
| dbrolld | daemon | "Background Daemons" |
| dbsnapd | daemon | "Background Daemons" |
| dvadmin | noninteractive utility | "Command Line Utilities" |
| dvattach | noninteractive utility | "Command Line Utilities" |
| dvcl | noninteractive utility | "Command Line Utilities" |
| dvclean | noninteractive utility | "Command Line Utilities" |
| dvconfd | daemon | "Background Daemons" |
| dvdcap | noninteractive utility | "Command Line Utilities" |
| dvdeinst | noninteractive utility | "Command Line Utilities" |
| dvdetach | noninteractive utility | "Command Line Utilities" |
| dvdomid | noninteractive utility | "Command Line Utilities" |
| dvdump | noninteractive utility | "Command Line Utilities" |
| dvevlog | noninteractive utility | "Command Line Utilities" |
| dvfdstn | noninteractive utility | "Command Line Utilities" |
| dvftp | noninteractive utility | "Command Line Utilities" |
| dvget | noninteractive utility | "Command Line Utilities" |
| dvhelp | noninteractive utility | "Command Line Utilities" |
| dvhist | noninteractive utility | "Command Line Utilities" |
| dvhl | noninteractive utility | "Command Line Utilities" |
| dvinst | noninteractive utility | "Command Line Utilities" |
| dvlist | noninteractive utility | "Command Line Utilities" |
| dvlearn | noninteractive utility | "Command Line Utilities" |
| dvnext | noninteractive utility | "Command Line Utilities" |
| dvreport | noninteractive utility | "Command Line Utilities" |
| dvset | noninteractive utility | "Command Line Utilities" |
| dvsnap | noninteractive utility | "Command Line Utilities" |
| dvtime | noninteractive utility | "Command Line Utilities" |
| dvtrapd | daemon | "Command Line Utilities" |
| dvtrsr | noninteractive utility | "Command Line Utilities" |
| dvwalk | noninteractive utility | "Command Line Utilities" |
| grconv | graphical utility | "Command Line Utilities" |
| grdommon | graphical utility | "Command Line Utilities" |
| grhist | graphical utility | "Graphical Utilities" |
| grhl | graphical utility | "Graphical Utilities" |
| grhost | graphical utility | "Graphical Utilities" |
| grhz | graphical utility | "Graphical Utilities" |
| grpktmon | graphical utility | "Graphical Utilities" |
| grreport | graphical utility | "Graphical Utilities" |
| grstat | graphical utility | "Graphical Utilities" |
| grsz | graphical utility | "Graphical Utilities" |
| instlic | license installation utility | "Miscellaneous Utilities" |
| nsalrmgr | textual utility | "Textual Utilities" |
| nsaltmon | textual utility | "Textual Utilities" |
| nscl | textual utility | "Textual Utilities" |
| nsdcap | textual utility | "Textual Utilities" |
| nsdomed | textual utility | "Textual Utilities" |
| nsdommgr | textual utility | "Textual Utilities" |
| nsfdrsl | textual utility | "Textual Utilities" |
| nsfilted | textual utility | "Textual Utilities" |
| nshl | textual utility | "Textual Utilities" |
| nshz | textual utility | "Textual Utilities" |
| nslogin | textual utility | "Textual Utilities" |
| nsman | textual utility | "Textual Utilities" |
| nspdec | textual utility | "Textual Utilities" |
| nsresmon | textual utility | "Textual Utilities" |
| nsshell | textual utility | "Textual Utilities" |
| nssz | textual utility | "Textual Utilities" |
| nstosnif | packet capture conversion utility | "Miscellaneous Utilities" |
| nstrend | textual utility | "Textual Utilities" |
| nstrrsl | textual utility | "Textual Utilities" |
| nstrsr | textual utility | "Graphical Utilities" |
The following utilities are standalone programs that perform various functions, as follows:
| echo | Echoes command and actions being performed. Use this utility as you need to; most commonly, you would use it to write TrafficDirector script files. |
| instlic | Installs a license for TrafficDirector. Use this utility to install your TrafficDirector temporary and permanent licenses. Whenever you use this utility, you are prompted to enter the license information included with your software. |
| nstosnif | Converts TrafficDirector-format packet capture file to Sniffer format. |
| man | Displays man pages for the utility you specify. Use this utility to display syntax and other information about any of the utilities described in this chapter. |
| run | Runs any DOS or Windows executable. When specifying an executable that is not in the current path, you must enclose the entire run statement in quotes (for example: "run c:\dos\xyz.exe").
If you specify an executable that is in the current path, quotes are not required; however, if you include the quotes, it does not affect processing. |
| type | Displays the contents of the file name you specify. Use this utility to see, but not edit, the contents of a file. |
TrafficDirector daemons, which are started automatically when you run the software, are described as follows:
| dbautod | Database autoreporter daemon. |
| dbextrad | Database extraction daemon. |
| dbrolld | Database rollup daemon. |
| dbsnapd | Database snapshot daemon. |
| dvconfd | Agent configuration daemon. |
| dvtrapd | SNMP trap daemon. |
The following listing describes all the remaining noninteractive utilities you can use and provides a brief description of the utilities:
| dvadmin | Maintains the trap destination admin table in the agent you specify. Use this utility to maintain the trap-target table that the specified agent uses to determine hosts that receive an SNMP trap as the result of a Trap Manager event. Use dvadmin to add or delete entries or to list the contents of this table. |
| dvattach | Attaches a port or slot as a monitor port for a switch you specify. |
| dvcl | Lists contents of the conversation table for the agent and domain you specify. Use this utility to get a full or partial listing of a conversation table. |
| dvclean | Deletes MIB tables from an agent. Use this utility to delete some or all MIB tables from the agent you specify. You can specify certain types of tables to delete or use the utility without specifying a type to delete all MIB 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 the specified agent name. |
| dvdcap | In the agent, captures packets associated with a given filter, stops data capture, uploads captured packets from the agent to a file, and also deletes data capture in an agent. Use this utility for the functions listed above or use as part of a shell script that is executed when a Trap Manager-defined alert is received. |
| dvdeinst | Deinstalls domains from an agent. Use this utility to deinstall some or all MIB tables associated with a specific domain from the agent you specify. You can specify certain types of domain tables to delete or use the utility without specifying a type to delete all domain tables. However, if you deinstall a domain on an RMON2 probe, it frees agent resources without deleting the domain, but if you deinstall a domain on an RMON probe, the domain is deleted. |
| dvdetach | Detaches a port or slot as a monitor port for a switch you specify. |
| dvdomid | Gets the agent channel number associated with a specific domain. Use this utility to get 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. |
| dvdump | Dumps agent information or agent MIB tables. Use this utility to troubleshoot, by looking at details of the raw agent MIB tables or by looking at agent information, including IP address, IFN, IFTYPE, and MAC address. If you use this utility to dump agent MIB table information, you can specify that certain types of MIB tables are dumped or that all MIB table types are dumped. |
| dvevlog | Dumps agent event logs associated with a domain. 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 set in Trap Manager is reached or exceeded). |
| dvftp | Downloads DLCI configuration information into a specified agent. |
| dvfdstn | Manages and monitors an FDDI agent 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. |
| dvget | Gets and displays the SNMP variable you specify. Use this utility when you want to see the value of a specific SNMP variable. |
| dvhelp | Provides Help on dv commands. Use this utility any time you need help with syntax and arguments for any dv command. |
| dvhist | Lists contents of the agent history table for a specified domain. Use this utility to get segment statistics history the agent maintains for a specified domain. You can get either long- or short-term history, and for Token-Ring agents, either the default promiscuous or nonpromiscuous, MAC-level history. |
| dvhl | Lists contents of the host table for the specified agent and domain. Use this utility to get a full or partial listing of a host table. |
| dvinst | Installs domains at the agent you specify. Use this utility to install domains at an agent, if you do not want to or cannot use the interactive Domain Manager application on the TrafficDirector main window. |
| dvlearn | Autodiscovers complex devices on a network segment, such as ports on a switch and frame relay agent DLCI port. Results of this command line utility may automatically create files, such as the x.swp files (for learned switch ports) and x.frp files (for learned frame relay DLCI ports). |
| dvlist | Lists the domains installed at an agent. Use this utility to display a list, including the host mode the domain uses for host and conversation tables, as well as the yes/no flags that indicate which tables are installed that are associated with the domain. If you redirect the output displayed when you use the dvlist utility to a file, you can use it as the configuration file for the dvinst utility. |
| dvnext | Gets and displays the next SNMP variable defined in the MIB table after the one you specify with the dvnext utility. |
| dvreport | Generates reports noninteractively. Use this utility at the command line or from a script to generate tabular and CSV reports noninteractively. |
| dvset | 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 any time you need to change the type and value of an SNMP variable. |
| dvsnap | Provides a snapshot of domain activity for a short-term period. Use this utility to display segment, host, or conversation statistics for an interval you specify. |
| dvtime | Converts time intervals to timestamps suitable for use with the dvreport utility. Use this utility to help generate daily, weekly, or monthly reports noninteractively. You can pass the output of dvtime as start time and end time timestamp command line arguments to the dvreport utility. |
| dvtrsr | Manages and monitors a Token-Ring agent 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. |
| dvwalk | Gets and displays all SNMP variables defined in a MIB table, starting from a variable you specify. |
The following listing describes all the graphical utilities you can use and provides a brief description of the utilities:
| grconv | Displays a real-time graph of a domain-based conversation between two hosts. Corresponds to the Conversation Stats graph GUI. |
| grdommon | Displays a simultaneous domain activity graph for multiple agents and domains in bar or pie chart format. Corresponds to the Protocol Monitor GUI. |
| grhist | Displays an historical graph of segment statistics for a specified domain; you can display either a short-term or long-term history graph. Corresponds to the Segment Statistics graph GUI. |
| grhl | Displays a bar chart of the top 20 hosts that meet sort criteria you define for the specified domain. Corresponds to the Host List graph GUI. |
| grhost | Displays a graph of domain-based traffic for a selected host. Corresponds to the Host Stats graph GUI. |
| grhz | Displays a bar chart of the top 16 host conversations that meet sort criteria you define. Corresponds to the Host Zoom graph GUI. |
| grpktmon | Displays segment activity for multiple agents and domains in bar or pie-chart format. Corresponds to the Traffic Monitor GUI. |
| grreport | Generates graph-based reports noninteractively. Corresponds to the Trend Reporter GUI. |
| grstat | Displays a graph of segment statistics for the agent and domain you specify. Corresponds to the Segment Statistics graph GUI. |
| grsz | Displays graphs for multiple domain statistics you specify. Corresponds to the Segment Zoom graph GUI. |
The following listing describes all the applications featuring textual displays that you can launch from the command line:
| nsalrmgr | Lets you set multiple alarms on selected events associated with any RMON-MIB variable, as well as any private MIBs or network resources. Corresponds to the Trap Manager GUI. |
| nsaltmon | Displays SNMP traps collected from SwitchProbe devices. Corresponds to the Alert Monitor GUI. |
| nscl | Displays cumulative conversation traffic for all hosts in a specified domain. Corresponds to the Conversation List GUI. |
| nsdcap | Lets you configure an agent data capture session by specifying filter information, buffer and slice size, among others. Also lets you upload captured data from the agent's buffer to a disk file; you can analyze this later using Protocol Decode. Corresponds to the Data Capture GUI. |
| nsdomed | Lets you create, edit, or view a domain definition or get a list of all defined domains. Corresponds to the Domain Editor GUI. |
| nsdommgr | Lets you manage installed domains for a single agent or a group of agents. Also gives a summary of current domain activity for scoped agents and domains. Corresponds to the Domain Manager GUI. |
| nsfdrsl | Displays a list of stations on the agent FDDI ring you specify, including ring status and configuration information for each station. Corresponds to the FDDI Ring Station List GUI. |
| nsfilted | Lets you create, edit, or view a filter definition. Also lets you get a list of all defined filters. Corresponds to the Filter Editor GUI. |
| nshl | Displays a list of cumulative inbound and outbound traffic for all hosts in the domain you specify. Corresponds to the Host List GUI. |
| nshz | Displays current domain-based traffic activity for the host you specify, including a list of top conversations with other hosts. Corresponds to the Host Zoom GUI. |
| nslogin | Gives you remote access to a SwitchProbe device configuration menu, without requiring a local serial port connection. Corresponds to the Remote Login GUI. |
| trafdir | Starts the main TrafficDirector window that you use to configure switches, agents, and agent groups. Also lets you launch other GUI tools. |
| nspdec | Decodes packets that are captured and uploaded from an agent, using the Data Capture application. Corresponds to the Protocol Decode GUI. |
| nsresmon | Configures an agent you specify to perform proxy IP pings or proxy SNMP polls. Corresponds to the Resource Monitor GUI. |
| nssz | Displays a tabular-form summary of segment traffic for a domain you specify. Corresponds to the Segment Zoom GUI. |
| nstrend | Lets you configure aging and logging parameters required to generate Cisco Systems-defined reports. Corresponds to the Trend Reporter GUI. |
| nstrrsl | Displays a list of stations on the Token-Ring ring you specify, including ring status and configuration information for each station. Corresponds to the Token Ring Station List GUI. |
| nstrsr | Displays source routing information for the Token-Ring agent you specify. Corresponds to the Token-Ring Source Routing Monitor GUI. |
| nsshell | Provides a command line-oriented execution environment for non-GUI applications. Most command line tools are part of the shell and run within the context of the shell. The shell has been split into two parts: primary shell and secondary shell. The primary shell supports all command line utilities except those supported in the secondary shell. The secondary shell supports only the following commands: dvftp, dvlearn, dvattach, and dvdetach. Both the primary and secondary shells support both the dvhelp and main utilities. Corresponds to the TrafficDirector Shell. |
|
|