traffic_shell

NAME
traffic_shell - Describes how to use Traffic Shell.

DESCRIPTION
This page describes how to use the Traffic Shell command-line interface to monitor and configure Traffic Server and Media-IXT software.

This page describes the following topics:
About Traffic Shell
Using the Interactive Method
Using the File Execution Method
Exiting Traffic Shell
Using Traffic Shell Commands
Traffic Shell Command Shortcuts
Accessing Man Pages

ABOUT TRAFFIC SHELL
Traffic Shell enables you to monitor and configure Traffic Server using a UNIX shell-like command interface. Traffic Shell is one of several interfaces for monitoring and configuring Traffic Server. Using Traffic Shell is an alternative to manually editing Traffic Server's configuration files or using Traffic Server's Traffic Line or Traffic Manager UI.

Traffic Shell supports two operational methods:
The Interactive method lets you type individual commands at the traffic_shell prompt.

The File Execution method lets you run a set of Traffic Shell commands.

USING THE INTERACTIVE METHOD
You use Traffic Shell interactively by typing individual commands at the traffic_shell prompt. As you enter a command, Traffic Shell processes it and displays the result. You can continue to enter commands until you manually exit Traffic Shell.

USING THE FILE EXECUTION METHOD
When you use the File Execution method, you run a set of Traffic Shell commands that you list in a text file. You use a separate command that points to that file to run your entire set of commands.

To start Traffic Shell and execute a file that contains a set of Traffic Shell commands, enter the following command at your UNIX shell prompt: traffic_shell -f filename

This starts Traffic Shell and runs all Traffic Shell commands in the named file. It displays the results and leaves your cursor at the traffic_shell prompt. You can now enter individual commands at the traffic_shell prompt, as described in Using the Interactive Method, above.

IMPORTANT: You exit Traffic Shell by typing exit at the traffic_shell prompt. Therefore, if the word exit appears in your file, your cursor returns to the UNIX shell prompt (instead of the traffic_shell prompt) after you run your script. (This does not affect the results of running your script.)

EXITING TRAFFIC SHELL
Type exit at the traffic_shell prompt to exit Traffic Shell.

USING TRAFFIC SHELL COMMANDS
Once you start Traffic Shell, you use one of two modes:

The Monitor mode allows you to run Show commands, which display system information and Traffic Server statistics. You use Show commands to monitor Traffic Server performance. When you start Traffic Shell, you are automatically in Monitor mode.

To see a list of Show commands, type show at the traffic_shell prompt. To use a Show command, enter the command at the traffic_shell prompt. For example, enter the show:http command as follows: traffic_shell> show:http

The Enable mode allows you to run Config commands, which set Traffic Server and network parameters. The Enable mode is password-protected.
To enter Enable mode:
   1. Type enable at the traffic_shell> prompt.
   2. Enter your Administrator password.

IMPORTANT: You must enter Traffic Shell's Enable mode to use
Traffic Shell's Config commands. You can use both Show and Config commands
when you are in Enable mode. It is not necessary to return to Monitor mode
to use Show commands.

Once you enter Enable mode, you can use the Config commands.
To see a list of Config commands, type config at the traffic_shell prompt.
To use a Config command, enter the command at the traffic_shell prompt.
For example, enter the config:icp multicast on command as follows:
traffic_shell> config:icp multicast on

To return to Monitor mode, in which you cannot use Config commands to
set parameters, use the disable command, as follows:
traffic_shell> disable

TRAFFIC SHELL COMMAND SHORTCUTS
Traffic Shell supports the following shortcuts for entering commands.

Command completion

Type the initial characters of a valid command, and then press the tab key. Traffic Shell completes the command.

Command abbreviation

Type the initial characters of a valid command, and then press the Enter key. Traffic Shell displays all commands that begin with the characters that you enter. If only one command begins with those characters, Traffic Shell immediately executes that command.

Command history

From the traffic_shell prompt, press the Up and Down arrow keys to scroll through commands that you previously entered.

ACCESSING MAN PAGES
Traffic Shell includes manual pages (man pages) that describe each Traffic Shell command. (These man pages are similar to your UNIX man pages.) To access Traffic Shell's man pages, type man, followed by any Traffic Shell command at the traffic_shell prompt. For example, to view a man page for the show:security command, enter the following man page command: traffic_shell> man show:security