LABS222: NetScaler CPX

January 2017
Table of Contents
Table of Contents ......................................................................................................... 3

Training Overview ....................................................................................... 4

Training Overview ........................................................................................................ 5

Lab Environment Details .............................................................................................. 6

Attaching XenCenter to Your XenServer ...................................................................... 7

Exercise 1: Configuring NetScaler MAS ..................................................................... 10

Exercise 2: NetScaler CPX ........................................................................................ 21

citrix.com 3
 Training Overview

citrix.com 4
Training Overview
Objective
NetScaler 11.1, NetScaler CPX, and NetScaler Management & Analytics System are the latest releases
from Citrix Cloud Networking Group. These lab exercises are intended to provide an overview of the
function of the new products and features of the release.

Required Prerequisites
Working knowledge of NetScaler function and configuration. Basic knowledge of containerization and
microservices.

Audience
Target

Citrix Internal Sales Engineers

Citrix Internal Consultants
Citrix Internal Technical Support
Partners

Lab Guide Conventions

Indicator Purpose
This symbol indicates particular attention must be paid to this step

Special note to offer advice or background information

reboot Text the student enters or an item they select is printed like this

Start Bold text indicates reference to a button or object

Focuses attention on a particular part of the screen (R:255 G:20 B:147)

Shows where to click or select an item on a screenshot (R:255 G:102 B:0)

citrix.com 5
Lab Environment Details
Insert a brief overview of the virtual machines and networking configurations included in the lab
environment. Insert a diagram of the environment design like the sample below:

Virtual Machines
VM Name IP Address Description

AD.training.lab 192.168.10.11 Domain Controller, DNS, DHCP, Certificate Services

Docker 192.168.10.14 Ubuntu 14.04, Docker Host
NetScaler 1 192.168.10.100 NetScaler
NetScaler 2 192.168.10.105 NetScaler 11.1
NetScaler 3 192.168.10.110 NetScaler 11.1
NetScaler 4 10.10.0.15 NetScaler 11.0
NetScaler MAS 192.168.10.200 NetScaler Management & Analytics System, Build 2.64

Credentials
User Name Password Description

Training\Administrator Citrix123 Domain Administrator

Training\User1 Citrix123 Standard User
Training\User2 Citrix123 Standard User
nsroot nsroot Netscaler Login
administrator Citrix123 Docker Host Login

citrix.com 6
Attaching XenCenter to Your XenServer
Overview
XenCenter allows a user to see the individual virtual machines that are installed on a
XenServer and have administrative rights over those machines to start, shut-down, and
reboot those VMs.

In this exercise you will:

Add a new XenServer to XenCenter
Estimated time to complete this exercise: 5 Minutes

Step by Step Guidance

Step Action
1. Citrix XenCenter should launch automatically on the Student Desktop. If not, launch
using the shortcut.

2. Click Add Server to add your XenServer to XenCenter.

citrix.com 7
 3. Enter the parameters shown below:

IP Address 192.168.10.5
Username admin
Provided on the web portal you
Password
launched from

Click Add.

citrix.com 8
Step Action
4. XenCenter will attach to your physical XenServer. You will see your VMs running.

Your Physical XenServer name

will be different.

Exercise Summary
You have attached XenCenter to your XenServer.

citrix.com 9
Exercise 1: Configuring NetScaler MAS
Overview
NetScaler Management & Analytics System (NMAS) has the capability of monitoring the entire
cloud networking product line, including all NetScaler appliances, NetScaler SD-WAN
appliances, and the new NetScaler CPX appliances and their Docker hosts.

In this exercise you will:

Configure NetScaler MAS to connect to the two NetScalers in the environment

Configure NMAS to connect to a Docker Host in the environment

Estimated time to complete this exercise: 20 Minutes

Step by Step Guidance

Step Action
1. In XenCenter, right click on the following virtual machines and select start:
NetScaler MAS
NetScaler 2
NetScaler 3
NetScaler 4
Docker

citrix.com 10
Step Action
2. From the student desktop, double-click the Mozilla Firefox shortcut.

3. In the shortcut toolbar, select the NetScaler MAS shortcut.

4. Log on using the nsroot/nsroot credentials.

citrix.com 11
Step Action
5. Click Get Started at the welcome screen.

6. Click Next at the Select Deployment Type screen.

7. Click Finish on the Add New Instances screen.

citrix.com 12
Step Action
8. When you first log on, you are presented with the Application Dashboard.

9. Navigate to Infrastructure > Dashboard to get a high-level view of your configured

NetScalers that are being managed by NMAS.

citrix.com 13
Step Action
10. In order to capture analytics, add NetScalers to NMAS to be managed.
First click on the Infrastructure tab, and then navigate to Instances > NetScaler VPX,
then click Add.

