Download
Share
Print this page
  1. Manuals
  2. Brands
  3. Citrix Manuals
  4. Server
  5. NetScaler SDX 8015
  6. Manual

Citrix NetScaler SDX 8015 Manual

Sdx 10.1
Hide thumbs Also See for NetScaler SDX 8015:

Advertisement

Quick Links

Download this manual
SDX 10.1
Apr 12, 20 16
Release Notes
Hardware Installation
NetScaler SDX Hardware and Component Compatibility Matrix
Getting Started with the Management Service and User Interface
Hardware Installation
Common Hardware Components
Field Replaceable Units
Hardware Platforms
Summary of Hardware Specifications
Preparing for Installation
Installing the Hardware
Initial Configuration
Lights Out Management Port of the NetScaler SDX Appliance
Upgrading the Components of a NetScaler SDX Appliance
Upgrading the Management Service
Upgrading the XenServer Software
Uploading and Applying a XenServer Hotfix
Installing the XenServer Supplemental Pack
Upgrading a NetScaler Instance
Managing and Monitoring the NetScaler SDX Appliance
Managing the RAID disk allocation
NetScaler SDX Licensing Overview
Managing Interfaces
Configuring SNMP on NetScaler SDX Appliances
Configuring Syslog Notifications
Configuring Mail Notifications
Configuring SMS Notifications
https://docs.citrix.com
© 1999-2017 Citrix Systems, Inc. All rights reserved.
p.1

Advertisement

loading
Need help?

Need help?

Do you have a question about the NetScaler SDX 8015 and is the answer not in the manual?

Questions and answers

Related Manuals for Citrix NetScaler SDX 8015

