Symantec Security 5600 Series, Security 5400 Series,Clientless VPN 4400 Series, Administration Manual

Page: 561 / 861

560 Troubleshooting and problem solving
Troubleshooting utilities
Troubleshooting utilities
This section provides details on utility programs that are shipped with the security gateway. These
utilities let you perform command-line troubleshooting and diagnostic tasks. You must have solid
networking background to use these utilities. If necessary, contact Symantec Technical Support before
using the utilities described in this section.
Setting up the flatten utility
Flatten is a command-line utility that formats the log files to be more easily read and processed by a
third-party database management system or by operating system utilities. You can install flatten on
Microsoft Windows, Sun Solaris, and Linux operating systems. Flatten is shipped on the appliance.
If the output of flatten contains International Domain Names (IDN) in the log messages, those
messages will be output in UTF-8 (UCS Transformation Format 8), which is a way to display
international characters. You can read these files using a viewer such as Notepad, Microsoft Word, or
by selecting UTF-8 in your browser. Linux users can view these messages using a a UTF-8 enabled
terminal window or other appropriate viewer.
Ensure that your LANG environment variable is set to ““ or “en_US.UTF-8” before running flatten or
remotelogfile.
Note: Use the version of flatten that comes with the version of your appliance.
Note:
You must install and configure X-Windows to use the remote tools in a Linux environment.
To set up the flatten utility
1
Do one of the following:
■
For a Microsoft Windows operating systems, unzip the remote log bundle to any location.
Using the command-line, run it from there.
■
For Sun Solaris/Linux operating systems the remote log tar bundle should be untarred into
any temporary directory. In addition you should copy the binaries remotelogfile8,
remotelogdir8, and clientrempass to someplace in your path. Also, copy the libraries
libSesaXmlParser.so, libIdsXmlParser.so, and libxerces-c1_6_0.so to either /lib for Linux or /
usr/lib for Solaris.
2 For all platforms, you need to provide the path (relative or absolute) to the XML files in lang/*.
Once you have unzipped or untarred these files, they can be moved, just remember where they are.
Flatten will only work with 8.x logfiles or later.
Using the flatten commands
Use the following command when using flatten.
flatten [-h] [-r|-s|-D] [-b [-i]] [-f] [-u seconds] [-t n] [-o n] [-O time] [a] [-x
xmlpath]
Where:
-h Print this message and exit.
-r Do reverse lookups on IP addresses (only has an effect when -s is used).
-s Output stats only.
-D Do not print out error information.