citrix.com 14
Step Action
11. In the Add NetScaler VPX window, type 192.168.10.105 in the IP Address field, then
click OK.

The NetScaler VPX has policies and an SNMP trap destination added to it automatically.

citrix.com 15
Step Action
12. The NetScaler VPX appliance is then added to the inventory of NetScaler VPX instances
that are managed.

You also have the option to view the dashboard for that individual instance.
Check the box next to 192.168.10.105 and then click the Dashboard button.

13. This dashboard gives you a quick look at the current state of the NetScaler, and its vital
statistics.

citrix.com 16
Step Action
14. Next, you are going to add another NetScaler to the NMAS platform.
From the Infrastructure tab, click on Instances > NetScaler VPX, and then click Add.
Type the following IP Address:

192.168.10.110

15. You should see the following result:

citrix.com 17
Step Action
16. From the NetScaler instances screens, you can also access the configuration utilities for
the individual NetScaler appliances that have been added to the NMAS.

Click one of the NetScaler IP addresses and it will automatically log on based on the
NetScaler profile that is applied to that instance.

Close any configuration utility windows for the NetScaler VPX instances that you may
have opened.

citrix.com 18
Step Action
17. Next, add the Docker host that is in the lab environment.
Navigate to Instances > NetScaler CPX, select the Docker Host tab, and then click
Add.

18. Enter the following information and then click OK:

IP Address: 192.168.10.14

User Name: administrator

Password: Citrix123

Remote API Port: 4243

citrix.com 19
Step Action
19. Now that you have added the NetScalers and a Docker host to the NMAS, click on the
Infrastructure Dashboard and view the GEO mapping of the NMAS platform to see the
instance locations.

From this map, you call roll-over the instances and see live analytics of the instances on
the map.

Exercise Summary
In this exercise, you added two NetScalers and a Docker host to the NMAS platform. In the next exercise,
you will be provisioning NetScaler CPX appliances.

citrix.com 20
Exercise 2: NetScaler CPX
Overview
NetScaler CPX is Citrixs latest appliance offering for NetScaler that functions inside of a Docker
or containerized environment. The NetScaler CPX can be installed from either the Docker host
CLI, or from the NetScaler MAS platform.

In this exercise you will:

Install a NetScaler CPX appliance from the Docker virtual machine via the command-line
interface.

Provision a NetScaler CPX appliance from the NetScaler MAS platform.

Estimated time to complete this exercise: 20 Minutes

Step by Step Guidance

Step Action
1. From the student desktop, open the putty.exe application.

citrix.com 21
Step Action
2. In the PuTTY window that appears, select Docker from the Saved Sessions pane and
click Open.

3. Log on using the following credentials:

Login as: administrator

Password: Citrix123

4. First, change to the CPX build directory.

At the administrator@docker1:~$ prompt, enter the following command and then press
Enter:
cd /var/cpx-build/

5. Next, unpack the tar file.

Enter the following command and then press Enter:
tar xvzf cpx-11.1-50.10.tar.gz

citrix.com 22
Step Action
6. The previous step created a new sub-folder called cpx.
Change to this folder. Here you will make the new CPX appliance on the Docker host.
Type the following commands (one at a time):
cd /var/cpx-build/cpx/

sudo make

Citrix123

The make process takes a couple of minutes to complete as it assembles the micro VPX
appliance on the Docker host.
7. While the previous step created the new VM on the Docker host, it did not configure it.
Next, you are going to configure the NetScaler CPX.
First, verify that the CPX was correctly installed on the Docker host.
Type the following command and press Enter:
sudo docker images

Take note of the Tag Information that is displayed in the list of images. You will need
that information for the next step in configuration.
8. Next, provision the new CPX appliance from the image on the Docker host.
Type the following command and then press Enter:
sudo docker run dt p 22 p 80 p 161/udp --ulimit core=1 --privileged=true cpx:11.1-50.10

This command will provision the CPX appliance with ports 22,80 and 161 open, and
provide terminal access.

DO NOT COPY/PASTE ABOVE RULE

citrix.com 23
Step Action
9. Type the following command to view the images running on your system and the ports
mapped to the standard ports:
sudo docker ps

10. Return to the NetScaler MAS platform utility, navigate to Infrastructure > Instances >
NetScaler CPX, and then select Rediscover from the Action drop-down list box.

11. After the discovery process is complete, the instance that you created on the Docker
host will appear here:

citrix.com 24
Step Action
12. Next, you are going to provision a NetScaler CPX appliance on the Docker host using
the NMAS tools.
While still in the NetScaler CPX Instances screen, click the Provision button.

