Configuring NetScaler CPX

You can configure a NetScaler CPX instance by accessing the CLI prompt through the Linux Docker host, or by using NetScaler NITRO APIs.

Configuring a NetScaler CPX Instance by Using the Command Line Interface

Access the Docker host and log on to the SSH prompt of the instance as shown in the following figure. The default administrator credentials to log on to a NetScaler CPX instance are root/linux.

Localized image

Type the following command to use the command line prompt of the instance to run CLI commands: cli_script.sh “<command>”

Example:

Localized image

To log out of the instance prompt, type logout.

Configuring a NetScaler CPX Instance by Using the NITRO API

You can use the NetScaler NITRO API to configure NetScaler CPX instances.

To configure NetScaler CPX instances by using the Nitro API, in a web browser, type:

http://<host_IP_address>:<port>/nitro/v1/config/<resource-type\

To retrieve statistics by using the Nitro API, in a web browser, type:

http://\<host\_IP\_address\>:\<port\>/nitro/v1/stat/\<resource-type\

For more information about using the NITRO API, see REST Web Services. For NetScaler CPX, use CPX IP address:port where netscaler-ip-address is mentioned.

Configuring a NetScaler CPX Instance by Using Jobs

You can configure NetScaler CPX instances by creating and executing jobs in Citrix ADM. You can use the configurations from configuration templates, extract configurations available on other devices, and use configurations saved in text files. You can also record configurations done by using the configuration utility of another instances. Citrix ADM then displays the corresponding CLI commands for you to use on your NetScaler CPX instance. After you select the configuration, you must select NetScaler CPX instances on which you want to load the configuration, specify the variable values, and execute the job.

To configure NetScaler CPX instances by using Jobs:

  1. Log on to Citrix ADM by using the administrative credentials.

  2. Navigate to Networks > Configuration Jobs, and then click Create Job.

  3. Specify the required values, and select the configuration source. You can also type the commands you want to run.

    localized image

  4. Select the NetScaler CPX instances on which you want to run the configuration and click Next.

    localized image

  5. Specify the execution settings and click Finish to run the commands on the NetScaler CPX instance. If you want to save the configuration and run it later, click Save and Exit. localized image

Configuring Log Streaming on a NetScaler CPX Instance

You can configure log streaming on a NetScaler CPX instance to collect webpage performance data, flow and user-session level information, and database information required for application performance monitoring and analytics. These data records are sent to Citrix ADM where you can view real-time and historical reports for all your applications.

To configure log streaming on a NetScaler CPX instance, you must first enable the AppFlow feature and the ulfd daemon on the NetScaler CPX instance. When you enable the ulfd daemon, you must specify the IP address of Citrix ADM where you want to monitor the real-time and historical reports. You must then configure an AppFlow collector, action, policy, and bind the AppFlow policy globally.

The ulfd daemon sends all the flow records to Citrix ADM in a single unified logging format.

You can configure log streaming either by using the command line interface of a NetScaler CPX instance, or by using the Jobs feature in Citrix ADM.

Before you can monitor the records, you must add the NetScaler CPX instance to Citrix ADM. For more information about adding a NetScaler CPX instance to Citrix ADM, see Installing a NetScaler CPX Instance by Using Citrix ADM.

To configure log streaming on a NetScaler CPX Instance:

  1. Enable the AppFlow feature by running the following command: enable ns feature AppFlow

  2. Enable the ulfd daemon by using the following command: set ns param -ulfd ENABLED -loggerip <NUMS_IP_Address>

  3. Run the following commands to configure an AppFlow collector, action, and policy, and to bind the policy globally:

    add appflow collector <name> -IPAddress <ipaddress>`

    set appflow param -templateRefresh 3600 -httpUrl ENABLED -httpCookie ENABLED -httpReferer ENABLED -httpMethod ENABLED -httpHost ENABLED -httpUserAgent ENABLED -httpContentType ENABLED -httpAuthorization ENABLED -httpVia ENABLED -httpXForwardedFor ENABLED -httpLocation ENABLED -httpSetCookie ENABLED -httpSetCookie2 ENABLED -connectionChaining ENABLED -httpDomain Enabled

    add appflow action <name> --collectors <string> ... [-clientSideMeasurements (Enabled|Disabled) ]

    add appflow policy <name> true <action>

    bind appflow global <policyName> <priority> [<gotoPriorityExpression [-type <type>]
<!--NeedCopy-->

Note: You must configure the AppFlow collector with a dummy IP address.

Configuring NetScaler CPX