Go to the table of contents Go to the previous page Go to the next page View or print as PDF
Administration > Toolbox > Appliance command line
Appliance command line
Help | V-Series Appliance | Version 8.0.x
On the appliance Toolbox page, the Appliance command line section provides:
*
The ability to turn on and off SSH remote access to the appliance command line interface (the same shell used to run the firstboot script). SSH access allows administrators to log on to the appliance command line shell from machines on the network that have a route to the appliance.
*
Access to a command line utility that is embedded within V-Series console. The command line utility provides convenient access to common troubleshooting commands.
SSH Remote Access
Use the Remote Access option to enable and disable SSH access to the appliance command line interface.
To connect to the appliance command line shell when SSH access is enabled:
*
*
*
*
Following is a list of command line commands. The debug-util sub commands are also available in the V-Series console in the Command line utility and are described in detail there.
admin email
debug-util controller
debug-util email
debug-util na
debug-util view
debug-util proxy
debug-util web
firstboot
help
history
ip address
ip dns
ip gateway
local-access
module disable
module enable
module restart
module start
module stop
password-logon disable
password-logon enable
patch delete
patch list
policy-source
quit
reload
remote-access disable
remote-access enable
reset password
show cpu
show disk-io
show disk-space
show interface c
show memory
show module
show module service
show password-logon
show patch
show patch history
show platform
show policy-source
show remote-access
show remote-access history
show security-mode
show smtp server
show ssh
shutdown
smtp server
ssh disable
ssh enable
Command line utility
Use the Command Line Utility to run troubleshooting, debugging, and utility commands. Results are displayed in the Console output section of the page. You can download the output file for the command last executed.
Click Launch Utility to open the command utility.
The Component drop down list includes an entry for each module installed on the appliance. Select the module that you want to work with:
*
*
*
*
*
Select the command you want to run from the Command drop-down list, enter appropriate parameters as described below, and then use the Run and Stop buttons as appropriate:
[Action]: Enter enable to turn on user name caching.
Enter disable to turn off user name caching.
Enter status to display the status of user name caching.
For a complete list of valid configuration variables, click the link Content Gateway variables and navigate to the records.config topic. [You may be asked for credentials if you have not logged on to the proxy console earlier in the session.]
Example: Enter the variable name proxy.config.arm.enabled and the value "1" or "0".
For a complete list of valid configuration variables, click the link records.config. [You may be asked for credentials if you have not logged on to the proxy console earlier in the session.]
If you have used content_line -s to change the setting of any variables in the file records.config, you can activate your changes immediately (without restarting the proxy) by running this command.
[Action]: Enter enable to enable the directory agent service.
Enter disable to disable the directory agent service.
Note: If the network is unreachable, the command takes 30 minutes to timeout.
Use ethtool to verify local network connectivity. For example, if the ping command fails, use this to determine if you are using the right IP address.
Enter all to display all interface status.
[Action]: Enter enable to enable the Multiplexer service.
Enter disable to disable the Multiplexer service.
netstat -nItup displays the following:
nslookup lets you query DNS servers to find DNS details, including IP addresses of a particular computer, MX records for a domain, and the DNS servers of a domain.
Use ping for IPv4 addresses, and ping6 for IPv6 addresses.
Note: ping6 is not supported in the TRITON AP-WEB module.
Use ping for IPv4 addresses, and ping6 for IPv6 addresses.
Note: ping6 -I is not supported in the TRITON AP-WEB module.
Example: eth0
For more information on source and destination bypass, see the Configuration Files > bypass.config section of the Content Gateway manager Help system.
This command supports all of the add route parameters that are supported on the Configuration > Routing page of the V-Series manager. In addition, this command supports the ability to specify the maximum segment size (MSS).
[Action]: Enter enable to enable the state server service.
Enter disable to disable the state server service.
tcpdump intercepts and displays packets being transmitted or received by the specified network interface. Use the Expression field to select which packets are displayed.
The output from tcpdump can help you determine whether all routing is occurring properly, to and from the interface. The output is verbose; it displays the data of each package in both hex and ASCII; and it includes a link-level header on each line.
Example: eth0
Example 1: To capture all TCP traffic to and from the proxy on port 8080, enter this expression:
Example 2: To capture all TCP traffic to the site google.com, enter this expression:
Example 3: To capture all TCP traffic from a specific end-user machine, enter this expression:
To download the file, click the link, Download output file for last command, after running the command. This link is under the console output window.
Enter all to capture all packets.
If you are having latency issues, traceroute can also help identify the causes.
Use traceroute for IPv4 addresses, and traceroute6 for IPv6 addresses.
Note: traceroute is of limited utility if an IP address is being spoofed.
Note: traceroute6 is not supported in the TRITON AP-WEB module.
[Action]: Enter enable to modify the precedence order to: User > Group > Domain > Computer > Network
Enter disable (default) to set the precedence order to: User > Computer > Network > Group > Domain
Enter status to display the current setting.
WARNING: Changing the state of user-group-ip-precedence causes Filtering Service to stop and restart.
Use wget, for example, if you have configured the proxy, but cannot access the Web. wget simulates the proxy going out and retrieving the Web site.
Use wget, for example, if you have configured the proxy, but cannot access the Web. wget simulates the proxy going out and retrieving the Web site.

Go to the table of contents Go to the previous page Go to the next page View or print as PDF
Administration > Toolbox > Appliance command line
Copyright 2016 Forcepoint LLC. All rights reserved.