Page 1
Sep 0 1, 20 16 T he Citrix NetScaler SDX appliance is a multitenant platform on which you can provision and manage multiple virtual NetScaler machines (instances). T he SDX appliance addresses cloud computing and multitenancy requirements by allowing a single administrator to configure and manage the appliance and delegate the administration of each hosted instance to...
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.
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 a NetScaler appliance.
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).
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 16
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...
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.
(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.
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 21
Aug 0 1, 20 17 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 22
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: 300 GB removable solid-state drive, which is used to store the NetScaler software and the user data.
Page 23
SDX 16500, SDX 18500, and SDX 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 25
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 27
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 29
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 31
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 32
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 33
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 35
SDX 14060, SDX 14080 and SDX 14100 Dec 22, 20 16 The Citrix NetScaler SDX 14020/14030/14040/14060/14080/14100 are 2U appliances. Each model has two 6-core processors and 64 gigabytes (GB) of memory and sixteen 10G SFP+ ports (16x10G SFP+). Note: For information about NetScaler SDX hardware and component compatibility matrix, see https://docs.citrix.com/en-us/sdx/11/sdx-ag-supported-versions-...
Page 37
Mar 24 , 20 16 T he Citrix NetScaler SDX 14020 40G, SDX 14040 40G, SDX 14060 40G, SDX 14080 40G, and SDX 14100 40G are 2U appliances. Each model has two 6-core processors and 64 gigabytes (GB) of memory. T he SDX 14020 40G, 14040 40G, SDX 14060 40G, SDX 14080 40G, and SDX 14100 40G appliances are available in the four 40G QSFP+ ports and sixteen 10G SFP+ ports (4x40G QSFP+ + 16x10G SFP+) configuration.
Page 38
Figure 2. Citrix NetScaler SDX 14020 40G, SDX 14040 40G, SDX 14060 40G, SDX 14080 40G, back panel T he following components are visible on the back panel of the SDX 14020 40G, SDX 14040 40G, SDX 14060 40G, SDX 14080 40G appliance: T wo 240 GB removable solid-state drives (SSDs).
Page 39
Mar 24 , 20 16 T he Citrix NetScaler SDX 25100-40G, SDX 25160-40G are 2U appliances. Each model has two 10-core processors, 256 gigabytes (GB) of memory, four 40G QSFP+ ports, and sixteen 10G SFP+ ports (4x40G QSFP+ + 16x10G SFP+).
Page 41
Citrix NetScaler SDX 25100A, SDX 25160A Jan 11, 20 17 T he Citrix NetScaler SDX 25100A and SDX 25160A are 2U appliances. Each model has two 10-core processors, 256 GB of memory, eight 40GE QSFP+ ports (8x40GE QSFP+). T he following figure shows the front panel of the SDX 25100A and SDX 25160A appliance.
Page 43
14080-40S, SDX 14100-40S May 0 2, 20 17 T he Citrix NetScaler SDX 14040-40S/14060-40S/14080-40S/14100-40S are 2U appliances. Each model has two 6-core processors and 64 gigabytes (GB) of memory and four 40GE QSFP+ ports and eight 10GE SFP+(4x 40GE QSFP+; 8x 10GE SFP+).
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 55
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.
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 extended) rail kit.
Page 61
SDX 24100/24150 Important 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. Insert 1G SFP transceivers into the 1G SFP ports on the front panel of the appliance. Frequent installation and removal of transceivers shortens their life span.
Page 63
SDX 25160A-40G/25100A-40G Important NetScaler appliances do not support support 40G QSFP+/10G SFP+ transceivers provided by vendors other than Citrix Systems. Attempting to install third-party support 40G QSFP+/10G SFP+ transceivers on your NetScaler appliance voids the warranty. Insert the support 40G QSFP+/10G SFP+ transceivers into the support 40G QSFP+/10G SFP+ ports on the front panel of the appliance.
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 68
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.
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 Changing the Password of the Default User Account .
Page 71
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 74
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 79
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 83
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 93
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 Conf iguration > System > RAID. T he new SSD is listed in the Physical Drives section.
Page 96
4. Physically remove the defective drive from the slot. 5. Insert the new Citrix certified SSD in the slot from where you removed the defective SSD. 6. On the Physical Drives tab, click the refresh icon to refresh the list of physical drives. T he state of the drive should now appear as Present.
Page 97
SSDs, delete the logical drive, replace both the failed SSDs with new Citrix certified SSDs, and create the logical drive again. To replace two f ailed SSDs 1. In the Management Service, on the Dashboard tab, in the right-side panel, under Storage Repositories, click Details to identify the storage repository associated with the failed SSDs.
Page 133
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
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 Conf iguration > System > RAID. T he new SSD is listed in the Physical Drives section.
Page 144
4. Physically remove the defective drive from the slot. 5. Insert the new Citrix certified SSD in the slot from where you removed the defective SSD. 6. On the Physical Drives tab, click the refresh icon to refresh the list of physical drives. T he state of the drive should now appear as Present.
Page 145
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 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 157
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
NetScaler instances provisioned on the appliance. Citrix recommends that you store the files outside the appliance. Performing an appliance 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 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 169
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 177
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 197
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 207
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 212
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 215
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 218
T he NIT RO protocol can be used to configure resources of the NetScaler SDX appliance. T he APIs to configure a resource are grouped into packages or namespaces that have the format com.citrix.sdx.nitro.resource.config.<resource_type>. Each of these packages or namespaces contain a class named <resource_type> that provides the APIs to configure the resource.
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 222
Note: Content types such as 'application/x-www-form-urlencoded' that were supported in earlier versions of NIT RO can also be used. You must make sure that the payload is the same as used in earlier versions. T he payloads provided in this documentation are only applicable if the content type is of the form 'application/vnd.com.citrix.sdx.login+json'. Payload "login":...
Page 228
8010/8015/8400/8600 appliances by upgrading the software through a new Solid State Drive (SSD). T he Citrix NetScaler models SDX 8010/8015/8400/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 8010/8015/8400/8600 appliances are available in...
Page 229
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 230
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 232
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 235
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 239
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 240
23. Close the handle flush with the rear side of the appliance so that the solid-state drive locks securely into the slot. Important: T he orientation of the solid-state drive is important. Make sure that the Citrix product label is facing up when you insert the drive.
Page 241
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 242
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 246
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 249
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 250
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 251
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 252
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 253
Encoded serial no: KZCHGCN810 Done > 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 interfaces: show interface Example >...
Page 275
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 278
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 279
T he serial number might be helpful in the event that you want to contact Citrix Technical Support. Example > show hardware Platform: NSMPX-25000 20*CPU+16*F1X+4*F4X+2*E1K+2*CVM N3 250040 Manufactured on: 3/21/2016 CPU: 2800MHZ Host Id: 234913926 Serial no: 9AEXPCN859 Encoded serial no: 9AEXPCN859 Done 3.
Page 304
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.
Need help?
Do you have a question about the NetScaler SDX 8015 and is the answer not in the manual?
Questions and answers