Product Documentation

Configuring NetScaler VPX in the Azure Service Management

Mar 21, 2016

Provisioning a NetScaler VPX instance in the Azure cloud involves obtaining the NetScaler VPX image either from the Azure marketplace or from the Citrix download page, creating the virtual machine instance in Azure, and defining endpoints.

You can create a NetScaler VPX instance in Azure either by using the new Azure Preview portal or by using the classic Azure Management portal.

Before You Begin

Make sure that you have the following:
  • A Microsoft Azure user account
  • Access to Microsoft Azure Preview Management portal
  • Access to the Microsoft Azure Classic Management portal
  • Microsoft Azure SDK
  • Microsoft Azure PowerShell

Before you begin creating the NetScaler VPX instance, make sure that you have created a virtual network with required subnets in which the VPX will reside. You can create virtual networks during VM provisioning but you will not have the flexibility to set different subnets. For information about creating virtual networks, see http://azure.microsoft.com/en-us/documentation/articles/create-virtual-network/

Optionally, configure DNS server and VPN connectivity that allows a virtual machine to access Internet resources.

Creating a NetScaler VPX Instance on Microsoft Azure by Using the Azure Preview Portal

Obtain the NetScaler VPX image from the Azure MarketPlace, and then use the Azure MarketPlace Preview portal to create a NetScaler VPX instance.

To create a NetScaler VPX instance on Microsoft Azure by using the Azure Marketplace Preview Portal
  1. On the Microsoft Azure Portal page (https://portal.azure.com), click Marketplace.
  2. On the Marketplace page, click Virtual Machine and select Citrix NetScaler VPX Bring Your Own.
  3. On the NetScaler VPX Bring Your Own License page, click Create.
  4. On the Create VM page:
    1. Specify values for Host Name and User Name.
    2. Under Authentication Type, select SSH Public Key or Password.
    3. Click Pricing Tier and select the instance type you want to use.
    4. In Optional Configuration, do the following:
      1. Configure Availability Set as required.
      2. Click Virtual Network and select the virtual network you have created.
        Note: It is recommended that you create network settings before you begin provisioning the VM so that the network information is available during provisioning. If you create a virtual network during VM provisioning, you will not be able to set different subnets.
      3. Click Subnet to select the specific subnet.
      4. Click Domain Name to select an existing cloud service or to create a new one.
      5. In IP Addresses, specify a static IP address.
        Note: If you expect that you might have to shut down and temporarily de-allocate the NetScaler VPX virtual machine at any time, assign a static Internal IP address. If you do not assign a static internal IP address, Azure might assign the virtual machine a different IP address each time it restarts, and the virtual machine might become inaccessible.
      6. Click OK for each option to make sure each configured setting is saved.
      7. Click Endpoints and add the public and private endpoints you want to use. Note that SSH endpoint is automatically set by Azure with a random public port and a private port as 22. Therefore, provisioning will fail if you add SSH. Click OK to save the endpoints.
      8. Click Create.
      9. Review the offer details and legal terms on the Create VM page and click Create.
      10. On the Portal page you can view the progress of the NetScaler VPX virtual machine provisioning.

        After the virtual machine is provisioned, a “deployment ID” is generated for use as the password to log on to the NetScaler virtual machine the first time. To view this deployment ID, double-click the virtual machine instance.

        Notes:
        • The default username to log on to the NetScaler virtual machine is nsroot. However, the default password is set to the “deployment ID” that is generated after the virtual machine is provisioned. You can change the password after you log on to the instance.
        • The password for the user that is created during the virtual machine provisioning remains the same as the one you had provided. Make sure that you do not provide nsroot as this user ID.

Creating a NetScaler VPX Instance on Microsoft Azure by Using the Classic Azure Management Portal

Obtain the NetScaler VPX image from the Citrix download page and upload it to Azure. Then, use the classic Azure management portal to create a NetScaler VPX instance.

To create a NetScaler VPX instance on Microsoft Azure by using the classic Azure management portal

  1. On the Virtual Machines page, click New.
  2. Navigate to Compute > Virtual Machine > From Gallery > My Images, select the VPX image that you have uploaded, and click the arrow at the right bottom corner.
  3. On the Virtual machine configuration page, specify values for the required fields.
  4. On the next screen, create a new cloud service. You can either configure the endpoints here, or at a later stage after the virtual machine is provisioned.
  5. On the next screen, be sure to clear the The VM agent that supports extensions is already installed checkbox. The agent brings up the NetScaler virtual machine with the specified parameters by exchanging heartbeats and status with the Azure Fabric Controller.
For instructions on how to create a NetScaler VPX instance on Azure by using the Azure PowerShell, see Provisioning NetScaler VPX with Single NIC by Using Azure PowerShell.
 
After the virtual machine is provisioned, a "deployment ID" is generated for use as the password to log on to the NetScaler virtual machine the first time. To view this deployment ID, double-click the virtual machine instance.

Note

If you expect that you might have to shut down and temporarily deallocate the NetScaler VPX virtual machine at any time, assign a static Internal IP address while creating the virtual machine. If you do not assign a static internal IP address, Azure might assign the virtual machine a different IP address each time it restarts, and the virtual machine might become inaccessible. You can assign static internal IP address only when you provision the virtual machine through Azure PowerShell. For information about creating a virtual machine with a static internal IP address, see Provisioning NetScaler VPX on Azure with a Static IIP by Using Azure PowerShell.

Accessing the NetScaler VPX Virtual Machine

You can access the NetScaler instance either through its graphical user interface (GUI) or through the command line interface (CLI). You can use either the cloud service IP address or the PIP to access the NetScaler virtual machine instance.

To log on to the virtual machine, use either of the following credentials:
  • The username and password specified while creating the virtual machine.
  • nsroot as the username and the “deployment ID” that was generated by Azure during virtual machine provisioning.

You can change the password after you log on to the instance.

To access the NetScaler instance through the GUI
In a browser’s address field, type the cloud service public IP address provided by Azure during virtual machine provisioning, or type the PIP address.
Note: Make sure you have created an endpoint to allow access to the private port 80 or 443 when accessing the GUI by using the cloud service IP.
To access the NetScaler instance through the CLI

Use any command line access tool (for example, Putty). Specify either the cloud service public IP address provided by Azure during NetScaler VPX provisioning, or specify the PIP address. Use SSH protocol with port 22.

Note: Make sure that you have created an endpoint to allow access to the private port 22 when accessing the CLI by using the cloud service IP.

For information about getting started with a NetScaler appliance, see http://support.citrix.com/proddocs/topic/netscaler-10-5/ns-gen-getting-started-wrapper-10-con.html