Citrix NetScaler Administration Guide
Copyright and Trademark Notice
Page
Page
Contents
Snmp
Vii
Audit Logging
Web Server Logging
105
Advanced Configurations
Contents
Web Interface
AppFlow
Reporting Tool
Contents Xvi
This Preface
Formatting Conventions for NetScaler Documentation
Formatting Conventions Meaning Boldface
Convention
Documentation Available on the NetScaler Appliance
To view the documentation
NetScaler Documentation Feedback
Getting Service and Support
To provide feedback at the Knowledge Center home
Preface
Authentication and Authorization
Topics
Configuring User Accounts
Configuring Users and Groups
Show system user Example
Parameters for configuring a user account
Password Password
Timeout CLI Idle Session Timeout Secs
UserName User Name
To create a user group by using the NetScaler command line
Configuring User Groups
Show system group Example
Show system group groupName Example
Parameters for configuring a user group
Show system group groupName
GroupName Group Name
UserName
Built-in Command Policies
Configuring Command Policies
CLI Prompt CLI Idle Session Timeout Secs
Creating Custom Command Policies
Built-in Command Policies Policy name Allows
Except show runningconfig, show
Runningconfig, and sh gslb
Matches these commands
Command specification regular expression
Parameters for configuring a command policy
Sh system cmdPolicy Example
Policyname
Action
Binding Command Policies to Users and Groups
Parameters for binding a command policy to a user
Sh system user userName Example
Sh system user userName
Priority
Parameters for binding a command policy to a group
Sh system group groupName Example
Sh system group groupName
GroupName
Resetting the Default Administrator nsroot Password
To reset the nsroot password
Example of a User Scenario
Fsck /dev/ad0s1a Mount /dev/ad0s1a /flash
Configuration steps
Sample Values for Creating Entities Field
Configuring External User Authentication
Configuring Ldap Authentication
Examples of Bind Distinguished Name Ldap server
Examples of Base Distinguished Name Ldap server Base DN
Bind DN
Authentication Type, select LDAP. Next to Server, click New
Determining attributes in the Ldap directory
Choosing Radius authentication protocols
Configuring Radius Authentication
Authentication Type, select Radius
Configuring IP address extraction
Configuring NT4 Authentication
Configuring TACACS+ Authentication
Authentication Type, select Tacacs
Authentication Type, select NT4
Authentication and Authorization
Snmp
Importing MIB Files to the Snmp Manager and Trap Listener
Enabling or Disabling an Snmp Alarm
Enable snmp alarm alarm name Sh snmp alarm alarm name
Configuring Alarms
To configure an Snmp alarm by using the command line
Parameters for configuring Snmp alarms
Severity
To configure Snmp alarms by using the configuration utility
Configuring Traps
To add an Snmp trap by using the NetScaler command line
Parameters for configuring Snmp traps
To configure Snmp Traps by using the configuration utility
Enabling Unconditional Snmp Trap Logging
Configuring the NetScaler for Snmp v1 and v2 Queries
Specifying an Snmp Manager
Parameters for unconditional Snmp trap logging
SnmpTrapLogging Snmp Trap Logging
To add an Snmp manager by using the NetScaler command line
Show snmp manager
Parameters for configuring an Snmp manager
IPAddress
To add an Snmp manager by using the configuration utility
Parameters for configuring an Snmp community string
Specifying an Snmp Community
Sh snmp community
Permissions
Configuring an Snmp Alarm for Throughput or PPS
Configuring Snmp Alarms for Rate Limiting
Community String*-communityName
Show snmp alarm PF-RL-RATE-THRESHOLD
Show snmp alarm PF-RL-PPS-THRESHOLD
ThresholdValue
NormalValue
State
Configuring Snmp Alarm for Dropped Packets
Alarm Threshold-thresholdValue Normal Threshold-normalValue
Configuring the NetScaler for SNMPv3 Queries
Parameters for configuring an Snmp alarm for dropped packets
Setting the Engine ID
Configuring a View
To set the engine ID by using the NetScaler command line
Parameters for setting the engine ID
To set the engine ID by using configuration utility
Parameters for configuring an Snmp view
Configuring a Group
To add an Snmp group by using the NetScaler command line
Configuring a User
Parameters for configuring an Snmp group
To configure a user by using the NetScaler command line
SecurityLevel
Parameters for configuring an Snmp user
Citrix NetScaler Administration Guide
Snmp
Audit Logging
Audit Logging
Configuring Audit Servers
Configuring the NetScaler Appliance for Audit Logging
Show audit syslogAction name
Parameters for configuring auditing servers
Show audit nslogAction name
ServerIP
ServerPort
Log levels defined
To configure an auditing server action
Configuring Audit Policies
To configure a Syslog policy by using the command line
Parameters for configuring audit policies
To configure an Nslog policy by using the command line
Rule
To configure an audit server policy
Binding the Audit Policies Globally
Parameters for binding the audit policies globally
Name* name Server* action
Configuring Policy-Based Logging
Configuring an Audit Message Action
To globally bind the audit policy
Pre Requisites
StringBuilderExpr
BypassSafetyCheck
LogtoNewnslog
Installing and Configuring the Nslog Server
Binding Audit Message Action to a Policy
Supported Platforms for the Nslog Server Operating system
Installing Nslog Server on the Linux Operating System
Software requirements
Installing Nslog Server on the FreeBSD Operating System
Pkginfo grep NSaudserver
Pkgdelete NSaudserver
To install Nslog server on a Windows operating system
On the system, where you have downloaded the Nslog package
Nslog Server Command Options
To uninstall the Nslog server on a Windows operating system
Audserver -remove
Audserver -stop
To add the IP addresses of the NetScaler appliance
Audserver -remove Specifies
Running the Nslog Server
Verifying the Nslog Server Configuration File
To start audit server logging
Creating Filters
Customizing Logging on the Nslog Server
To create a filter
Specifying Log Properties
Default Settings for the Log Properties
Sample Configuration File audit.conf
Following is a sample configuration file
Web Server Logging
Configuring the NetScaler Appliance for Web Server Logging
Enabling or Disabling Web Server Logging
Modifying the Default Buffer Size
Parameter for modifying the buffer size
Sh weblogparam Example
Buffer Size
To modify the buffer size by using the configuration utility
Supported Platforms for the Nswl Client Operating system
Hardware requirements
Installing Nswl Client on a Solaris Operating System
Cp pathtocd/Utilities/weblog/Solaris/NSweblog.tar /tmp
Installing Nswl Client on a Linux Operating System
Cd /tmp
Tar xvf NSweblog.tar
Pkginfo grep NSweblog
To view the installed Web server logging files
Installing Nswl Client on a FreeBSD Operating System
To get more information about the NSweblog RPM file
Pkgdelete NSweblog
Installing Nswl Client on a Mac OS Operating System
Cp pathtocd/Utilities/weblog/macos/NSweblog.tgz /tmp
Installing Nswl Client on a Windows Operating System
To install the Nswl client on a Windows system
Installing Nswl Client on an AIX Operating System
To uninstall the Nswl client on a Windows system
Cp pathtocd/Utilities/weblog/AIX/NSweblog.rpm /tmp
Rpm -i NSweblog.rpm
Nswl Client Command Options
Nswl Command Options Nswl command Specifies
To add the Nsip address of the NetScaler appliance
Adding the IP Addresses of the NetScaler Appliance
Nswl -addns -f directorypath \log.conf
Verifying the Nswl Configuration File
To verify the configuration in the Nswl configuration file
Running the Nswl Client
Customizing Logging on the Nswl Client System
Parameters for Creating a Filter Specifies
On OFF
To create a filter for a virtual server
LogFormat Ncsa
Understanding the Ncsa and W3C Log Formats
Ncsa Common Log Format
W3C Extended Log Format
Ncsa Common Log Format Argument Specifies
Directives
Entries
Directive Descriptions
Fields
Identifiers
Prefix Descriptions Specifies
Examples
W3C Extended Log Format Identifiers No Prefix Required
Description
Creating a Custom Log Format
Creating a Custom Log Format by Using the Nswl Library
Field Description
To create the custom log format by using the Nswl Library
Creating a Custom Log Format Manually
Sample Configuration File
Creating Apache Log Formats
Ncsa
Arguments for Defining a Custom Log Format
11.Custom Log Format Argument Specifies
Foobari Foobaro
Formatt
Time Format Definition
12.Time Format Definition Argument Specifies
Argument Specifies
123
Web Server Logging 124
Advanced Configurations
To add an NTP server by using the NetScaler command line
Configuring Clock Synchronization
Show ntp server Example
Parameters for configuring an NTP server
ServerName
Minpoll
Maxpoll
Enable ntp sync Disable ntp sync
Configuring Clock Synchronization Manually
Starting or Stopping the NTP Daemon
Show ns config Example
Usr/sbin/ntpd -c /nsconfig/ntp.conf -l /var/log/ntpd.log
Viewing the System Date and Time
Configuring TCP Window Scaling
Show ns tcpParam Example
Parameters for configuring window scaling
WSVal
Configuring Selective Acknowledgment
Enabled
Clearing the Configuration
To enable Sack by using the Configuration Utility
Parameters for clearing a configuration
To clear a configuration by using the configuration utility
Viewing the Http Band Statistics
Level
ReqBandSize
RespBandSize
Configuring Http Profiles
To modify the band range by using the configuration utility
To add an Http profile by using the NetScaler command line
Built-in Http Profiles Built-in profile Description
Parameters for adding an Http profile
To add an Http profile by using the configuration utility
Configuring TCP Profiles
Built-in TCP Profiles Built-in profile Description
To add a TCP profile by using the NetScaler command line
Parameters for creating a TCP profile
To add a TCP profile by using the configuration utility
Specifying a TCP Buffer Size
Example
Parameters for setting the TCP buffer size in a TCP profile
BufferSize
Parameters for specifying the MSS value in a TCP profile
Specifying the MSS Value in a TCP Profile
Mss
Learn MSS for VServer
LearnVsvrMSS
Advanced Configurations 148
Web Interface
How Web Interface Works
Prerequisites