ADC

Installing and configuring the NSLOG server

September 14, 2021

Contributed by:

S S C

During installation, the NSLOG server executable file (auditserver) is installed along with other files. The auditserver executable file includes options for performing several actions on the NSLOG server, including running and stopping the NSLOG server. In addition, you use the auditserver executable to configure the NSLOG server with the IP addresses of the Citrix ADC appliances from which the NSLOG server will start collecting logs. Configuration settings are applied in the NSLOG server configuration file (auditlog.conf).

Then, you start the NSLOG server by executing the auditserver executable. The NSLOG server configuration is based on the settings in the configuration file. You can further customize logging on the NSLOG server system by making additional modifications to the NSLOG server configuration file (auditlog.conf).

Attention:

The version of the NSLOG server package must be the same as that of the Citrix ADC. For example, if the version of the Citrix ADC is 10.1 Build 125.9, the NSLOG server must also be of the same version.

The following table lists the operating systems on which the NSLOG server is supported.

Operating system	Software requirements	Remarks
Windows	Windows XP Professional, Windows Server 2003, Windows 2000/NT, Windows Server 2008, Windows Server 2008 R2
Linux	RedHat Linux 4 or later, SUSE Linux Enterprise 9.3 or later
FreeBSD	FreeBSD 6.3 or later	For Citrix ADC 10.5, use only FreeBSD 8.4.
Mac OS	Mac OS 8.6 or later	Not supported on Citrix ADC 10.1 and later releases.

The minimum hardware specifications for the platform running the NSLOG server are as follows:

Processor- Intel x86 ~501 megahertz (MHz)
RAM - 512 megabytes (MB)
Controller - SCSI

Installing NSLOG server on the Linux operating system

Log on to the Linux system as an administrator. Use the following procedure to install the NSLOG server executable files on the system.

To install the NSLOG server package on a Linux operating system

At a Linux command prompt, type the following command to copy the NSauditserver.rpm file to a temporary directory:

cp <path_to_cd>/Utilities/auditserver/Linux/NSauditserver.rpm /tmp
Type the following command to install the NSauditserver.rpm file.

rpm -i NSauditserver.rpm

This command extracts the files and installs them in the following directories:
- /usr/local/netscaler/etc
- /usr/local/netscaler/bin
- /usr/local/netscaler/samples

To uninstall the NSLOG server package on a Linux operating system

At a command prompt, type the following command to uninstall the audit server logging feature:

rpm -e NSauditserver
For more information about the NSauditserver RPM file, use the following command:

rpm -qpi \*.rpm
To view the installed audit server files use the following command:

rpm -qpl *.rpm

*.rpm: Specifies the file name.

Installing NSLOG server on the FreeBSD operating system

Before you can install the NSLOG server, you have to copy the NSLOG package from the Citrix ADC product CD or download it from www.citrix.com. The NSLOG package has the following name format:

AuditServer_<release number>-<build number>.zip

For example: AuditServer_10.5-58.11.zip

This package contains files for all supported platforms: Linux, Windows, and FreeBSD. On a FreeBSD operating system, install the NSLOG package that has the following name format:

audserver_bsd-<release number>-<build number>.tgz

For example: audserver_bsd-10.5-58.11.tgz

To download NSLOG package from www.citrix.com:

In a web browser, go to www.citrix.com.
In the menu bar, click Log In.
Enter your login credentials, and then click Log In.
In the menu bar, click Downloads.
From the Select a product list, select Citrix ADC.
On the Citrix ADC page, select the release for which you want to download the NSLOG package (for example, Release 10.5), and then select Firmware.
Under Firmware, select the Citrix ADC firmware for the build number for which you want to download the NSLOG package.
On the page that appears, scroll down, select Audit Servers, and click Download File next to the package that you want to download.

To install the NSLOG server package on a FreeBSD operating system

On the system to which you have downloaded the NSLOG package AuditServer_<release number>-<build number>.zip (for example, AuditServer_9.3-51.5.zip), extract the FreeBSD NSLOG server package audserver_bsd-<release number>-<build number>.tgz (for example, audserver_bsd-9.3-51.5.tgz) from the package.
Copy the FreeBSD NSLOG server package audserver_bsd-<release number>-<build number>.tgz (for example, audserver_bsd-9.3-51.5.tgz) to a directory on a system running FreeBSD OS.
At a command prompt for the directory into which the FreeBSD NSLOG server package was copied, run the following command to install the package:

pkg_add audserver_bsd-<release number>-<build number>.tgz

Example:
```
pkg_add audserver_bsd-9.3-51.5.tgz

```
The following directories are extracted:
- <root directory extracted from the FreeBSD NSLOG server package tgz file>Citrix ADCbin (for example, /var/auditserver/netscaler/bin)
- <root directory extracted from the FreeBSD NSLOG server package tgz file>netscaler/etc (for example, /var/auditserver/netscaler/etc)
- <root directory extracted from the FreeBSD NSLOG server package tgz file>\netscaler\samples (for example, /var/auditserver/samples)
At a command prompt, type the following command to verify that the package is installed:

pkg_info | grep NSaudserver

To uninstall the NSLOG server package on a FreeBSD operating system

At a command prompt, type:

pkg_delete NSaudserver

Installing NSLOG Server Files on the Windows Operating System