13. Select 192.168.10.14 from the Host IP Address drop-down list box, then click the down-
arrow in the Choose File button and select Appliance.

Note: If you are unable to provision using the Appliance option, Select Local and
browse for the cpx-11.1-50.10.tar.gz file in Libraries > document > NS_OS folder.
Then proceed to step 15.

citrix.com 25
Step Action
14. Check the box next to cpx-11.1-50.tar.gz and then click Open.

15. Type 30000 in the Start Port field, type 4 in the Number of ports field, then click OK.

16. The NetScaler MAS is now building the CPX appliance on the Docker host.

citrix.com 26
Step Action
17. After the provisioning is complete, you should see the second CPX appliance in the
NetScaler MAS console.

18. There is no GUI for a NetScaler CPX.

The NetScaler CPX appliance can only be configured via CLI from the Docker host
or from the NMAS platform.
19. First, use the command line to configure a few settings on the CPX.
You will need the SSH port number of the NetScaler CPX that is on the Docker Host.
In the NMAS window, navigate to Infrastructure > Instances > NetScaler CPX and
take note of the SSH Port number that is listed.

citrix.com 27
Step Action
20. Next, return to the open PuTTY session that is logged on to the Docker host.
Type the following command to open an ssh session to the NetScaler CPX instance:
ssh p ssh_port_number_from_nmas root@127.0.0.1

Example: ssh p 32775 root@127.0.0.1

Type yes to confirm the key fingerprint.

Type the NetScaler CPX default password: linux

You should be presented with a root prompt on the NetScaler CPX instance.

21. From this prompt NetScaler commands need to be formatted like this:
cli_script.sh <command>

Try the following command to show the NetScaler IP addresses on the CPX:
cli_script.sh show ip

Execute some other commands on the CPX appliance using NetScaler CLI
commands. Keep in mind that the CPX is like a standard NetScaler VPX without
SSLVPN.
Recommended format:
cli_script.sh <command>

citrix.com 28
Step Action
22. Next use NetScaler MAS to configure a few settings on the NetScaler CPX.
Return to the open NetScaler MAS configuration window in Firefox and navigate to
Infrastructure > Configuration Jobs. Click Create Job.

citrix.com 29
Step Action
23. In the Create Job window, type cpx1 in the Job Name field, then type the following
commands in the Configuration Editor pane:

add ip 172.17.0.5 255.255.255.0 type

VIP add dns nameServer 192.168.10.11
state ENABLED

citrix.com 30
Step Action
24.

citrix.com 31
Step Action
25. Check the box next to 172.17.0.2 [192.168.10.14] and then click OK.

Click Next.

citrix.com 32
Step Action
26. Click Next on the Specify Variable Values screen.

citrix.com 33
Step Action
27. Click Finish on the Execute screen.

28. When complete, you will see the execution summary and any errors that were seen
during configuration:

29. Feel free to try and configure whatever you would like on the CPX.
When done, close the open NetScaler MAS browser window.

Exercise Summary
In this exercise you provisioned two CPX appliances using both the Docker host and the NetScaler MAS
platform. You also configured some simple settings on the CPX appliances from both the Docker host
and the NetScaler MAS jobs system.

citrix.com 34
Authors
The following author contributed to the creation of this deliverable.

Revision History
Revision Change Description Updated By Date
1.0 Original Christopher Rudolph January 2017
Joslyn Bailey-White

citrix.com 35
 Corporate Headquarters India Development Center
Fort Lauderdale, FL, USA Bangalore, India Latin America Headquarters
Coral Gables, FL, USA
Silicon Valley Headquarters Online Division Headquarters
Santa Clara, CA, USA Santa Barbara, CA, USA UK Development Center
Chalfont, United Kingdom
EMEA Headquarters Pacific Headquarters
Schaffhausen, Switzerland Hong Kong, China

About Citrix

Citrix (NASDAQ:CTXS) is a leader in mobile workspaces, providing virtualization, mobility management, networking and cloud services to enable new ways to
work better. Citrix solutions power business mobility through secure, personal workspaces that provide people with instant access to apps, desktops, data and
communications on any device, over any network and cloud. This year Citrix is celebrating 25 years of innovation, making IT simpler and people more productive.
With annual revenue in 2013 of $2.9 billion, Citrix solutions are in use at more than 330,000 organizations and by over 100 million users globally. Learn more at
www.citrix.com.

Copyright 2014 Citrix Systems, Inc. All rights reserved. [list Citrix trademarks (without or symbols!) in document] are trademarks of Citrix Systems, Inc.
and/or one of its subsidiaries, and may be registered in the U.S. and other countries. Other product and company names mentioned herein may be trademarks of
their respective companies.

36
citrix.com