Product Documentation

Converting a NetScaler MPX 24100 and 24150 Appliance to a NetScaler SDX 24100 and 24150 Appliance

Apr 12, 2016

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.

The conversion requires minimum of four SSDs.

Note: Citrix recommends that you configure the Lights Out Management (LOM) Port of the NetScaler appliance before starting the conversion process. For more information on the LOM port of the NetScaler appliance, see Lights Out Management Port of the NetScaler Appliance.

To convert a NetScaler MPX appliance to a NetScaler SDX appliance, you must access the appliance through a console cable attached to a computer or terminal. Before connecting the console cable, configure the computer or terminal to support the following configuration:

  • VT100 terminal emulation
  • 9600 baud
  • 8 data bits
  • 1 stop bit
  • Parity and flow control set to NONE

Connect one end of the console cable to the RS232 serial port on the appliance, and the other end to the computer or terminal.

Note: To use a cable with an RJ-45 converter, insert the optional converter into the console port and attach the cable to it.

Citrix recommends you to connect a VGA monitor to the appliance to monitor the conversion process, because the LOM connection is be lost during the conversion process.

With the cable attached, verify that the MPX appliance’s components are functioning correctly. You are then ready to begin the conversion. The conversion process modifies the Basic Input-Output System (BIOS), installs XenServer hypervisor and a Service Virtual Machine image, and copies the NetScaler VPX image to the Solid State Drive.

The conversion process also sets up a Redundant Array of Independent Disks (RAID) controller for local storage (SSD slot # 1 and SSD slot # 2) and Netscaler VPX storage (SSD slot # 3 and SSD slot # 4).

After the conversion process, you make a few modifications to the appliance’s configuration and apply a new license. You can then provision the VPX instances through the Management Service on what is now a NetScaler SDX appliance.

To verify proper operation of the MPX appliance’s components

1.    Access the console port and enter the administrator credentials. 2.    Run the following command from the command line interface of the appliance to display the serial number:     show hardware     The 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.    In the show interface command’s output, verify that all of the interfaces are enabled and the status of every     interface is shown as UP/UP.     Note: If you do not have an SFP+ transceiver for every port, verify the interfaces in stages. After checking the     first set of interfaces, unplug the SFP+ transceivers and plug them in to the next set of ports. 5.    Run the following command for each of the interfaces that are not in the UP/UP state:     o enable interface 10/x     o enable interface 1/x     where x is the new interface number. 6.    Run the following command to verify that the status of the power supplies is normal: stat system -detail 7.    Run the following command to generate a tar of system configuration data and statistics: show techsupport     Note: The output of the command is available in the /var/tmp/support/collector_<IP_address>_P_<date>.tar.gz file.     Copy this file to another computer for future reference. The output of the command might be helpful in the event that     you want to contact Citrix Technical Support. 8.    At the NetScaler command line interface, switch to the shell prompt. Type: shell 9.    Run the following command to verify the number of Cavium cards available depending upon your appliance:     root@ns# grep “cavium”  /var/nslog/dmesg.boot 10.    Run the following command to verify the RAM memory reserved for shared memory depending upon your appliance:     root@ns# grep “memory” /var/nslog/dmesg.boot 11.    Run the following command to verify the number of CPU cores depending upon your appliance :     root@ns# grep “cpu” /var/nslog/dmesg.boot 12.    Run the following command to verify that the /var drive is mounted as /dev/ad8s1e: root@ns# df -h 13.    Run the following command to execute the ns_hw_err.bash script, which checks for latent hardware errors: root@ns#     ns_hw_err.bash 14.    Important: Physically disconnect all ports except the LOM port, including the management port, from the network. 15.    At the shell prompt, switch to the NetScaler command line. Type: exit 16.    Run the following command to shut down the appliance: shutdown -p now

To upgrade the appliance

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:

localized image

3.    Verify that the replacement solid-state drives (SSDs) are the ones required for your NetScaler model. The conversion     requires minimum of four SSDs. The 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. This SSD     must be installed in slot # 1. 4.    Remove the SSDs by pushing the safety latch of the drive cover down while pulling the drive handle. 5.    On the new Citrix Certified SSD drive, open the drive handle completely to the left, and then insert the new drive     into the slot #1 as far as possible. 6.    To seat the drive, close the handle flush with the rear side of the appliance so that the drive locks securely into     the slot.     Important: The orientation of the SSD is important. When you insert the drive, make sure that the Citrix product     label is at the top. 7.    Insert a second Citrix certified SSD, which matches the capacity of the SSD in slot #1, in slot # 2. Insert     additional blank Citrix certified SSDs in slots #3 and #4.

    Important: Note that mixing and matching of old and new SSDs is not supported. SSDs in slot #1 and slot # 2, which     constitute the first RAID pair (local storage), must be of same size and type. Similarly, SSDs in slot # 3 and slot #     4, which constitute the second RAID pair (VPX storage), must be of same size and type. Do not use any other drives     that are not part of the provided conversion kit.

8.    Disconnect all network cables from the data ports and the management ports. 9.    Start the NetScaler appliance. For instructions, see “Switching on the Appliance” in Installing the Hardware.     The conversion process can run for approximately 30 minutes, during which you must not power cycle the appliance. The     entire conversion process might not be visible on the console and might appear to be unresponsive.     The conversion process updates the BIOS, installs the XenServer hypervisor and the Management Service Operating     system, and copies the NetScaler VPX image to the SSD for instance provisioning, and forms the Raid1 pair.     Note: The serial number of the appliance remains the same. 10.    Keep the console cable attached during the conversion process. Allow the process to complete, at which point the     netscaler-sdx login: prompt appears. 11.    During the conversion process the LOM port connection may be lost as it resets the IP address to the default value of The conversion status output is available on the VGA monitor.