Product Documentation

Converting a NetScaler MPX 8200/8400/8600/8800 Appliance to a NetScaler SDX 8400/8600 Appliance

Jan 07, 2014

To convert a NetScaler 8200/8400/8600/8800 appliance to a NetScaler SDX 8400/8800 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:
  1. VT100 terminal emulation
  2. 9600 baud
  3. 8 data bits
  4. 1 stop bit
  5. Parity and flow control set to NONE

To convert a NetScaler MPX 8200/8400/8600/8800 appliance to a NetScaler SDX 8400/8600 appliance:

  1. 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 RJ45 converter, insert the optional converter into the console port and attach the cable to it.

  2. On the NetScaler MPX appliance, verify that the solid state drive, power supplies, CPU, SSL cores, and interfaces are operational.
  3. Access the console port and enter the administrator credentials.
  4. Run the following command from the NetScaler command line interface to display the serial number and confirm the SYSID of the appliance: > show hardware
  5. Run the following command to display the status of the active interfaces: > show interface
  6. 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 have only a limited number of SFP+ transceivers, 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. The SFP+ transceivers are not hot-swappable. Therefore, 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.

  8. For any interface that you do not want to use after conversion, run the following commands:

    > disable interface 1/x

    > disable interface 10/x

  9. Run the following command to verify that the status of the power supplies is normal: > stat systemdetail
  10. Run the following command: > 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. It might be helpful if you want to contact a Citrix technical support engineer.
  11. At the NetScaler command line interface, switch to the shell prompt. Type: shell
  12. Run the following command to verify that 4 Cavium cores are available: root@ns# dmesg | grep cavium
  13. Run the following command to verify that 132 MB of RAM is reserved for shared memory: root@ns# dmesg | grep memory
  14. Run the following command to verify that the appliance has 4 CPU cores: root@ns# dmesg | grep cpu
  15. Run the following command to verify that the /var drive is mounted as /dev/ad4s1e: root@ns# df –h
  16. Enter the following command to run the ns_hw_err.bash script. This script checks for latent hardware errors. root@ns# /netscaler/ns_hw_err.bash
  17. At the shell prompt, switch to the NetScaler command line interface. Type: exit
  18. Run the following command to shut down the appliance: shutdown -p now
  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. The 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.
  21. Remove the currently installed SSD drive by pushing the safety latch of the drive cover to the right and removing the drive handle and the existing drive.
  22. Open the drive handle on the new drive completely to the left, and insert the drive into the slot. The following figure shows the drive partially inserted. Push the drive all the way into the slot.

  23. Close the handle flush with the rear side of the appliance so that the solid-state drive locks securely into the slot.
    Important: The orientation of the solid-state drive is important. Make sure that the Citrix product label is facing up when you insert the drive.
  24. Store the old SSD.
  25. Start the NetScaler appliance. It takes approximately 30 minutes for the conversion process to complete. The conversion process updates the BIOS, installs the XenServer hypervisor and the Service VM operating system, and copies the NetScaler VPX image to the solid state drive for instance provisioning. When the conversion begins, the LCD screen on the front panel indicates NSMPX-8200 Booting… or NSMPX-8200 10G Booting… depending on the model of the appliance. When the conversion is successful, the LCD indicates Citrix NSSDX-8200 or Citrix NSSDX-8200 10G, depending on the model of the appliance.
    Note: The serial number of the appliance remains the same.
  26. Keep the console cable attached during the conversion process. Allow the process to continue until the netscaler-sdx login: prompt appears.
  27. When the appliance finishes the conversion process, it no longer has the previously working configuration. Therefore, you can access the appliance through a Web browser only. Use the default IP address: Configure a computer on network and connect it directly to the management port 0/1 of the appliance by using a cross-over Ethernet cable, or access the NetScaler SDX appliance through a network hub by using a straight-through Ethernet cable. Use the default credentials. (Username: nsroot and Password: nsroot).
  28. Select the Configuration tab.
  29. Verify that the System Resource section displays 8 CPU cores, 4 SSL cores, and 32 GB of total memory for the NetScaler SDX appliance.
  30. Select System node and click the Network Configuration link on the System page to modify the IP address of the Service VM.
  31. In the Modify Network Configuration dialog box, specify the following details:
    1. Interface—The interface through which clients connect to the Management Service. Possible values: 0/1, 0/2. Default: 0/1.
    2. XenServer IP Address—The IP address of XenServer hypervisor.
    3. Management Service IP Address—The IP address of the Management Service.
    4. Netmask—The subnet mask for the subnet in which the SDX appliance is located.
    5. Gateway—The default gateway for the network.
    6. DNS Server*—The IP address of the DNS server.

    *An optional parameter

  32. Click OK.
  33. Connect the NetScaler SDX appliance to a switch to access it through the network. Browse to the Management Service IP address defined in step 31 and log on with the default credentials.
  34. For instructions for applying the licenses, see NetScaler SDX Licensing Overview.
  35. 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. If the green LED light of the power supply, located on the back of the appliance, blinks, the appliance is completely shut down.