|
|
You can launch all TrafficDirector executable files and utilities directly from the command line. This chapter 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. TrafficDirector lists the arguments, if any.
Command-line utilities are an alternative way to launch 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 launch from the GUI or from a command-line utility.
Keep in mind that each utility has separate arguments that you can use. For more information about exact syntax and arguments to use with a command-line utility, See the on-line man pages.
Command-line utilities are useful in many different situations. Table A-1 lists and describes all command-line utilities in alphabetical order.
| Utility | Description |
|---|---|
| dvadmin | Non-interactive utility |
| dvattach | Non-interactive utility |
| dvcl | Non-interactive utility |
| dvclean | Non-interactive utility |
| dvdcap | Non-interactive utility |
| dvdeinst | Non-interactive utility |
| dvdetach | Non-interactive utility |
| dvdomid | Non-interactive utility |
| dvdump | Non-interactive utility |
| dvevlog | Non-interactive utility |
| dvfdstn | Non-interactive utility |
| dvftp | Non-interactive utility |
| dvget | Non-interactive utility |
| dvhelp | Non-interactive utility |
| dvhist | Non-interactive utility |
| dvhl | Non-interactive utility |
| dvinst | Non-interactive utility |
| dvlist | Non-interactive utility |
| dvlearn | Non-interactive utility |
| dvnext | Non-interactive utility |
| dvreport | Non-interactive utility |
| dvset | Non-interactive utility |
| dvsnap | Non-interactive utility |
| dvtime | Non-interactive utility |
| dvtrsr | Non-interactive utility |
| dvwalk | Non-interactive utility |
| grconv | Graphical utility |
| grdommon | Graphical utility |
| grhist | Graphical utility |
| grhl | Graphical utility |
| grhost | Graphical utility |
| grhz | Graphical utility |
| grpktmon | Graphical utility |
| grreport | Graphical utility |
| grstat | Graphical utility |
| grsz | Graphical utility |
| nsaltmon | Textual utility |
| nscl | Textual utility |
| nsdcap | Textual utility |
| nsdomed | Textual utility |
| nsdommgr | Textual utility |
| nsfdrsl | Textual utility |
| nsfilted | Textual utility |
| nshl | Textual utility |
| nshz | Textual utility |
| nslogin | Textual utility |
| nsman | Textual utility |
| nspdec | Textual utility |
| nsproped | Textual utility |
| nsrepted | Textual utility |
| nsresmon | Textual utility |
| nsshell | Textual utility |
| nssz | Textual utility |
| nstosnif | Packet capture conversion utility |
| nstrend | Textual utility |
| nstrrsl | Textual utility |
| nstrsr | Textual utility |
The nstosnif utility Converts a TrafficDirector-format packet capture file to Sniffer format.
Noninteractive utilities are tools that you can use "behind the scenes" of the TrafficDirector GUI to administer database tables, event logs, and perform several advanced functions that do not have a GUI. The following noninteractive utilities are available:
| dvadmin | Maintains the trap destination "admin" table that the specified agent uses to determine which hosts that receive Simple Network Management Protocol (SNMP) trap as the result of a Trap Manager event. Also use dvadmin to add or delete entries or list the contents of this table. |
| dvattach | Attaches a port or slot as a monitor port for a switch you specify. |
| dvcl | Lists all or some of the contents of the conversation table for the agent and domain you specify. |
| dvclean | Deletes some or all of the Management Information Base (MIB) tables from the agent you specify. You can specify certain types of tables to delete, or not specify any table type to delete all tables (this is the same as a soft reset on the agent). |
| dvdcap | In the agent, captures packets associated with a given filter, stops data capture, uploads captured packets from the agent to a file, and deletes data capture in an agent. You can also use this utility as part of a shell script that is executed when a Trap Manager-defined alert is received. |
| dvdeinst | Deinstalls some or all MIB tables associated with a specific domain from the agent specified. You can specify certain types of domain tables to delete, or not specify any table type to delete all domain tables. If you deinstall a domain on an Remote Monitoring 2 (RMON2) probe, it frees agent resources without deleting the domain however, if you deinstall a domain on an RMON probe, the domain is deleted. |
| dvdetach | Detaches a port or slot as a monitor port for the specified switch you. |
| dvdomid | Gets the agent channel number (instance) associated with a specific domain and writes the result to stdout (if the result is 0, the specified domain is not installed). Use this utility 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 the 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 to dump certain types of MIB tables or all MIB table types. |
| dvevlog | Dumps internal agent event logs 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 the ring station list of Fiber Distributed Data Interface (FDDI) agent. 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 the status for all stations on the ring or get configuration information for an individual station. |
| dvge | Gets and displays the value of a specified SNMP variable. |
| dvhelp | Provides help with the syntax and arguments for any dv command. |
| dvhist | Lists contents of the agent history table for a specified domain. Use this utility to get the segment statistics history that the agent maintains for a specified domain. You can get either long- or short-term history. For Token Ring agents, you can get either the default promiscuous or non-promiscuous, MAC-level history. |
| dvhl | Lists some or all of the contents of the host table for the specified agent and domain. |
| dvinst | Installs domains at a specified agent. This utility can be used instead of the interactive Domain Manager application on TrafficDirector main window. |
| dvlearn | Autodiscovers complex devices on a network segment, such as ports on a switch and Frame Relay agent DLCI ports. The 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, including the host mode that 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. If you redirect the displayed output when you use the dvlist utility to a file, you can use it as the configuration file for the dvinst utility. |
| dvnex | 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 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 a specified interval. |
| 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 the source routing table Token Ring agent. Use this utility to create or delete the source routing table maintained by a Token Ring agent. You can also use this utility to list the contents of the table. |
| dvwalk | Gets and displays all SNMP variables defined in an MIB table, starting from a variable you specify. |
The following applications feature graphical displays that you can launch from the command line:
| 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 a 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 History graph GUI. |
| grhl | Displays a bar chart of the top 20 hosts that meet the 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 the sort criteria you define. Corresponds to the Host Zoom graph GUI. |
| grpktmon | Displays the segment activity for multiple agents and domains in bar or pie chart format. Corresponds to the Traffic Monitor GUI. |
| grreport | Generates graph-based reports non-interactively. Corresponds to the Trend Reporter GUI. |
| grstat | Displays a graph of segment statistics for the agent and domain you specify. Corresponds to the Segment Details graph GUI. |
| grsz | Displays graphs for multiple domain statistics you specify. Corresponds to Segment Zoom graph GUI. |
The following applications feature textual displays that you can launch from the command line:
| nsaltmon | Displays SNMP traps collected from TrafficDirector probes. 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 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 view installed domains for a single agent or a group of agents. Also gives a summary of the current domain activity for scoped agents and domains. Corresponds to the Domain Discovery GUI. |
| nsfdrsl | Displays a list of stations on the agent FDDI ring you specify, including the 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 the 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 the SwitchProbe configuration menu, without requiring a local serial port connections. Corresponds to the Remote Login GUI. |
| nsman | 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. |
| nsproped | Lets you edit the agent Settings files. |
| nsrepted | Launches the Report Editor. |
| nsresmon | Configures an agent you specify to perform proxy IP pings or proxy SNMP polls. Corresponds to the Round Trip Delay GUI. |
| nsshell | For model 9450 (Windows platform) only, provides a command-line execution environment for non-GUI applications. Most command line tools are part of the shell and run within the shell context. Corresponds to the Command Shell. |
| nssz | Displays a tabular-form summary of segment traffic for a specified domain. Corresponds to the Segment Zoom GUI. |
| nstrend | Lets you generate frontier-defined reports. Corresponds to the Trend Reporter GUI. |
| nstrrsl | Displays a list of stations on the specified agent Token Ring ring, including ring status and configuration information for each station. Corresponds to the Token Ring Station List GUI. |
| nstrsr | Displays source routing information for the specified agent Token Ring. Corresponds to the Source Route Monitor GUI. |
The following TrafficDirector daemons are started automatically when you run the software:
| dbautod | Database autoreporter daemon |
| dbextrad | Database extraction daemon |
| dbrolld | Database rollup daemon |
| dbsnapd | Database snapshot daemon |
| dvconfd | Agent configuration daemon |
| dvtrapd | SNMP trap daemon |
| dbchckd | Process that checks to make sure that all other daemons are running |
|
|