Applies To:

Show Versions Show Versions

Archived Manual Chapter: Working from the Command Line
Manual Chapter
Table of Contents   |   << Previous Chapter   |   Next Chapter >>

This article has been archived, and is no longer maintained.

You can use the command line to configure the WANJet appliance and perform commands. While it is not typically necessary to use the command line interface, some administrators may prefer to use the Linux shell. In some cases, such as when rebooting or shutting down the WANJet appliance, it is necessary to execute commands at the command line.
You may find that it is easier to perform initial configuration on the WANJet appliance at the command line than it is using the LCD. You can configure the Management IP address, netmask, and gateway for the WANJet appliance using the config command. Then you can complete configuration from the browser-based Setup utility and Configuration utility.
In addition, if you do not have physical access to the WANJet appliance, you can use an SSH program to connect to the command line interface. You can perform initial configuration, as described in Configuring the WANJet appliance from the command line. You can also use SSH for troubleshooting the WANJet appliance.
This chapter explains how to access the command line interface and describes some of the most useful commands. For additional information, refer to the following:
Online man pages
The WANJet product includes online man pages for bigpipe commands and many standard Linux commands.
BIG-IP® Command Line Interface Guide
This reference document includes details on all of the TMOS-related commands that are available from the command line of the WANJet appliance.
You need to attach a computer to the WANJet appliance to access the command line through a serial console. You can then use a terminal emulator program, such as HyperTerminal, to connect to the WANJet appliances command line interface.
Plug the other end of the cable into the port labeled Console on the WANJet appliance. The console port is an RJ-45 port on the front of the WANJet 300, 400, and 500.
You can use a terminal emulator program to access the command line if working locally using a serial console connected to the WANJet appliance. If you are using a computer running Microsoft® Windows®, you can use HyperTerminal or other terminal emulator program. You can also use any SSH program, such as PuTTY, AlphaCom, or SecureCRT® to get to the command line if working locally or remotely.
The following procedure uses HyperTerminal; other terminal emulators require similar setup steps. The procedure To use PuTTY to get to the command line, describes how to use an SSH client to get to the command line.
On the connected computer, from the Start menu, choose All Programs, then Accessories, then Communications, and then click HyperTerminal.
The Connection Description popup screen opens.
In the Name box, type a name for the connection, then click OK.
The Connect To popup screen opens.
From the Connect using list, select the port where the WANJet appliance is connected to the computer.
The Properties screen for the port opens.
From the Bits per second list, select 9600.
From the Data bits list, select 8.
From the Parity list, select None.
From the Stop bits list, select 1.
From the Flow control list, select Xon/Xoff.
Click OK.
The connection session opens, and the login prompt appears in the console window.
At the login prompt, type root.
You can also log on using any account for which Terminal Access is Enabled. For details, see Creating local user accounts.
At the Password prompt, type the root password.
You now have access to the Linux shell.
From any computer on a network that can connect to the WANJet appliance, start PuTTY.
The PuTTY Configuration popup screen opens.
In the Host Name (or IP address) box, type the Management IP address of the WANJet appliance.
For the Protocol, select SSH.
Click Open.
When connecting to a WANJet appliance for the first time, a message asking you to check the host key appears. To continue, you must click Yes to indicate that you trust the host.
A console window opens.
At the login as prompt, type root.
Note: You can also log on using any account for which Terminal Access is Enabled. For details, see Creating local user accounts.
At the Password prompt, type the root password.
You now have access to the Linux shell.
After you have logged on to the command line through your terminal emulator, SSH client, or console server, you can execute commands on the command line. The WANJet appliance CLI supports standard Linux commands, bigpipe commands, and bigstart commands.
Type bigpipe at the command line to display a list of the bigpipe commands. Online man pages are also available for the bigpipe, bigstart, and available Linux commands. Refer also to the BIG-IP® Command Line Interface Guide for information about the commands that are available.
Table 14.1 lists commands commonly used when administering a WANJet appliance.
Displays the bigpipe utility. b and bp are abbreviations for bigpipe. Displays a list of all bigpipe commands. For details, see the online man pages or the BIG-IP® Command Line Interface Guide.
In the Configuration utility, you can view interface statistics for the LAN, WAN, and Peer interfaces on the Network >> Interfaces >> Statistics screen.
Configures minimal network settings for the WANJet appliance including setting the Management IP address, netMask, default route (gateway) for the Management port.
The following procedures describe how to use several of the commands after having logged on to the WANJet appliance command line.
You can perform initial configuration of the Management port on the WANJet appliance from the command line. On platforms that include a liquid crystal display, or LCD, you can configure the addresses there instead. The Quick Start Card included in the shipping box with your WANJet appliance describes the initial hardware installation and setup instructions using the LCD.
In the terminal emulator, type config.
The Configuration utility screen opens.
Click OK to proceed.
The Configure IP Address screen opens.
In the IP Address box, type the IP address of the Management port, and click OK.
In the Netmask box, type the netmask for the Management port, and click OK.
The Management Route screen opens, asking whether you want to create a default route for the Management port.
Click Yes if you want to create a default route so that you can connect to the WANJet appliance from another subnet.
Click No if you do not want to create a default route (Management gateway) for the Management port. In this case, you can only log on from a computer located in the same network as the WANJet appliance.
If you replied Yes in step 5, in the Management Route box, type the IP address for the gateway to the management network, and click OK. If you replied No, skip to step 7.
The Confirm Configuration screen opens.
Click Yes to accept the configuration.
When you complete this step, the command line prompt returns and the new configuration information is applied to the WANJet appliance immediately. Values that you changed on the command line are also changed in the Configuration utility.
You can use the ping command to test whether a destination address is reachable across an IP network. For example, if you are having trouble connecting to a second WANJet appliance, you could ping the gateway IP address or the IP address of the other WANJet appliance.
In the terminal emulator, type ping <destination>, where <destination> is the IP address or host name of the computer you are trying to reach. Ping output shows an overview of the command, followed by a list of responses received. It continues to show responses until you stop the command by typing Ctrl + C.
At the end of the command output, you can see ping statistics including the number of packets transmitted and received between the WANJet appliance on which you are working and the destination computer, the percentage of packet loss, the total time it took, and the round trip time between the two computers.
For example, the following command checks to see whether or not the computer at the IP address is responsive. The -c 5 option specifies the count and stops sending requests after five replies are received (or when the deadline is reached). The -w 10 option indicates a deadline of 10 seconds.
Type man ping to see the complete syntax of the command. Refer to documentation on the Linux ping command for details on using all of the options.
You can shut down the WANJet appliance or restart it from the command line. Shutting down WANJet appliance stops all data processing and brings the system down in secure way.
Type shutdown.
The operating system shuts down.
Type reboot.
The operating system halts and restarts.
You typically have two software images on the flash memory card of the WANJet appliance. One image is active and the other is inactive. If something goes wrong with the first installation, you can boot from the alternate image.
Also, having two images lets you install a newer release on one yet maintain the current installation for cases when you want to test an upgrade without losing the previous version. When you perform an upgrade, the WANJet appliance gives you the option of using the configuration settings from the current installation on the upgraded image.
To start the WANJet appliance from the alternate partition, type reboot.
The WANJet appliance reboots and starts up using the other image.
Table of Contents   |   << Previous Chapter   |   Next Chapter >>

Was this resource helpful in solving your issue?

NOTE: Please do not provide personal information.

Additional Comments (optional)