Citrix Systems CITRIX NETSCALER 9.3 instruction

Citrix NetScaler Administration Guide

To uninstall the NSWL client package on a Mac OS operating system

At a command prompt, type:

pkg_delete NSweblog

Installing NSWL Client on a Windows Operating System

Before installing the NSWL client, you have to copy the NSWL client package from the NetScaler product CD or download it from www.citrix.com. The NSWL client package has the following name format:

Weblog_<release number>-<build number>.zip (for example, Weblog_9.3-51.5.zip). Within the package are separate installation packages for each supported platforms.

To download NSWL client package from www.Citrix.com

1.From any system, open www.citrix.com in the Web browser.

2.In the menu bar, click Log In.

3.Enter your login credentials and then click Log In.

4.In the menu bar, click Downloads .

5.Search to the page of the desired release number and build.

6.On the desired page, under Weblog Clients, click Download to download a file, having the format Weblog_<release number>-<build number>.zip, to your local system (for example, Weblog_9.3-51.5.zip ).

To install the NSWL client on a Windows system

1.On the system, where you have downloaded the NSWL client package

Weblog_<release number>-<build number>.zip (for example, Weblog_9.3-51.5.zip), extract nswl_win-<release number>-<build number>.zip (for example, nswl_win-9.3-51.5.zip ) from the package.

2.Copy the extracted file nswl_win-<release number>-<build number>.zip

(for example, nswl_win-9.3-51.5.zip) to a Windows system on which you want to install the NSWL client.

3.On the Windows system, unzip the nswl_<release number>-<build number>.zip file (for example , nswl_win-9.3-51.5.zip ). The following directories are extracted:

a.<root directory extracted from the Windows NSWL client package zip file>\bin (for example, C:\nswl_win-9.3-51.5\bin )

101

Image 101

Citrix Systems CITRIX NETSCALER 9.3 manual Installing Nswl Client on a Windows Operating System