Summary of Contents for Citrix NetScaler SDX 8015

  • Page 1 Managing and Monitoring the NetScaler SDX Appliance Managing the RAID disk allocation NetScaler SDX Licensing Overview Managing Interfaces Configuring SNMP on NetScaler SDX Appliances Configuring Syslog Notifications Configuring Mail Notifications Configuring SMS Notifications https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved.
  • Page 2 Consolidation When the Management Service and the NetScaler Instances are in Different Networks Consolidation Across Security Zones Converting a NetScaler MPX Appliance to a NetScaler SDX Appliance Converting a NetScaler MPX 11515/11520/11530/11540/11542 Appliance to a NetScaler SDX 11515/11520/11530/11540/11542 Appliance https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved.
  • Page 3 SECUREMAT RIX GSB Websense Protector BlueCat DNS/DHCP CA Access Gateway Palo Alto Networks VM-Series Nitro API Obtaining the NIT RO Package How NIT RO Works Java SDK .NET SDK REST Web Services https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved.
  • Page 4 Dec 31, 20 13 Release notes describe the enhancements, changes, bug fixes, and known issues for a particular release or build of Citrix NetScaler software. T he NetScaler SDX release notes are covered as a part of NetScaler release notes.
  • Page 5 Lights Out Management port, so that you have management access to the appliance even if your network goes down. T he Citrix NetScaler SDX appliance is a multi-tenant platform on which you can provision and manage multiple virtual instances of NetScaler.

  • Page 6: Sdx 17550/19550/20550/21550

    XenServer and supplemental packs, then you must download the images for XenServer and supplemental packs from the Citrix NetScaler SDX Download page. Make sure to check the Citrix NetScaler SDX download page for the recommended hot fixes applicable for the Management Service version.
  • Page 7 SDX 11515/11520/11530/11540/11542 Supported Supported 1. Release 10.1, build 124.13 and 1. Release 10.1, build 124.13 and later later 2. Release 10.5 build 50.10 and 2. Release 10.5 build 50.10 and later later https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved.

  • Page 8: Version

    Not Supported Not Supported Release 9.3 Release 9.3 Palo Alto Guest Supported Release 6.1 Build 100012 and higher 1. Release 10.5 build and later 50.10 and later Not Supported Release 9.3 https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved.
  • Page 9 118.7 and later 118.7 and later 2. Release 10.5 build 2. Release 10.5 build 50.10 and later 50.10 and later Not Supported Not Supported 1. Release 9.3 1. Release 9.3 https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved.
  • Page 10 2. On the Login page, in User Name and Password, type the user name and password of the Management Service. T he default user name and password are nsroot and nsroot. However, Citrix recommends that you change the password after initial configuration. For information about changing the nsroot password, see...
  • Page 11 To access the console of Management Service or XenServer, navigate to Configuration > System, and under Console Access, click Management Service or XenServer link. Note: Console access is not supported by the Internet Explorer browser. Citrix recommends using the console access feature through Management Service HT T PS sessions only.
  • Page 12 Note: On first log on, the Home page does not display any data related to the NetScaler instances because you have not provisioned any instances on your appliance. Health Monitoring Events Displays the last 25 events, with their severity, message, and the date and time that the event occurred. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.12...
  • Page 13 If you remove a gadget that is available on the Home page by default, you can add them back to the Home page by performing a search for the gadget, as described earlier. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.13...
  • Page 14 Lights Out Management port, so that you have management access to the appliance even if your network goes down. T he Citrix NetScaler SDX appliance is a multi-tenant platform on which you can provision and manage multiple virtual instances of NetScaler.
  • Page 15 On the appliance’s back panel, power status LEDs indicate the status of each power supply. T he following table describes the indicators of the power status LED. LED Color LED Indicates No power Green Appliance is receiving power Power supply has detected an error https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.15...
  • Page 16 T raffic rate of 1 gigabit per second. Right Link/ No link. Activity Solid green Link is established but no traffic is passing through the port. Blinking T raffic is passing through the port. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.16...
  • Page 17 No power to any power supply. Flashing RED No power to this power supply. Flashing BLUE Power supply is in standby mode. BLUE Power supply is functional. Power supply failure. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.17...
  • Page 18 T he 10G slot supports copper 1G transceivers, which can operate at up to 1 Gbps in a 10 Gbps slot. Note: You cannot insert a fiber 1G transceiver into a 10G slot. Note: You cannot insert a 10G transceiver into a 1G slot. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.18...
  • Page 19 (300m) - 4 50/125um 550 m EW3F0000234, Pack MMF, EW3P0000142, 500MHz- EW3X0000234, km (OM2) EW3Z0000086 50/125um 550 m MMF, 400MHz- 62.5/125um 300 m MMF, 200MHz- km (OM1) 62.5/125um 300 m MMF, 160MHz- https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.19...
  • Page 20 Reach (nm) EW3A0000712, Citrix 1310nm 9/125um 10 km SDX 8015/8400/8600, SDX EW3B0000712, NetScaler (nominal) 22040/22060/22080/22100/22120, EW3C0000712, 1G SFP SDX 24100/24150 EW3D0000712, Ethernet LX EW3E0000712, - Single EW3F0000712, EW3P0000559, EW3X0000712, EW3Z0000587 https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.20...
  • Page 21 (300m) - 17550/19550/20550/21550, SDX 500MHz- EW3X0000710, Single 22040/22060/22080/22100/22120, SDX km (OM2) EW3Z0000585 24100/24150 50/125um 66 m MMF, 400MHz- 62.5/125um 33 m MMF, 200MHz- km (OM1) 62.5/125um 26 m MMF, 160MHz- https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.21...
  • Page 22 EW3B0000711, NetScaler (nominal) 11500/13500/14500/16500/18500/20500, EW3C0000711, 10G SFP+ SDX 11515/11520/11530/11540/11542, EW3D0000711, Ethernet EW3E0000711, Long Range 14020/14030/14040/14060/14080/14100, EW3F0000711, (10km) - SDX 17500/19500/21500, SDX EW3P0000558, Single 17550/19550/20550/21550, SDX EW3X0000711, 22040/22060/22080/22100/22120, SDX EW3Z0000586 24100/24150 https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.22...
  • Page 23 Jan 28 , 20 11 Citrix NetScaler field replaceable units (FRU) are NetScaler components that can be quickly and easily removed from the appliance and replaced by the user or a technician at the user's site. T he FRUs in a NetScaler appliance can include DC or AC power supplies, and solid-state or hard-disk drives, and a direct attach cable (DAC).
  • Page 24 T he disable alarm button is functional only when the appliance has two power supplies. Replacing a DC Power Supply Citrix NetScaler SDX platforms can accommodate two power supplies, except the SDX 22040/22060/22080/22100/22120 and SDX 24100/24150 platforms which can accommodate four power supplies. All NetScaler appliances function properly with a single power supply, except the SDX 22040/22060/22080/22100/22120 and SDX 24100/24150 platforms which need two power supplies for proper operation.
  • Page 25 1. Locate the SSD on the back panel of the appliance. Push the safety latch of the drive cover down while pulling out on the drive handle to disengage. Pull out the faulty drive. Figure 5. Removing the Existing Solid-State Drive https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.25...
  • Page 26 Important: When you insert the drive, make sure that the Citrix product label is at the right. Figure 6. Inserting the Replacement Solid-State Drive After you replace one of the SSDs, the configuration on the other SSD in the mirrored SSD is copied to the replacement...
  • Page 27 Important: When you insert the drive, make sure that the Citrix product label is at the top if the drive is inserted horizontally, or at the right if the drive is inserted vertically.
  • Page 28 (SFP+ transceivers and fiber optic cables.) T he transceiver with DAC is hot-swappable. You can insert and remove the transceiver with the attached cable without shutting down the appliance. T he Citrix NetScaler appliance supports only passive DAC.
  • Page 29 2. T o remove the DAC, pull the tab on the top of the DAC, and then pull the DAC out of the port, as shown in the following figure. Figure 12. Removing a DAC from the 10G port https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.29...
  • Page 30 T he various NetScaler hardware platforms offer a wide range of features, communication ports, and processing capacities. All platforms have multicore processors. T he Citrix NetScaler SDX appliance is a multi-tenant platform on which you can provision and manage multiple virtual instances of NetScaler.
  • Page 31 Jan 21, 20 14 T he Citrix NetScaler models SDX 8015, SDX 8400, and SDX 8600 are 1U appliances. Each model has one quad-core processor (8 cores with hyper-threading) and 32 gigabytes (GB) of memory. T he SDX 8015/8400/8600 appliances are...
  • Page 32 SFP+ ports numbered 10/1 and 10/2 on the bottom row from left to right. T he following figure shows the back panel of the SDX 8015/8400/8600 appliance. Figure 3. Citrix NetScaler SDX 8015/8400/8600 appliance, back panel T he following components are visible on the back panel of the SDX 8015/8400/8600 appliance: 256 GB removable solid-state drive, which is used to store the NetScaler software and the user data.
  • Page 33 16500,SDX 18500, andSDX 20500 Oct 25, 20 13 T he Citrix NetScaler models SDX 11500/13500/14500/16500/18500/20500 are 2U appliances. Each model has two 6-core processors for a total of 12 physical cores (24 cores with hyper-threading), and 48 gigabytes (GB) of memory.
  • Page 34 Dual power supplies, each rated at 650 watts, 110-220 volts. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.34...
  • Page 35 SDX 11540, and SDX 11542 Mar 14 , 20 14 T he Citrix NetScaler models SDX 11515/11520/11530/11540/11542 are 2U appliances. Each model has two 6-core processors for a total of 12 physical cores (24 cores with hyper-threading), and 48 gigabytes (GB) of memory.
  • Page 36 Dual power supplies, each rated at 650 watts, 110-220 volts. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.36...
  • Page 37 21500 Oct 25, 20 13 T he Citrix NetScaler models SDX 17500/19500/21500 are 2U appliances. Each model has two 6-core processors and 48 gigabytes (GB) of memory. T he following figure shows the front panel of the SDX 17500/19500/21500 appliance.
  • Page 38 Dual power supplies, each rated at 650 watts, 110-220 volts. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.38...
  • Page 39 Oct 25, 20 13 T he Citrix NetScaler models SDX 17550, SDX 19550, SDX 20550, and SDX 21550 are 2U appliances. Each model has two 6- core processors for a total of 12 physical cores (24 cores with hyper-threading), and 96 gigabytes (GB) of memory.
  • Page 40 Dual power supplies, each rated at 850 watts, 110-220 volts. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.40...
  • Page 41 SDX 22100, and SDX 22120 Oct 25, 20 13 T he Citrix NetScaler SDX 22040/22060/22080/22100/22120 are 2U appliances. Each model has two 8-core processors (32 cores with hyper-threading) and 256 gigabytes (GB) of memory. T he SDX 22040/22060/22080/22100/22120 appliances are...
  • Page 42 SDX 22040/22060/22080/22100/22120 (24x10G SFP+). T wenty-four 10G SFP+ ports. T he following figure shows the back panel of the SDX 22040/22060/22080/22100/22120 appliances. Figure 3. Citrix NetScaler SDX 22040/22060/22080/22100/22120, back panel T he following components are visible on the back panel of the SDX 22040/22060/22080/22100/22120 appliance: Non-maskable interrupt (NMI) Button, used at the request of T echnical Support to initiate a core dump.
  • Page 43 Oct 25, 20 13 T he Citrix NetScaler SDX 24100/24150 are 2U appliances. Each model has two 8-core processors (32 cores with hyper- threading) and 256 gigabytes (GB) of memory. T he SDX 24100/24150 appliances are available in the twelve 1G SFP ports and twenty-four 10G SFP+ ports (12x1G SFP + 24x10G SFP+) configuration.
  • Page 44 Four 600 GB removable solid-state drives. T he first two leftmost solid-state drives store the NetScaler software. T he next two solid-state drives store user data. Additionally, you can extend the SSD storage (optional) by another 2 or 4 600 GB SSDs. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.44...
  • Page 45 T he following figure shows the front panel of the SDX 14020/14030/14040/14060/14080/ 14100 ( 16x10G SFP+) appliance. Figure 1. Citrix NetScaler SDX 14 020/14 030/14 04 0/14 060/14 080/14 100 ( 16x10G SFP+), f ront panel T he NetScaler SDX 14020/14030/14040/14060/14080/14100 appliances have the following ports: RS232 serial Console Port.
  • Page 46 Button is also available remotely over the network in the LOM GUI, in the Remote Control menu. For more information about the lights out management port of the appliance, see http://docs.citrix.com/en-us/sdx/11/hardware- installation/lights-out-management-port-lom-of-sdx.html. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.46...
  • Page 47 Ports - 10G 2x10G SFP+ 4x10G SFP+ ports 8x1G SFP + 4 x10G SFP+ model: 6x10/100/1000Base-T 4x10G SFP+ ports copper Ethernet model: 2x10G SFP+ Ports Number of Power Supplies Maximum NetScaler Instances https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.47...
  • Page 48 FCC (Part 15 Class A), CE, C-T ick, Susceptibility C-T ick, VCCI-A T ick, VCCI, CCC, KC, NOM, VCCI, CCC, KC, NOM, GOST, SABS, GOST, SABS, SASO SASO Compliance RoHS, WEEE RoHS, SVHC, WEEE RoHS, SVHC, WEEE https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.48...
  • Page 49 12x1G SFP + 24 x10G input voltage, SFP+ model: SFP+ model: 50-60 Hz 50-60 Hz frequency, & current 100-240VAC 100-240VAC 6.5-3.5 A 6.5-3.5 A 50/60Hz 50/60Hz 6.0-12.0A 6.0-12.0A 24 x10G SFP+ model: 100-240VAC https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.49...
  • Page 50 20%– 80% condensing) Safety Certifications T UV T UV EMC & Susceptibility FCC (Part 15 FCC (Part 15 Class FCC (Part 15 Class A), CE FCC (Part 15 Class A), https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.50...
  • Page 51 Maximum DC power consumption 594 W Airflow (front to rear) 110 CFM Typical 175 CFM Maximum Heat dissipation 1412 BT U per hour Typical Package weight (lbs.) System weight (lbs.) https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.51...
  • Page 52 Australia (RCM), China (CCC), Korea (KCC), India (BIS), Mexico (NOM), Saudi Arabia (CITC), South Africa (ICASA), Russia (EAC, CU-T R), Taiwan (BSMI), Brazil (Inmetro & Anatel), Israel (MoE, MoC) Environmental compliance WEEE, RoHS, REACH https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.52...
  • Page 53 14 136:2002 standard. One standard 4-post rail kit Note: If the kit that you received does not fit your rack, contact your Citrix sales representative to order the appropriate kit. In addition to the items included in the box with your new appliance, you will need the following items to complete the installation and initial configuration process.
  • Page 54 At minimum, four Ethernet connections per rack unit. Space requirements One empty rack unit for the Citrix NetScaler SDX 8015/8400/8600, and two consecutive empty rack units for all other appliance models. Note: You can order the following rail kits separately.
  • Page 55 Rack Precautions Make sure that the leveling jacks on the bottom of the rack are fully extended to the floor, with the full weight of the rack resting on them. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.55...
  • Page 56 T he handles on the left and right of the front panel of the appliance should be used only for extending the appliance out of the rack. Do not use these handles for mounting the appliance on the rack. Use the rack-rail hardware, described later, instead. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.56...
  • Page 57 An assembly consists of an inner rail and a rack rail. T he supplied rail kit is 28 inches long (38 inches extended). Contact your Citrix sales representative to order a 23-inch (33 inches https://docs.citrix.com...
  • Page 58 T he following figure illustrates the steps involved in mounting the Citrix NetScaler SDX appliance to a rack. To remove the inner rails from the rail assembly 1.
  • Page 59 To install the appliance in the rack 1. Align the inner rails, attached to the appliance, with the rack rails. 2. Slide the appliance into the rack rails, keeping the pressure even on both sides. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.59...
  • Page 60 Caution: NetScaler appliances do not support 1G SFP transceivers from vendors other than Citrix Systems. Attempting to install third-party 1G SFP transceivers on your NetScaler appliance voids the warranty.
  • Page 61 10G SFP+ transceivers, the speed is also autonegotiated. Caution: NetScaler appliances do not support 10G SFP+ transceivers provided by vendors other than Citrix Systems. Attempting to install third-party 10G SFP+ transceivers on your NetScaler appliance voids the warranty.
  • Page 62 Figure 7. Inserting an Ethernet cable 2. Insert the RJ-45 connector on the other end into the target device, such as a router or switch. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.62...
  • Page 63 1. Connect one end of the power cable to the power outlet on the back panel of the appliance, next to the power supply, as shown in the following figure. Figure 9. Inserting a power cable https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.63...
  • Page 64 2. Press the ON/OFF toggle power switch on the back panel of the appliance. Caution: Be aware of the location of the emergency power off (EPO) switch, so that if an electrical accident occurs you can quickly remove power from the appliance. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.64...
  • Page 65 Service user interface from any computer that is on the same network as the new SDX appliance. If you do not have a computer on the same network, use the serial console to perform the initial configuration of the SDX appliance. Citrix recommends that, as soon as you complete the initial configuration, you change the root-user password.
  • Page 66 Changing the Password of the Def ault User Account T he default user account provides complete access to all features of the Citrix NetScaler SDX appliance. T herefore, to preserve security, the nsroot account should be used only when necessary, and only individuals whose duties require full access should know the password for the nsroot account.
  • Page 67 2. In the Users pane, click the default user account, and then click Modify. 3. In the Modify System User dialog box, in Password and Confirm Password, enter the password of your choice. 4. Click OK. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.67...
  • Page 68 T he LOM Support Matrix shows the LOM firmware versions shipped with the various platforms, along with the recommended versions, and the earliest NetScaler software versions that support both the shipped and the recommended LOM firmware versions. T he latest available LOM package can be found on the Citrix downloads website under Firmware Upgrade.
  • Page 69 Minimum NetScaler Version Version to avoid PS f ailure SDX 17550/19550/20550/21550 2.52/3.02/3.33/3.39 3.39 9.3_65.x, 10.1_123.x, 10.5 issues SDX 22040/22060/22080/22100/22120 2.63/3.22 3.22 9.3_65.x, 10.1_123.x, 10.5 SDX 24100/24150 2.63/3.22 3.22 9.3_65.x, 10.1_123.x, 10.5 https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.69...
  • Page 70 Default Gateway— IP address of the router that connects the LOM port to the network 3. Click Save. 4. If you want to change the user credentials, navigate to Configuration > Users, select the user, click Modify User, and change the credentials. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.70...
  • Page 71 2. If the failure happens after the BIOS, Operating System, and SNMP service have started and normal boot-up has been successful. 3. If the failure happens while the operating system and other system software is in a stable enough state for the SNMP software service to run. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.71...
  • Page 72 8. T he LOM should start sending alerts to the IPMI View utility within in a minute or two. After the IPMI View utility starts receiving alerts from the LOM, reconfigure the destination IP address to point to your SNMP Network Management Software, such as HP OpenView. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.72...
  • Page 73 Where, <x.x.x.x> is the IP address to which the SNMP event should be sent. To specif y an SNMP community string name At the prompt, type: ipmitool lan set 1 snmp <community string> https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.73...
  • Page 74 Jan 31, 20 11 Citrix recommends using HT T PS to access the LOM GUI. To use HT T PS, you must replace the default SSL certificate with one from a trusted certificate authority and upload a private key to the LOM GUI.
  • Page 75 3. T o verify that you have selected the correct certificate and private key, check the file names of the certificate and key, which appear next to the Choose File buttons. 4. Click Upload. A message informs you that uploading a new SSL certificate replaces the existing (default) certificate. 5. Click OK. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.75...
  • Page 76 Note: If the certificate or key are invalid, the BMC reboots, tries the new settings, and reverts to using the previous settings. 8. In the address bar, click the lock icon to display the connection tab, as shown on the screen below. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.76...
  • Page 77 9. Click Certificate information to display details about the certificate that you just uploaded. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.77...
  • Page 78 Note: For the best practices for LOM and NetScaler security, see http://support.citrix.com/article/CT X129514. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.78...
  • Page 79 : ARP Responses Enabled, Gratuitous ARP Disabled Gratituous ARP Intrvl : 0.0 seconds Default Gateway IP : 0.0.0.0 Default Gateway MAC : 00:00:00:00:00:00 Backup Gateway IP : 0.0.0.0 Backup Gateway MAC : 00:00:00:00:00:00 https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.79...
  • Page 80 802.1q VLAN ID : Disabled 802.1q VLAN Priority RMCP+ Cipher Suites : 1,2,3,6,7,8,11,12,0 Cipher Suite Priv Max : aaaaXXaaaXXaaXX X=Cipher Suite Unused c=CALLBACK u=USER o=OPERATOR a=ADMIN O=OEM https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.80...
  • Page 81 To perf orm a warm restart remotely f rom another computer on the network, type: ipmitool –U <bmc_gui_username> –P <bmc_gui_password> –H <bmc IP address> mc reset warm https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.81...
  • Page 82 To perform a core dump remotely from another computer on the network by using the shell At the shell prompt, type: ipmitool -U <bmc_gui_username> -P <bmc_gui_password> -H <bmc IP address> chassis power diag https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.82...
  • Page 83 1. Navigate to Maintenance > Factory Default. 2. Click Restore. To reset the configuration to f actory def aults by using the shell At the shell prompt, type: ipmitool raw 0x30 0x41 0x1 https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.83...
  • Page 84 You can set this switch to direct LOM traffic through the dedicated LOM port or through the shared management port. A dedicated LOM port removes the management port as a single point of failure, while a shared LOM/management port reduces the cabling costs. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.84...
  • Page 85 To read the BIOS Post Code by using the LOM GUI Navigate to Miscellaneous > BIOS Post Snooping. To read the BIOS Post Code by using the shell At the prompt, type: ipmitool raw 0x30 0x2a https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.85...
  • Page 86 XenServer, then the NetScaler instances (if necessary). Citrix recommends using the latest version of XenServer supported on the corresponding version of the Management Service. Also, make sure you apply the latest versions of the Supplemental Packs and Hotfixes. See the...
  • Page 87 NetScaler NetScaler instance. version and check the XenServer 2. Check the Supported Versions and Management Service version table. requirements for that 3. Upgrade the NetScaler enhancement. instance. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.87...
  • Page 88 T he process of upgrading the Management Service involves uploading the build file of the target build and the documentation file to the SDX appliance, and then upgrading the Management Service. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.88...
  • Page 89 3. In the Upgrade Management Service dialog box, in Software Image, select the software image file to which you want to upgrade the Management Service. 4. In Documentation File, select the documentation file you want to use during upgrade. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.89...
  • Page 90 5. Click OK. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.90...
  • Page 91 3. In the Upgrade Management Service dialog box, in Software Image, select the software image file to which you want to upgrade the Management Service. 4. In Documentation File, select the documentation file you want to use during upgrade. 5. Click OK. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.91...
  • Page 92 You need to upgrade to XenServer version 6.1.0 to enable LACP and provisioning of third-party virtual machines (instances). T he process of upgrading the XenServer software involves uploading the build file of the target build to the Management Service, and then upgrading the XenServer software. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.92...
  • Page 93 1. In the navigation pane, click System. 2. In the details pane, click Upgrade XenServer. 3. In the Upgrade XenServer dialog box, select the Image file from the list. 4. Click OK, and then click Close. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.93...
  • Page 94 1. In the navigation pane, click System. 2. In the details pane, click Upgrade XenServer. 3. In the Upgrade XenServer dialog box, select the Image file from the list. 4. Click OK, and then click Close. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.94...
  • Page 95 You can upload the XenServer hotfix files from a client computer to the SDX appliance. You can also download the hotfix files to a local computer as a backup. Important: Citrix recommends that you make a backup before applying a XenServer hotfix. Apply only the hotfix that is available in the NetScaler download page.
  • Page 96 2. In the message box, from the Save list, select Save as. 3. In the Save As message box, browse to the location where you want to save the file, and then click Save. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.96...
  • Page 97 T he process of upgrading the NetScaler instances involves uploading the build file and the documentation file of the target build to the SDX appliance, and then upgrading the NetScaler instance. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.97...
  • Page 98 SDX appliance, and then upgrading the NetScaler instance. You have to upload the NetScaler software images to the SDX appliance before upgrading the NetScaler instances. Citrix recommends that you upload the latest documentation file along with the image file. You can also download the image and documentation files to a local computer as a backup.
  • Page 99 4. From the Documentation File drop-down list, select the documentation file to which you want to upgrade. 5. From the Instance IP Address drop-down list, select the IP addresses of the instances that you want to upgrade. 6. Click OK, and then click Close. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.99...
  • Page 100 4. From the Documentation File drop-down list, select the documentation file to which you want to upgrade. 5. From the Instance IP Address drop-down list, select the IP addresses of the instances that you want to upgrade. 6. Click OK, and then click Close. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.100...
  • Page 101 Changing the Password of the Default User Account T he default user account provides complete access to all features of the Citrix NetScaler SDX appliance. T herefore, to preserve security, the nsroot account should be used only when necessary, and only individuals whose duties require full access should know the password for the nsroot account.
  • Page 102 Note: Do not add if Autokey is selected. Autokey— Use the Autokey protocol for the specified server. Preferred— Synchronize with this server first. Applicable if more than one server is configured. *A required parameter https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.102...
  • Page 103 T he total number of SSL chips that have not been assigned to a instance. Total Memory (GB) T otal appliance memory in gigabytes. Free Memory (GB) Free appliance memory in gigabytes. Hypervisor Inf ormation Uptime https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.103...
  • Page 104 Build NetScaler release and build running on the SDX appliance. IP Address IP address of the Management Service. Host ID XenServer host ID. System ID XenServer system ID. Serial Number https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.104...
  • Page 105 To view the CPU usage for all the cores on the SDX appliance, on the Monitoring tab, in the navigation pane, expand Monitoring, and then click CPU Core Usage. Installing an SSL Certificate on the SDX Appliance https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.105...
  • Page 106 Management Service node, SSL Certificate Files, to upload and manage the SSL certificates and corresponding public and private key pairs that can be installed on NetScaler instances. To access the SSL certificates and keys for NetScaler instances, navigate to Configuration > NetScaler > SSL Certificate Files. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.106...
  • Page 107 Updated: 2014-08-24 T he default user account provides complete access to all features of the Citrix NetScaler SDX appliance. T herefore, to preserve security, the nsroot account should be used only when necessary, and only individuals whose duties require full access should know the password for the nsroot account.
  • Page 108 1. On the Configuration tab, in the navigation pane, click System. 2. In the System pane, under System Settings, click Change Hostname. 3. In the Modify Hostname dialog box, enter a hostname. 4. Click OK. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.108...
  • Page 109 T he virtual drive operating condition is good. All configured drives are online. Degraded T he virtual drive operating condition is not optimal. One of the configured drives has failed or is https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.109...
  • Page 110 NetScaler SDX appliance. You can also view information about a storage-repository drive that is not attached, and you can remove such a drive by selecting the it and then clicking Remove. T he Storage Repository tab displays the following information about each storage repository: https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.110...
  • Page 111 5. Physically remove the defective drive from the slot. 6. Insert the new Citrix verified SSD in the slot from where you removed the defective SSD. 7. In the Management Service, nagivate to Configuration > System > RAID. T he new SSD is listed in the Physical Drives section.
  • Page 112 T he following table describes the states of the logical drive. State Description Degraded T he logical drive operating condition is not optimal. One of the configured drives has failed or is offline. Failed T he logical drive has failed. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.112...
  • Page 113 5. Click Create. Physical Drives Navigate to Configuration > System > RAID > Physical Drives tab, to view the following information: Slot - Physical slot associated with the physical drive. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.113...
  • Page 114 1. On the back of the SDX appliance, insert the two blank SSDs of same capacity in slot numbers 5 and 6. You can add the SSDs in a running system. Note: Make sure that the SSDs are Citrix certified. 2. In the Management Service, navigate to Configuration > System > RAID and click the Physical Drives tab. You can see the SSDs that you added.
  • Page 115 If both the SSDs that form a RAID1 pair fail, you must first delete the NetScaler VPX instances hosted on the storage repository associated with the failed SSDs, delete the logical drive, replace both the failed SSDs with new Citrix certified SSDs, and create the logical drive again.
  • Page 116 Use Hardware Serial Number— T he software internally fetches the serial number of your appliance and uses this number to allocate your license(s) from the licensing portal. Use License Activation Code— Citrix emails the LAC for the license that you purchased. Enter the LAC in the text box.
  • Page 117 5. Click Get Licenses. Depending on the option that you selected one of the following dialog boxes appears. T he following dialog box appears if you selected Hardware Serial Number. T he following dialog box appears if you selected License Activation Code. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.117...
  • Page 118 If you downloaded your license file to your local computer by accessing the licensing portal, you must upload the license to the appliance. To upload a license file 1. In a web browser, type the IP address of your NetScaler SDX appliance. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.118...
  • Page 119 4. In the details pane, click Update Licenses, and then select Upload License Files. 5. Click Browse. Navigate to the location of the license files, select the license file, and then click Open. 6. Click Apply for the license to take effect. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.119...
  • Page 120 T he virtual interface number on the instance and the corresponding physical interface number on the appliance appear in the Description field, as shown in the following figure: Figure 1. Mapping the Virtual Interfaces to the Physical Interfaces in the Configuration Utility https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.120...
  • Page 121 8 and the range for a 10G interface is set to 64. See the following table for sample base MAC addresses if the global base MAC address is set to 00:00:00:00:00:00. Table 1. Example of Base MAC Addresses Generated f rom a Global Base MAC Address Physical Interf ace Base MAC Address https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.121...
  • Page 122 MAC address is 00:00:00:00:00:00 and range is set to 8, a MAC address between 00:00:00:00:00:00 and 00:00:00:00:00:08 cannot be assigned to another physical interface. Maximum limit for a 1G interface is 8. Maximum limit for a 10G interface is 64. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.122...
  • Page 123 Generated— Generate a MAC address by using the base MAC address set earlier. 2. If you select Custom, enter a MAC Address. 3. Follow the instructions in the wizard. 4. Click Finish, and then click Close. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.123...
  • Page 124 To modify the values of the parameters of an SNMP trap destination, in the SNMP Trap Destinations pane, select the trap destination that you want to modify, and then click Modify. In the Modify SNMP Trap Destination dialog box, https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.124...
  • Page 125 (instance) is provisioned on the appliance. You can assign a severity level to an SNMP alarm. When you do so, the corresponding trap messages are assigned that severity level. Following are the severity levels defined on the appliance, in decreasing order of severity: https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.125...
  • Page 126 4. In the Modify SNMP Alarm dialog box, from the Severity list, select a severity level. 5. T o enable the alarm, select Enable Alarm. 6. Click OK, and then click Close. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.126...
  • Page 127 2. In the details pane, in the Action list, click Syslog Parameters. 3. In the Modify Syslog Parameters Configure Syslog Parametersdialog box, specify the date and time format. 4. Click OK, and then click Close. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.127...
  • Page 128 3. In the Create Mail Profile dialog boxpage, specify values for the mail profile parameters. For a description of a parameter, hover the mouse over the corresponding field. 4. Click Create, and then click Close. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.128...
  • Page 129 3. In the Create SMS ProfileCreate SMS Distribution List dialog box, specify values for the mail profile parameters. For a description of a parameter, hover the mouse over the corresponding field. 4. Click Create, and then click Close. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.129...
  • Page 130 Last State Change— Elapsed time (in days, hours, minutes, and seconds) since the last change in the state of the virtual server, that is, the duration of time for which the virtual server has been in the current state. T his information is https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.130...
  • Page 131 T o view the status of virtual servers 1. On the Configuration tab, in the navigation pane, click NetScaler > Entities > Service. 2. In the details pane, under Services, view the following statistics: https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.131...
  • Page 132 State— Effective state of the service group, which is based on the state of the member of the service group. For example, UP, DOWN, or OUT OF SERVICE. Last State Change— Elapsed time (in days, hours, minutes, and seconds) since the last change in the state of the https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.132...
  • Page 133 2. In the Configure Polling Interval dialog box, type the number of minutes you want to set as the time interval for which NetScaler SDX must poll the entity value. Minimum value of the polling interval is 30 minutes. Click OK. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.133...
  • Page 134 Management Service Events T he Events report is a pie chart representation of the number of events, segmented and color coded on the basis of their severity. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.134...
  • Page 135 T his report is a bar chart that displays the top 10 NetScaler instances according to the number of entity state changes for the selected time scale. T he entity state changes reflect entity up, entity down, or out of service events. Top 10 NetScaler Instances by Threshold Violation Events https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.135...
  • Page 136 You can click on the chart to drill down and view the user based configuration changes for a particular instance. You can further view the authorization and execution status details by clicking on this chart. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.136...
  • Page 137 filter criteria in the rule, the action associated with the rule is executed. T he conditions for which you can create filters are: severity, devices, failure objects, and category. You can assign the following actions to the events: https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.137...
  • Page 138 1. Mail Profile— Mail server and mail profile details. An email is triggered when the events meet the defined filter criteria. 2. SMS Profile— SMS server and SMS profile details. An SMS is triggered when the events meet the defined filter criteria. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.138...
  • Page 139 3. Alternatively, you can suppress the events by selecting the Suppress check box. You can also specify the NetScaler instances for which you want to suppress this event by using the Advanced option. 4. Click OK. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.139...
  • Page 140 Call Home feature on NetScaler instances from the Management Service user interface. Note: T he NetScaler instance has to be registered with the Citrix T echnical Support server before Call Home can upload the system data to the server when predefined error conditions occur on the appliance. Enabling the Call Home feature on the NetScaler instance initiates the registration process.
  • Page 141 T o poll the Call Home feature from all NetScaler instances and view the current status, navigate to Configuration > NetScaler > Call Home, and click Poll Now button. On the confirmation page, click Yes. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.141...
  • Page 142 For disks (Disk), the following details are displayed: Name Name of the physical disk. Size Size of the disk, in gigabytes (GB). Utilized Amount of data on the disk, in gigabytes (GB). https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.142...
  • Page 143 State (condition) of the fan. ERROR indicates a deviation from the expected value. NA indicates that the fan is not present. Current Value (RPM) Current rotations per minute. Temperature information includes the following details: Name https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.143...
  • Page 144 Number of packets received since the appliance was last started. Tx Bytes Number of bytes transmitted since the appliance was last started. Rx Bytes Number of bytes received since the appliance was last started. Tx Errors https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.144...
  • Page 145 Number of errors in transmitting data since the appliance was last started. Rx Errors Number of errors in receiving data since the appliance was last started. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.145...
  • Page 146 T he backup policy runs at 00:30 A.M. every day and creates a backup of logs and configuration files. By default, the policy retains three backups, but you can specify the number of backups you want to keep. To specify the number of days for which logged data is pruned https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.146...
  • Page 147 Generating a Tar Archive f or Technical Support You can use the Technical Support option to generate a tar archive of data and statistics for submission to Citrix technical support. T his tar can be generated for the Management Service or the XenServer, or for both at the same time. You can then download the file to your local system and send it to Citrix technical support.
  • Page 148 Log on by using the administrator credentials. You can access detailed information about command usage and syntax from the man pages. Note: CLI is not supported over console access. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.148...
  • Page 149 Adding a User Group To add a user group 1. On the Conf iguration tab, under System, expand Administration, and then click Groups. 2. In the details pane, click Add. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.149...
  • Page 150 4. Click Create or OK, and then click Close. T he user that you created is listed in the Users pane. To remove a user account 1. On the Configuration tab, in the navigation pane, expand System, expand Administration, and then click Users. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.150...
  • Page 151 1. On the Conf iguration tab, click System. 2. In the System Settings group, click Change System Settings. 3. In the Conf igure System Settings dialog box, clear the Allow Basic Authentication check box. 4. Click OK. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.151...
  • Page 152 3. In the Create Radius Server dialogue box, type or select values for the parameters: Name*— Name of the server. IP Address*— Server IP address. Port*— Port on which the RADIUS server is running. Default value: 1812. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.152...
  • Page 153 Search Filter— String to be combined with the default LDAP user search string to form the value. For example, vpnallowed=true with ldaploginame samaccount and the user-supplied username bob would yield an LDAP https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.153...
  • Page 154 Group Search Filter— String to be combined with the default LDAP group search string to form the search value. 4. Click Create, and then click Close. Adding a TACACS Server Note: External authentication support on a NetScaler SDX appliance is available only on NetScaler release 10.1.e. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.154...
  • Page 155 Accounting— Enables Management Service to log audit information with T ACACAS server. Default Authentication Group— Default group that is chosen when the authentication succeeds in addition to extracted groups. 4. Click Create, and then click Close. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.155...
  • Page 156 If you remove an interface from an LA channel, the changes are stored in the database, and the interface appears in the Network Settings view when you add or modify an instance. Before you delete the interface, only the channel that the interface is a part of is listed. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.156...
  • Page 157 Alias Name— Alias name for the LA channel. Used only to enhance readability. T o perform any operations, you have to specify the LA channel ID. 6. Click Create, and then click Close. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.157...
  • Page 158 To restore the configuration data on an SDX appliance, the Management Service selects the latest NetScaler .XVA image to provision the NetScaler instances. Citrix recommends that you store only the version of the NetScaler .XVA image that you require to reprovision the NetScaler instances. If you store multiple .XVA images, the Management Service might provision a NetScaler instance by using an image that is different from the one that you require.
  • Page 159 Before performing a factory reset, back up all the data stored on the appliance, including the settings of all the NetScaler instances provisioned on the appliance. Citrix recommends that you store the files outside the appliance. Performing a factory reset terminates all current client sessions with the Management Service, so you have to log back on to the Management Service for any additional configuration tasks.
  • Page 160 Password*— T he password used to log on to the NetScaler instance. Maximum length: 31 characters. Confirm Password*— T he password used to log on to the NetScaler instance. * A required parameter https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.160...
  • Page 161 VPX instance, select the NSVLAN option. Citrix recommends the default setting— NSVLAN not selected. You cannot change this setting after you have provisioned the NetScaler instance.
  • Page 162 Note: For a high availability setup (active-active or active-standby), Citrix recommends that you configure the two NetScaler instances on different SDX appliances. Make sure that the instances in the setup have identical resources, such as CPU, memory, interfaces, packets per second (PPS), and throughput.
  • Page 163 T he IPv6 VRID that identifies the VMAC. Possible values: 1 to 255. For more information, see Configuring VMACs on an Interface. MAC Address Mode Assign a MAC address. Select from one of the following options: Default— XenServer assigns a MAC address. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.163...
  • Page 164 VLAN ID, so that one company does not see the other company's traffic. If an instance administrator, while provisioning or modifying a VPX instance, tries to assign an interface to an 802.1Q VLAN, a https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.164...
  • Page 165 IPv6 dynamic routing protocols from the VT YSH command line. 5. Select the interfaces that should be part of the VLAN. 6. Click Create, and then click Close. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.165...
  • Page 166 T o set up a cluster, you must understand NetScaler clustering. For more information, see Clustering. For clusters that have NetScaler instances across SDX appliances, Citrix recommends that you use NetScaler instances from three SDX appliances. T his ensures that the cluster criteria of a minimum of (n/2 +1) nodes is always satisfied.
  • Page 167 Note: Make sure the values of the Cluster IP address and Cluster IP Password parameters are for the cluster to which you want to add the node. 5. Click Next to view the configuration summary. 6. Click Finish to add the node to the cluster. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.167...
  • Page 168 2. In the details pane, under NetScaler Configuration, click Save Configuration. 3. In the Save Configuration dialog box, in Instance IP Address, select the IP addresses of the NetScaler instances whose configuration you want to save. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.168...
  • Page 169 To apply the admin configuration on a NetScaler instance 1. On the Configuration tab, in the navigation pane, click NetScaler. 2. In the details pane, under NetScaler Configuration, click Apply Admin Configuration. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.169...
  • Page 170 3. In the Apply Admin Configuration dialog box, in Instance IP Address, select the IP address of the NetScaler VPX instance on which you want to apply the admin configuration. 4. Click OK. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.170...
  • Page 171 Name T he name of the key file. Last Modif ied T he date when the key file was last modified. Size the size of the key file in bytes. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.171...
  • Page 172 You can update some parameters, such as the certificate file, key file, and certificate format of an SSL certificate that is installed on a NetScaler instance. You cannot modify the IP address and certificate name. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.172...
  • Page 173 2. In the SSL Certificates pane, click Poll Now. 3. In the Confirm dialog box, click Yes. T he SSL Certificates pane is refreshed and new certificates, if any, appear in the list. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.173...
  • Page 174 T agged. Note: Citrix recommends that you select Tagged for all interfaces assigned to instances in L2 mode. Note that if you select tagged, you cannot receive untagged packets on that interface. If you have selected Tagged for an interface assigned to an instance, log on to that instance and configure a 802.1q VLAN to receive packets on that interface.
  • Page 175 VRID IPv6— T he IPv6 VRID that identifies the VMAC. Possible values: 1 to 255. Note: Use a comma to separate multiple VRIDs. For example, 12,24. 2. Follow the instructions in the wizard. 3. Click Finish, and then click Close. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.175...
  • Page 176 4. In the Add T emplate dialog box, add a name and description for the template. 5. In the Command text box, paste the list of commands that you copied from the configuration file 6. Click Create, and then click Close. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.176...
  • Page 177 3. Click the arrow next to the name of a NetScaler instance to view the properties of that instance, or click Expand All to view the properties of all the NetScaler instances. You can view the following properties: Netmask T he netmask IP address of the NetScaler instance. Gateway https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.177...
  • Page 178 2. In the NetScaler Instances pane, click the NetScaler instance for which you want to view the running or saved configuration. 3. T o view the running configuration, click Running Configuration, and to view the saved configuration, click Saved Configuration. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.178...
  • Page 179 1. On the Configuration tab, in the left pane, expand NetScaler Configuration, and then click Instances. 2. In the NetScaler Instances pane, click the NetScaler instance you want to rediscover, and then click Rediscover. 3. In the Confirm message box, click Yes. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.179...
  • Page 180 Use task logs to view and track tasks, such as upgrading instances and installing SSL certificates, that are executed by the Management Service on the NetScaler instances. T he task log lets you view whether a task is in progress or has failed or has succeeded. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.180...
  • Page 181 Use the Events pane in the Management Service user interface to monitor the events generated by the Management Service for tasks performed on the Management Service. To view the events https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.181...
  • Page 182 T he category of event, such as PolicyFailed and DeviceConfigChange. Message T he message describing the event. 3. T o sort the events by a particular field, click the heading of the column. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.182...
  • Page 183 Consolidation when the Management Service and the NetScaler instances are in different networks but all the instances are in the same network Consolidation across security zones Consolidation with dedicated interfaces for each instance Consolidation with sharing of a physical port by more than one instance https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.183...
  • Page 184 T he following table lists the names and values of the parameters used for provisioning NetScaler Instance 1 in the above example. Parameter Name Values f or Instance 1 Name vpx8 IP Address 10.1.1.2 Netmask 255.255.255.0 https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.184...
  • Page 185 3. In the Provision NetScaler Wizard follow the instructions in the wizard to specify the parameter values shown in the above table. 4. Click Create, and then click Close. T he NetScaler instance you provisioned appears in the NetScaler Instances pane. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.185...
  • Page 186 T he following table lists the names and values of the parameters used for provisioning NetScaler Instance 1 in this example. Parameter Name Values f or Instance 1 Name vpx1 IP Address 10.1.2.2 https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.186...
  • Page 187 3. In the Provision NetScaler Wizard follow the instructions in the wizard to set the parameters to the values shown in the above table. 4. Click Create, and then click Close. T he NetScaler instance you provisioned appears in the NetScaler Instances pane. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.187...
  • Page 188 Management Service, the traffic between the Management Service and NetScaler instances does not have to be routed, unless your setup explicitly requires it. Note: T agging is supported in XenServer version 6.0. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.188...
  • Page 189 Values f or Instance 5 Values f or Instance 3 Name vpx5 vpx3 IP Address 10.1.3.2 10.1.200.2 Netmask 255.255.255.0 255.255.255.240 Gateway 10.1.3.1 10.1.200.1 XVA File NS-VPX-XEN-10.0-51.308.a_nc.xva NS-VPX-XEN-10.0-51.308.a_nc.xva Feature License Platinum Platinum https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.189...
  • Page 190 3. In the Provision NetScaler Wizard follow the instructions in the wizard to set the parameters to the values shown in the above table. 4. Click Create, and then click Close. T he NetScaler instance you provisioned appears in the NetScaler Instances pane. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.190...
  • Page 191 Figure 1. Network topology of an SDX appliance with Management Service and NetScaler instances distributed across networks T he following table lists the names and values of the parameters used for provisioning NetScaler instances 7 and 4 in this example. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.191...
  • Page 192 Shell/Sftp/Scp Access True True Total Memory (MB) 2048 2048 #SSL Chips T hroughput (Mbps) 1000 1000 Packets per second 1000000 1000000 Shared Shared Interface 1/1 and 1/7 1/1 and 1/7 NSVLAN https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.192...
  • Page 193 3. In the Provision NetScaler Wizard follow the instructions in the wizard to set the parameters to the values shown in the above table. 4. Click Create, and then click Close. T he NetScaler instance you provisioned appears in the NetScaler Instances pane. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.193...
  • Page 194 Solid State Drive (SSD). T he Citrix NetScaler models SDX 8400 and SDX 8600 are 1U appliances. Each model has one quad-core processor (8 cores with hyper-threading) and 32 gigabytes (GB) of memory. T he SDX 8400/8600 appliances are available in two port...
  • Page 195 You can convert a NetScaler MPX appliance to a NetScaler SDX appliance by upgrading the software through a new Solid State Drive (SSD) and a new Hard Disk Drive (HDD). Citrix supplies a field conversion kit to migrate a NetScaler MPX appliance to a NetScaler SDX appliance.
  • Page 196 2. Run the following command from the command line interface of the appliance to display the serial number: show hardware T he serial number might be helpful in the event that you want to contact Citrix Technical Support. Example > show hardware...
  • Page 197 System Health Statistics(Auxiliary): Voltage 0 (Volts) 0.00 Voltage 1 (Volts) 0.00 Voltage 2 (Volts) 0.00 Voltage 3 (Volts) 0.00 Voltage 4 (Volts) 1.50 Voltage 5 (Volts) 0.00 Voltage 6 (Volts) 0.00 https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.197...
  • Page 198 Copy this file to another computer for future reference. T he output of the command might be helpful in the event that you want to contact Citrix T echnical Support. 8. At the NetScaler command line interface, switch to the shell prompt. T ype: shell 9.
  • Page 199 12. Run the following command to execute the ns_hw_err.bash script, which checks for latent hardware errors: root@ns# /netscaler/ns_hw_err.bash Example root@ns# /netscaler/ns_hw_err.bash NetScaler NS10.1: Build 127.11.nc, Date: Aug 11 2014, 18:24:36 platform: serial 2NSHJ2DR9E platform: sysid 1400210 - NSMPX-11500 12*CPU+8*IX+4*E1K+2*E1K+2*CVM N3 HDD MODEL: Device Model: ST1000NM0033-9ZM173 https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.199...
  • Page 200 Are you sure you want to completely stop NetScaler (Y/N)? [N]:y To upgrade the appliance 1. Locate the solid-state drive on the back panel of the appliance, as shown in the following figure: https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.200...
  • Page 201 2. Verify that the replacement solid-state drive (SSD) is the one required for your NetScaler model. T he Citrix label is on the top of the solid-state drive, which is pre-populated with a new version of BIOS and a recent build of the required Service VM software.
  • Page 202 7. Apply the new licenses. For instructions, see NetScaler SDX Licensing Overview. 8. Navigate to Configuration > System and, in the System Administration group, click Reboot Appliance. Click Yes to https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.202...
  • Page 203 You are now ready to provision the VPX instances on the NetScaler SDX appliance. For instructions, see Provisioning NetScaler Instances. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.203...
  • Page 204 T herefore, restart the MPX appliance after you connect the transceivers. 7. Run the following commands for each of the interfaces: > enable interface 1/x > enable interface 10/x where x is the new interface number. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.204...
  • Page 205 19. Locate the solid-state drive on the back panel of the appliance, as shown in the following figure: 20. Verify that the replacement solid-state drive is the one required for your NetScaler model. T he Citrix label is on the top of the solid-state drive, which is pre-populated with a new version of BIOS and a recent build of the required Service VM software.
  • Page 206 Note: After the conversion is complete, the LCD display might display CITRIX/NetScaler SDX. If so, you must switch off the appliance through the Service VM so that, after you power the appliance back on, it displays Citrix NSSDX- 8200 or Citrix NSSDX-8200 10G. On the Service VM configuration page, in the System section, click the Shut Down Appliance link.
  • Page 207 You can convert a NetScaler MPX appliance to a NetScaler SDX appliance by upgrading the software through a new Solid State Drive (SSD). Citrix supplies a field conversion kit to migrate a NetScaler MPX appliance to a NetScaler SDX appliance.
  • Page 208 T he serial number might be helpful in the event that you want to contact Citrix Technical Support. Example > show hardware Platform: NSMPX-14000 12*CPU+16*IX+2*E1K+2*CVM N3 250101 Manufactured on: 10/2/2015 CPU: 2600MHZ Host Id: 234913926 Serial no: JSW4UCKKM5 Encoded serial no: JSW4UCKKM5 Done >...
  • Page 209 (AP): APIC ID: 40 cpu11 (AP): APIC ID: 42 cpu0: <ACPI CPU> on acpi0 acpi_throttle0: <ACPI CPU T hrottling> on cpu0 cpu1: <ACPI CPU> on acpi0 acpi_throttle1: <ACPI CPU T hrottling> on cpu1 https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.209...
  • Page 210 NetScaler NS10.1: Build 133.11.nc, Date: Sep 21 2015, 17:59:51 platform: serial JSW4UCKKM5 platform: sysid 250101 - NSMPX-14000 12*CPU+16*IX+2*E1K+2*CVM N3 HDD MODEL: ar0: 227328MB <Intel MatrixRAID RAID1> status: READY https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.210...
  • Page 211 1. Power off the NetScaler appliance. 2. Locate two solid-state drives (SSDs) on the back of the appliance in slot #1 and slot #2, as shown in the following figure: https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.211...
  • Page 212 3. Verify that the replacement solid-state drives (SSDs) are the ones required for your NetScaler model. T he conversion requires minimum of four SSDs. T he Citrix label is on the top of one of the solid-state drives, which is pre-populated with a new version of BIOS and a recent build of the required NetScaler SDX Management Service.
  • Page 213 Netmask*— T he subnet mask for the subnet in which the SDX appliance is located. Gateway*— T he default gateway for the network. DNS Server— T he IP address of the DNS server. *A mandatory parameter https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.213...
  • Page 214 Navigate to Configuration > System and, in the System Administration group, click Reboot Appliance. Click Yes to confirm. You are now ready to provision the VPX instances on the NetScaler SDX appliance. For instructions, Provisioning NetScaler Instances. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.214...
  • Page 215 You can convert a NetScaler MPX appliance to a NetScaler SDX appliance by upgrading the software through a new Solid State Drive (SSD). Citrix supplies a field conversion kit to migrate a NetScaler MPX appliance to a NetScaler SDX appliance.
  • Page 216 2. Run the following command from the command line interface of the appliance to display the serial number: show hardware T he serial number might be helpful in the event that you want to contact Citrix Technical Support. 3. Run the following command to display the status of the active 10G interfaces: show interface 4.
  • Page 217 3. Verify that the replacement solid-state drives (SSDs) are the ones required for your NetScaler model. T he conversion requires minimum of four SSDs. T he Citrix label is on the top of one of the solid-state drives, which is pre- populated with a new version of BIOS and a recent build of the required NetScaler SDX Management Service.
  • Page 218 © 1999-2017 Citrix Systems, Inc. All rights reserved. p.218...
  • Page 219 Websense Protector provides monitoring and blocking capabilities, preventing data loss and leaks of sensitive information. BlueCat DNS/DHCP Server delivers DNS and DHCP for your network. PaloAlto VM-Series on Citrix NetScaler SDX enables consolidation of advanced security and ADC capabilities on a single platform, for secure, reliable access to applications by businesses, business units, and service-provider customers.
  • Page 220 Modify. In the Modify SECUREMAT RIX GSB wizard, modify the parameters. Note: If you modify any of the interface parameters or the name of the instance, the instance stops and restarts to put https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.220...
  • Page 221 2. In the details pane, from the Action list, select Upload. 3. In the Upload SDXT ools Files dialog box, click Browse, navigate to the folder that contains the file, and then double-click the file. 4. Click Upload. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.221...
  • Page 222 Management Service fetches the configuration and the version of the SECUREMAT RIX GSB running on the SDX appliance. By default, the Management Service schedules instances for rediscovery once every 30 minutes. On the Configuration tab, expand SECUREMAT RIX GSB. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.222...
  • Page 223 1. Click Instances. 2. In the details pane, select the instance that you want to rediscover, and from the Action list, click Rediscover. 3. In the Confirm message box, click Yes. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.223...
  • Page 224 Instances pane, select the instance that you want to modify, and then click Modify. In the Modify Websense Protector wizard, set the parameters. Do not modify the interfaces that were selected at the time of provisioning a Websense https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.224...
  • Page 225 3. In the Upload SDXT ools Files dialog box, click Browse, navigate to the folder that contains the file, and then double-click the file. 4. Click Upload. To upgrade SDXTools https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.225...
  • Page 226 2. In the details pane, select the instance for which you want to trace the route, and from the Action list, click T raceRoute. T he T raceroute message box displays the route to the instance. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.226...
  • Page 227 1. Click Instances. 2. In the details pane, select the instance that you want to rediscover, and from the Action list, click Rediscover. 3. In the Confirm message box, click Yes. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.227...
  • Page 228 Jan 31, 20 11 BlueCat DNS/DHCP Server™ is a software solution that can be hosted on the Citrix NetScaler SDX platform to deliver reliable, scalable and secure DNS and DHCP core network services without requiring additional management costs or data center space.
  • Page 229 2. In the details pane, select the instance on which you want to perform the operation, and then select one of the following options: Start Shut Down Reboot Force Shutdown Force Reboot 3. In the Confirm message box, click Yes. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.229...
  • Page 230 1. Click Instances. 2. In the details pane, select the instance that you want to rediscover, and from the Action list, click Rediscover. 3. In the Confirm message box, click Yes. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.230...
  • Page 231 Modif y . In the Modify CA Access Gateway wizard, set the parameters to values suitable for your environment. Note: If you modify any of the interface parameters or the name of the instance, the instance stops and restarts to put the change into effect. Updated: 2014-11-04 https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.231...
  • Page 232 2. In the details pane, select the instance on which you want to perform the operation, and then select one of the following options: Start Shut Down Reboot Force Shutdown Force Reboot 3. In the Confirm message box, click Yes. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.232...
  • Page 233 ADC capabilities on a single platform, for secure, reliable access to applications by businesses, business units, and service-provider customers. T he combination of VM-Series on Citrix NetScaler SDX also provides a complete, validated, security and ADC solution for Citrix XenApp and XenDesktop deployments.
  • Page 234 2. In the details pane, select the instance that you want to rediscover, and from the Action list, click Rediscover Rediscover. 3. In the Confirm message box, click Yes Yes . https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.234...
  • Page 235 © 1999-2017 Citrix Systems, Inc. All rights reserved. p.235...
  • Page 236 NITRO API Jun 0 3, 20 14 T he Citrix NetScaler SDX NIT RO protocol allows you to configure and monitor the NetScaler SDX appliance programmatically. NIT RO exposes its functionality through Representational State Transfer (REST ) interfaces. T herefore, NIT RO applications can be developed in any programming language.
  • Page 237 NIT RO functionality. T he <NIT RO_SDK_HOME> folder also provides samples and documentation that can help you understand the NIT RO SDK. Note: T he REST package contains only documentation for using the REST interfaces. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.237...
  • Page 238 NIT RO APIs are synchronous in nature. T his means that the client application waits for a response from the NIT RO web service before executing another NIT RO API. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.238...
  • Page 239 Each of these packages or namespaces contain a class named <resource_type> that provides the APIs to configure the resource. For example, the NetScaler resource has the com.citrix.sdx.nitro.resource.config.ns package or namespace. A resource class provides APIs to perform other operations such as creating a resource, retrieving resource details and statistics, updating a resource, deleting resources, and performing bulk operations on resources.
  • Page 240 Ret rieving Resource St at ist ics Ret rieving Resource St at ist ics A NetScaler SDX appliance collects statistics on the usage of its features. You can retrieve these statistics using NIT RO. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.240...
  • Page 241 Each resource class has methods that take an array of resources for adding, updating, and removing resources. To perform a bulk operation, specify the details of each operation locally and then send the details at one time to the server. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.241...
  • Page 242 T he error message field provides a brief explanation and the nature of the failure. All exceptions in the execution of NIT RO APIs are caught by the com.citrix.sdx.nitro.exception.nitro_exception class. To get information about the exception, you can use the getErrorCode() method.
  • Page 243 Each of these packages or namespaces contain a class named <resource_type> that provides the APIs to configure the resource. For example, the NetScaler resource has the com.citrix.sdx.nitro.resource.config.ns package or namespace. A resource class provides APIs to perform other operations such as creating a resource, retrieving resources and resource properties, updating a resource, deleting resources, and performing bulk operations on resources.
  • Page 244 Ret rieve Resource St at ist ics Ret rieve Resource St at ist ics A NetScaler SDX appliance collects statistics on the usage of its features. You can retrieve these statistics using NIT RO. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.244...
  • Page 245 Each resource class has methods that take an array of resources for adding, updating, and removing resources. To perform a bulk operation, specify the details of each operation locally and then send the details at one time to the server. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.245...
  • Page 246 T he error message field provides a brief explanation and the nature of the failure. All exceptions in the execution of NIT RO APIs are caught by the com.citrix.sdx.nitro.exception.nitro_exception class. To get information about the exception, you can use the getErrorCode() method.
  • Page 247 To connect to a NetScaler SDX appliance with IP address 10.102.31.16 by using the HT T PS protocol: URL. https://10.102.31.16/nitro/v1/config/login URL. HT T P Met hod. POST HT T P Met hod. Request P ayload. Request P ayload. object= " login" : https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.247...
  • Page 248 For example, to create a NetScaler instance named vpx1: URL. https://10.102.31.16/nitro/v1/config/ns URL. HT T P Met hod. POST HT T P Met hod. Cookie. SESSID=##78C060... Cookie. Request P ayload. Request P ayload. object= https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.248...
  • Page 249 T he URL has the form: http://<IP>/nitro/v1/config/<resource_type>?pageno=<value>&pagesize=<value>. You do not have to retrieve all the pages, or retrieve the pages in order. Each request is independent, and you can even change the pagesize setting between requests. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.249...
  • Page 250 Met hod. PUT Cookie. SESSID=##78C060... Cookie. Request P ayload. Request P ayload. " ns" : " name" :" vpx2" , " id" :" 123456a" Delet ing a Resource Delet ing a Resource https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.250...
  • Page 251 T o add multiple resources (two NetScalers and two MPS users) in one operation and continue if one command fails: URL. https://10.102.29.60/nitro/v1/config/ URL. HT T P Met hod. POST HT T P Met hod. Cookie. SESSID=##78C060... Cookie. Request P ayload. Request P ayload. object= https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.251...
  • Page 252 T he response payload of all operations, specifies the error code and error message. For example, to get the status of a operation: URL. http://10.102.31.16/nitro/v1/config/ping URL. HT T P Met hod. GET HT T P Met hod. Cookie. SESSID=##78C060... Cookie. Response P ayload. Response P ayload. https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.252...
  • Page 253 " errorcode" :-1, " message" :" IP address is missing" https://docs.citrix.com © 1999-2017 Citrix Systems, Inc. All rights reserved. p.253...

This manual is also suitable for:

Netscaler sdx 8400Netscaler sdx 8600Netscaler sdx 11515Netscaler sdx 11520Netscaler sdx 11530Netscaler sdx 11540 ... Show all