# Using the Desktop Tool for Viewing Uncompressed Text Configuration

You can use a desktop tool that resides on your local client system to view the text configuration embedded in the system configuration file. You need to copy the system configuration file to your client system and run the desktop tool to view the uncompressed text configuration. This tool uses an executable to decompress the output of the show configuration command in the system configuration file. This executable is generated using the freely available GNU gcc compiler, which is platform-specific. The tool generates a temporary file in the directory where the Perl script is being run during the process of execution.

The desktop tool does not perform any CRC checking of the system configuration file before decompressing it. If the compressed data in the system configuration file is corrupt, a compression failure message is displayed. You must configure execute permisions for the files and executables that you install from software image bundle that you downloaded from the Juniper Networks website or from the software CD that you created from the downloaded bundle.

## Installation Prerequisites for the Desktop Tool

The desktop tool has the following prerequisites for the installation of necessary executables, depending on the operating system that is running on your client system:

### Requirements for Microsoft Windows Systems

The desktop tool has the following requirements for client systems running on Microsoft Windows platform:

1. The tool to extract the decompressed text configuration must be run in a shell environment. If a shell environment is not available on your Windows XP and Windows Vista system, you can download and install the Cygwin software from the following site:

   http://www.cygwin.com/setup.exe

2. You must install the GCC compiler from the following site:

   http://www.mingw.org/

   This compiler is required to run the tool on all Windows platforms.

3. Choose the option to install "g++ compiler" when prompted during installation. The PATH environment variable must be set properly for the GCC compiler.

   If Perl libraries are not available on your Windows XP and Windows Vista platforms, you must install Active Perl from the following site:

   http://www.activestate.com

### Requirements for Sun Solaris Systems

The desktop tool has the following requirements for client systems running on Sun Solaris platforms. You must have execute permissions for the files.

1. By default, the GCC compiler is not available on Solaris 9 and Solaris 10 platforms, but is required to run the desktop tool on Solaris platforms. Install the compiler from the following site:

   http://www.sunfreeware.com/

   For example, type /usr/sbin/pkgadd -d gcc-3.4.6-sol10-x86-local.

2. If the Solaris patch is not available by default on your client system, install it from the following site:

   http://www.sunfreeware.com/

   For example, type/usr/sbin/pkgadd -d libiconv-1.11-sol10-x86-local.

3. Set the LD_LIBRARY_PATH environment variable by issuing the following command:

   export LD_LIBRARY_PATH = "/usr/local/bin"

   where /user/local/bin is the directory in which the libraries are bundled.

### Requirements for Linux Systems

The GCC compiler is available with Linux 5.0 and Linux 5.1 platforms. If the GCC compiler is not installed on your Linux system, install the required RPMs from the Linux installation disk. Perl is also available with Linux 5.0 and Linux 5.1 installation.

## Usage Notes for the Perl Script

Issue the following command from the directory in which Perl is installed on your system:

perl_install_dir extractScrFromCnf.pl combinedCnf File

where

- perl_install_dir is the directory in which Perl is installed. You can find this directory by issuing the which perl command from the command prompt.
- extractScrFromCnf.pl is the Perl script that extracts the text configuration portion from the system configuration file.
- combinedCnf File is the .cnf file generated in compressed format that includes the text configuration.

We recommend that you copy the combinedCnf File to the directory in which the extractScrFromCnf.pl script is stored.