Contents

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 Formatting Conventions Meaning Boldface Formatting Conventions for NetScaler DocumentationThis Preface To view the documentation Documentation Available on the NetScaler ApplianceConvention To provide feedback at the Knowledge Center home Getting Service and SupportNetScaler Documentation Feedback Preface Topics Authentication and Authorization Show system user Example Configuring Users and GroupsConfiguring User Accounts Password Password Parameters for configuring a user accountTimeout CLI Idle Session Timeout Secs UserName User Name Show system group Example Configuring User GroupsTo create a user group by using the NetScaler command line Show system group groupName Example Show system group groupName Parameters for configuring a user groupGroupName Group Name UserName CLI Prompt CLI Idle Session Timeout Secs Configuring Command PoliciesBuilt-in Command Policies Built-in Command Policies Policy name Allows Creating Custom Command PoliciesExcept show runningconfig, show Runningconfig, and sh gslb Command specification regular expression Matches these commands Sh system cmdPolicy Example Parameters for configuring a command policyPolicyname Action Binding Command Policies to Users and Groups Sh system user userName Example Parameters for binding a command policy to a userSh system user userName Priority Sh system group groupName Example Parameters for binding a command policy to a groupSh system group groupName GroupName To reset the nsroot password Resetting the Default Administrator nsroot Password Fsck /dev/ad0s1a Mount /dev/ad0s1a /flash Example of a User Scenario Sample Values for Creating Entities Field Configuration steps Configuring External User Authentication Configuring Ldap Authentication Bind DN Examples of Base Distinguished Name Ldap server Base DNExamples of Bind Distinguished Name Ldap server Authentication Type, select LDAP. Next to Server, click New Determining attributes in the Ldap directory Authentication Type, select Radius Configuring Radius AuthenticationChoosing Radius authentication protocols Configuring IP address extraction Authentication Type, select Tacacs Configuring TACACS+ AuthenticationConfiguring NT4 Authentication Authentication Type, select NT4 Authentication and Authorization Snmp Importing MIB Files to the Snmp Manager and Trap Listener Enable snmp alarm alarm name Sh snmp alarm alarm name Enabling or Disabling an Snmp Alarm To configure an Snmp alarm by using the command line Configuring AlarmsParameters for configuring Snmp alarms Severity To add an Snmp trap by using the NetScaler command line Configuring TrapsTo configure Snmp alarms by using the configuration utility To configure Snmp Traps by using the configuration utility Parameters for configuring Snmp traps Enabling Unconditional Snmp Trap Logging Specifying an Snmp Manager Configuring the NetScaler for Snmp v1 and v2 QueriesParameters for unconditional Snmp trap logging SnmpTrapLogging Snmp Trap Logging Show snmp manager To add an Snmp manager by using the NetScaler command line IPAddress Parameters for configuring an Snmp manager To add an Snmp manager by using the configuration utility Specifying an Snmp Community Parameters for configuring an Snmp community stringSh snmp community Permissions Community String*-communityName Configuring Snmp Alarms for Rate LimitingConfiguring an Snmp Alarm for Throughput or PPS Show snmp alarm PF-RL-RATE-THRESHOLD ThresholdValue Show snmp alarm PF-RL-PPS-THRESHOLDNormalValue State Alarm Threshold-thresholdValue Normal Threshold-normalValue Configuring Snmp Alarm for Dropped Packets Parameters for configuring an Snmp alarm for dropped packets Configuring the NetScaler for SNMPv3 Queries Setting the Engine ID To set the engine ID by using the NetScaler command line Configuring a ViewParameters for setting the engine ID To set the engine ID by using configuration utility To add an Snmp group by using the NetScaler command line Configuring a GroupParameters for configuring an Snmp view Parameters for configuring an Snmp group Configuring a UserTo 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 Show audit syslogAction name Configuring the NetScaler Appliance for Audit LoggingConfiguring Audit Servers Show audit nslogAction name Parameters for configuring auditing serversServerIP ServerPort Log levels defined To configure a Syslog policy by using the command line Configuring Audit PoliciesTo configure an auditing server action Rule To configure an Nslog policy by using the command lineParameters for configuring audit policies Binding the Audit Policies Globally To configure an audit server policyParameters for binding the audit policies globally Name* name Server* action Configuring an Audit Message Action Configuring Policy-Based LoggingTo globally bind the audit policy Pre Requisites LogtoNewnslog BypassSafetyCheckStringBuilderExpr Binding Audit Message Action to a Policy Installing and Configuring the Nslog Server Software requirements Installing Nslog Server on the Linux Operating SystemSupported Platforms for the Nslog Server Operating system Installing Nslog Server on the FreeBSD Operating System Pkgdelete NSaudserver Pkginfo grep NSaudserver On the system, where you have downloaded the Nslog package To install Nslog server on a Windows operating system To uninstall the Nslog server on a Windows operating system Nslog Server Command OptionsAudserver -remove Audserver -stop Audserver -remove Specifies To add the IP addresses of the NetScaler appliance To start audit server logging Verifying the Nslog Server Configuration FileRunning the Nslog Server To create a filter Customizing Logging on the Nslog ServerCreating Filters Specifying Log Properties Default Settings for the Log Properties Following is a sample configuration file Sample Configuration File audit.conf Web Server Logging Enabling or Disabling Web Server Logging Configuring the NetScaler Appliance for Web Server Logging Parameter for modifying the buffer size Modifying the Default Buffer SizeSh weblogparam Example Buffer Size Supported Platforms for the Nswl Client Operating system To modify the buffer size by using the configuration utility Cp pathtocd/Utilities/weblog/Solaris/NSweblog.tar /tmp Installing Nswl Client on a Solaris Operating SystemHardware requirements Cd /tmp Installing Nswl Client on a Linux Operating SystemTar xvf NSweblog.tar Pkginfo grep NSweblog To get more information about the NSweblog RPM file Installing Nswl Client on a FreeBSD Operating SystemTo view the installed Web server logging files Cp pathtocd/Utilities/weblog/macos/NSweblog.tgz /tmp Installing Nswl Client on a Mac OS Operating SystemPkgdelete NSweblog To install the Nswl client on a Windows system Installing Nswl Client on a Windows Operating System To uninstall the Nswl client on a Windows system Installing Nswl Client on an AIX Operating SystemCp pathtocd/Utilities/weblog/AIX/NSweblog.rpm /tmp Rpm -i NSweblog.rpm Nswl Command Options Nswl command Specifies Nswl Client Command Options Nswl -addns -f directorypath \log.conf Adding the IP Addresses of the NetScaler ApplianceTo add the Nsip address of the NetScaler appliance To verify the configuration in the Nswl configuration file Verifying the Nswl Configuration FileRunning the Nswl Client Customizing Logging on the Nswl Client System On OFF Parameters for Creating a Filter Specifies To create a filter for a virtual server LogFormat Ncsa Ncsa Common Log Format Understanding the Ncsa and W3C Log Formats Ncsa Common Log Format Argument Specifies W3C Extended Log Format Directive Descriptions EntriesDirectives Identifiers FieldsPrefix Descriptions Specifies Examples Description W3C Extended Log Format Identifiers No Prefix Required Field Description Creating a Custom Log Format by Using the Nswl LibraryCreating a Custom Log Format Creating a Custom Log Format Manually To create the custom log format by using the Nswl Library Creating Apache Log Formats Sample Configuration File Ncsa 11.Custom Log Format Argument Specifies Arguments for Defining a Custom Log Format Foobari Foobaro Formatt 12.Time Format Definition Argument Specifies Time Format Definition Argument Specifies 123 Web Server Logging 124 Advanced Configurations Show ntp server Example Configuring Clock SynchronizationTo add an NTP server by using the NetScaler command line ServerName Parameters for configuring an NTP serverMinpoll Maxpoll Starting or Stopping the NTP Daemon Configuring Clock Synchronization ManuallyEnable ntp sync Disable ntp sync Viewing the System Date and Time Usr/sbin/ntpd -c /nsconfig/ntp.conf -l /var/log/ntpd.logShow ns config Example Configuring TCP Window Scaling WSVal Parameters for configuring window scalingShow ns tcpParam Example Enabled Configuring Selective Acknowledgment To enable Sack by using the Configuration Utility Clearing the Configuration To clear a configuration by using the configuration utility Parameters for clearing a configurationViewing the Http Band Statistics Level RespBandSize ReqBandSize To modify the band range by using the configuration utility Configuring Http ProfilesTo add an Http profile by using the NetScaler command line Built-in Http Profiles Built-in profile Description Parameters for adding an Http profile Built-in TCP Profiles Built-in profile Description Configuring TCP ProfilesTo add an Http profile by using the configuration utility 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 BufferSize Parameters for setting the TCP buffer size in a TCP profile Mss Specifying the MSS Value in a TCP ProfileParameters for specifying the MSS value in a TCP profile Learn MSS for VServer LearnVsvrMSS Advanced Configurations 148 Web Interface Prerequisites How Web Interface Works Installing the Web Interface JRE tar file path Configuring the Web InterfaceWeb Interface tar file path Parameters for configuring Web interface sites Authentication Point Gateway Direct ModeAccess Gateway URL Port XML Service Addresses Configuring a Web Interface Site for LAN Users Using HttpXML Service Port Transport Site Type Published Resource Type Kiosk Mode A Web Interface Site Configured for LAN Users Using Http Virtual Server Protocol select Https IP Address Port Add service WILoopbackService 127.0.0.1 Http A Web Interface Site Configured for LAN Users Using Https Configuring a Web Interface Site for LAN Users Using Https 160 161 Add lb vserver Httpswi SSL 10.102.29.3 Configuring a Web Interface Site for Remote Users Using Agee A Web Interface Site Configured for Remote Users Using Agee 165 166 AppFlow NetScaler Flow Sequence How AppFlow Works Templates Flow Records Configuring the AppFlow Feature Specifying a Collector Enabling or Disabling the AppFlow FeatureTo specify a collector by using the NetScaler command line To remove a collector by using the NetScaler command line Configuring an AppFlow ActionTo specify a collector by using the configuration utility Parameters for specifying a collector Comment Parameters for configuring an AppFlow actionCollectors Show appflow policy name Configuring an AppFlow Policy Rule Action Parameters for configuring an AppFlow policy Http To add an expression by using the Add Expression dialog box Show appflow global Binding an AppFlow Policy GotoPriorityExpression Parameters for binding an AppFlow policyInvoke Invoke flag LabelType LabelName Click Apply Changes Enabling AppFlow for Virtual Servers Setting the AppFlow Parameters Enabling AppFlow for a Service AppFlow Parameters HttpReferer HttpCookieHttpMethod HttpHost Reporting Tool Working with Reports Using the Reporting ToolTo invoke the Reporting tool Creating and Deleting Reports Using Built-in Reports Time Intervals Time interval Displays Modifying the Time Interval Exporting and Importing Custom Reports Setting the Data Source and Time Zone Modifying a Chart Working with ChartsAdding a Chart To change the graph type of a chart Viewing a Chart To view numeric data for a graph To change the color and graph type of a data set Examples Deleting a ChartTo export chart data to Excel Limits on Entity Numbers Retrieved by nscollect Entity name Stopping and Starting the Data Collection Utility To start nscollect on the local system To stop nscollectEntity name Limit Netscaler/nscollect stop Netscaler/nscollect start To start nscollect on the remote system