Installing the NSWL files on the Logging System

Installing the NSWL files on the Logging System

This describes the steps to install the NetScaler Web Server Logging executable files (NSWL) on various operating systems (logging systems). Copy the installation files from the product CD or download them from ftp.netscaler.com. Run the installations from a root user account. In the procedures described in the following subsections, <path_to_cd> defines the system path to the drive where the CD device is mounted.

Installing NSWL on a Solaris Operating System

Use the following procedure to install the nswl executable and other files on a computer running the Solaris operating system.

To install NSWL on a Solaris operating system

1. Copy the NSweblog.tar file into a temporary directory using the command:

cp <path_to_cd>/Utilities/weblog/Solaris/NSweblog.tar /tmp

2. Change to the temporary directory:

cd /tmp

3. Extract the files from the *.tar file with the following command:

tar xvf NSweblog.tar

A directory NSweblog is created in the temporary directory, and the files are extracted to the NSweblog directory.

4. Install the package with the following command:

pkgadd -d .

The list of available packages appears. In the following example, one NSweblog package is shown:

1 NSweblog NetScaler Weblogging

(SunOS,sparc) 7.0

5. You are prompted to select the packages. Select the package number of the NSweblog to be installed.

After you select the package number and press Enter, the files are extracted and installed in the following directories. (The dot indicates the current directory.)

• /usr/local/netscaler/etc

• /usr/local/netscaler/bin

• /usr/local/netscaler/samples

6. To verify that the package is installed, enter the following command:

pkginfo | grep NSweblog

Installing NSWL on a Linux Operating System

Use the following procedure to install the nswl executable and the other files on a computer running the Red Hat™ Linux® operating system.

To install NSWL on a Linux operating system

1. Copy the NSweblog.rpm file into a temporary directory:

cp <path_to_cd>/Utilities/weblog/Linux/NSweblog.rpm /tmp

2. To install the nswl executable, use the following command:

rpm -i NSweblog.rpm

This command extracts the files and installs them in the following directories. (The dot indicates the current directory.)

• /usr/local/netscaler/etc

• /usr/local/netscaler/bin

• /usr/local/netscaler/samples.

To uninstall web server logging, use the following command.

rpm -e NSweblog

To get more information on the NSweblog RPM file, use the following command.

rpm -qpi *.rpm.

To view the installed web server logging files, use the following command (*.rpm is the file name).

rpm -qpl *.rpm

Installing NSWL on a FreeBSD Operating System

Use the following procedure to install the nswl executable and the other files on a computer running the FreeBSD 4.4 operating system.

To install NSWL on a FreeBSD operating system

1. At a command prompt, copy the NSweblog.tgz file into a temporary directory:

cp <path_to_cd>/Utilities/weblog/Freebsd/NSweblog.tgz /tmp

2. Change to the temporary directory:

cd /tmp

3. Install the package using the following command:

pkg_add NSweblog.tgz

This command extracts the files and installs them in the following directories. (The dot indicates the current directory.)

• /usr/local/netscaler/etc

• /usr/local/netscaler/bin

• /usr/local/netscaler/samples

4. To verify that the package is installed, use the following command:

pkg_info | grep NSweblog

Installing NSWL on a MAC Operating System

Use the following procedure to install the nswl executable and the other files on a computer running the MAC operating system.

To install NSWL on a MAC operating system

1. At a command prompt, copy the NSweblog.tgz file into a temporary directory with the following command:

cp <path_to_cd>/Utilities/weblog/macos/NSweblog.tgz /tmp

2. Change to the temporary directory:

cd /tmp

3. To install the package, use the pkg_add command:

pkg_add NSweblog.tgz

This command extracts the files and installs them in the following directories. (The dot indicates the current directory.)

• /usr/local/netscaler/etc

• /usr/local/netscaler/bin

• /usr/local/netscaler/samples

4. To verify that the package is installed, use the follwoing command:

pkg_info | grep NSweblog

Installing NSWL on a Windows Operating System

Use the following procedure to install the nswl executable and the other files on a computer running the Windows operating system.

To install NSWL on a Windows operating system

1. Copy the NSweblog.exe file (winzip executable) into a temporary directory.

2. The extracted files are installed in the following directories. (The dot indicates the current directory.)

• \NS\BIN

• \NS\ETC

• \NS\SAMPLES

3. To install web server logging as a service, at a command prompt, run the following command from the \NS\BIN path:

nswl -install -f <directorypath> \log.conf

<directorypath> specifies the path where the log.conf file is available.

4. To uninstall the web server logging, run the following command from the \NS\BIN folder:

nswl -remove

Installing NSWL on an AIX Operating System

Use the following procedure to install the nswl executable and the other files on a computer running the AIX operating system.

To install NSWL on an AIX operating system

1. Copy the NSweblog.rpm file into a temporary directory:

cp <path_to_cd>/Utilities/weblog/AIX/NSweblog.rpm /tmp

2. To install the nswl executable, use the following command:

rpm -i NSweblog.rpm

This command extracts the files and installs them in the following directories. (The dot indicates the current directory.)

• /usr/local/netscaler/etc

• /usr/local/netscaler/bin

• /usr/local/netscaler/samples.

To uninstall web server logging, use the following command.

rpm -e NSweblog

To get more information on the NSweblog RPM file, use the following command.

rpm -qpi *.rpm.

To view the installed web server logging files, use the following command (*.rpm is the file name).

rpm -qpl *.rpm

NSWL Options

The following table describes the options that you can use with the nswl executable.

nswl Command:

nswl -help

nswl -addns -f <path to configuration file>

nswl -verify -f <path to configuration file>

nswl -start -f <path to configuration file>

nswl -stop

nswl -install -f <path to configuration file> (Windows only)

nswl -startservice (Windows only)

nswl -stopservice (Windows only)

nswl -remove

Specifies:

Display all available nswl options

The system that gathers the log transaction data. You are prompted to enter the IP address of the system. Enter a valid username and password.

Check for syntax or semantic errors in the configuration file (for example, log.conf).

Start web server logging based on the settings in the configuration file (for example, log.conf).

For Solaris and Linux: To start web server logging as a background process, use and at the end of the command..

Solaris and Linux only

Stop web server logging, if nswl was started as a background process; otherwise, use CTRL+C to stop web server logging.

Installs the web server logging client as a service in Windows.

Start web server logging , using the settings in the configuration file (for example, log.conf) specified in the nswl install option.

Web server logging can also be started from Start > Control Panel > Services.

Stop Web server logging.

Remove the web server logging service from the registry.

Run the following commands from the directory in which the nswl executable is located:

• Windows: \ns\bin

• Solaris and Linux: \usr\local\netscaler\bin

The web server logging configuration files are located in the following directory path:

• Windows: \ns\etc

• Solaris and Linux: \usr\local\netscaler\etc

The nswl executable is started as .\nswl in Linux and Solaris.