Before you can install the NSLOG server, you have to copy the NSLOG package from the Citrix ADC product CD or download it from www.citrix.com. The NSLOG package has the following name format AuditServer _<release number>-<build number>.zip (for example, AuditServer_9.3-51.5.zip). This package contains NSLOG installation packages for all supported platforms.

To download NSLOG package from www.Citrix.com

In a web browser, go to www.citrix.com.
In the menu bar, click Log In.
Enter your login credentials, and then click Log In.
In the menu bar, click Downloads.
Search to find the page that provides the appropriate release number and build.
On that page, under Audit Servers, click Download to download the NSLOG package, having the format AuditServer_<release number>-<build number>.zip , to your local system (for example, AuditServer_9.3-51.5.zip ).

To install NSLOG server on a Windows operating system

On the system, where you have downloaded the NSLOG package AuditServer_<release number>-<build number>.zip (for example, AuditServer_9.3-51.5.zip), extract audserver_win-<release number>-<build number>.zip (for example, audserver_win-9.3-51.5.zip) from the package.
Copy the extracted file audserver_<release number>-<build number>.zip (for example, audserver_win-9.3-51.5.zip) to a Windows system on which you want to install the NSLOG server.
Unzip the audserver_<release number>-<build number>.zip file (for example, audserver_win-9.3-51.5.zip).
The following directories are extracted:
1. <root directory extracted from the Windows NSLOG server package zip file>\bin(for example, C:\audserver_win-9.3-51.5\bin)
2. <root directory extracted from the Windows NSLOG server package zip file>\etc (for example, C:\audserver_win-9.3-51.5\etc )
3. <root directory extracted from the Windows NSLOG server package zip file>\samples (for example, C:\audserver_win-9.3-51.5\samples)
At a command prompt, run the following command from the <root directory extracted from the Windows NSLOG server package zip file>\bin path

audserver -install -f <directorypath>\auditlog.conf

<directorypath>: Specifies the path to the configuration file ( auditlog.conf). By default, log.conf is under \<root directory extracted from Windows NSLOG server package zip file\>\samples directory. But you can copy auditlog.conf to your desired directory.

To uninstall the NSLOG server on a Windows operating system

At a command prompt, run the following from the <root directory extracted from Windows NSLOG server package zip file>\bin path:

audserver -remove

NSLOG Server Command Options

For information about NSLOG server commands, see Audit Server Options.

Run the audserver command from the directory in which the audit server executable is present:

On Windows: \ns\bin
On Solaris and Linux:\usr\local\netscaler\bin

The audit server configuration files are present in the following directories:

On Windows: \ns\etc
On Linux: \usr\local\netscaler\etc

The audit server executable is started as ./auditserver in Linux and FreeBSD.

Adding the Citrix ADC Appliance IP Addresses on the NSLOG Server

In the configuration file ( auditlog.conf), add the IP addresses of the Citrix ADC appliances whose events must be logged.

To add the IP addresses of the Citrix ADC appliance

At a command prompt, type the following command:

audserver -addns -f <directorypath\>\auditlog.conf

<directorypath>: Specifies the path to the configuration file (auditlog.conf).

You are prompted to enter the information for the following parameters:

NSIP: Specifies the IP address of the Citrix ADC appliance, for example, 10.102.29.1.

Userid: Specifies the user name, for example, nsroot.

Password: Specifies the password, for example, nsroot.

If you add multiple Citrix ADC IP addresses (NSIP), and later you do not want to log all of the Citrix ADC appliance event details, you can delete the NSIPs manually by removing the NSIP statement at the end of the auditlog.conf file. For a high availability (HA) setup, you must add both primary and secondary Citrix ADC IP addresses to auditlog.conf by using the audserver command. Before adding the IP address, make sure the user name and password exist on the system.

Verifying the NSLOG Server Configuration File

Check the configuration file (audit log.conf) for syntax correctness to enable logging to start and function correctly.

To verify configuration, at a command prompt, type the following command:

audserver -verify -f <directorypath>\auditlog.conf

<directorypath>: Specifies the path to the configuration file (audit log.conf).

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Installing and configuring the NSLOG server

September 14, 2021

Contributed by:

S S C

September 14, 2021

Contributed by:

S S C

Installing NSLOG server on the Linux operating system
Installing NSLOG server on the FreeBSD operating system
Installing NSLOG Server Files on the Windows Operating System
NSLOG Server Command Options
Adding the Citrix ADC Appliance IP Addresses on the NSLOG Server
Verifying the NSLOG Server Configuration File

Installing and configuring the NSLOG server

Installing NSLOG server on the Linux operating system

To install the NSLOG server package on a Linux operating system

To uninstall the NSLOG server package on a Linux operating system

Installing NSLOG server on the FreeBSD operating system

To uninstall the NSLOG server package on a FreeBSD operating system

Installing NSLOG Server Files on the Windows Operating System

To download NSLOG package from www.Citrix.com

To install NSLOG server on a Windows operating system

To uninstall the NSLOG server on a Windows operating system

NSLOG Server Command Options

Adding the Citrix ADC Appliance IP Addresses on the NSLOG Server

To add the IP addresses of the Citrix ADC appliance

Verifying the NSLOG Server Configuration File

In this article