Product Documentation

NetScaler MAS with Microsoft Hyper-V

To install NetScaler MAS on Microsoft Hyper-V, you must first download the NetScaler MAS image file to your local computer. Also, make sure that your system has the hardware virtualization extensions, and verify that the CPU virtualization extensions are available.

Prerequisites

Before installing the NetScaler MAS virtual appliance, verify that the following requirements have been met:

  • Microsoft Hyper-V version 6.2 or later is installed on hardware that meets the minimum requirements.

  • Install Microsoft Hyper-V Manager on a management workstation that meets the minimum system requirements.

  • You have downloaded the NetScaler MAS image file.

Microsoft Hyper-V requirements for NetScaler MAS

 The following table lists the virtual computing resources that Microsoft Hyper-V must provide for each NetScaler MAS virtual appliance.

Component Requirement
RAM 32 GB
  Note: The default value is 8 GB. Citrix recommends that you increase the default value to 32 GB for better performance.
Virtual CPU 8 CPUs
  Note: The default is 2 CPUs. Citrix recommends that you increase the default value to 8 CPUs for better performance.
Storage space Citrix recommends using solid-state drive (SSD) technology for NetScaler MAS deployments. The default value is 120 GB. Actual storage requirement will depend on NetScaler MAS sizing estimation. If your NetScaler MAS storage requirement exceeds 120 GB, you to have to attach an additional disk. Note that you can add only one additional disk. Citrix recommends you to estimate storage and attach additional disk at the time of initial deployment. For more information, see How to Attach an Additional Disk to NetScaler MAS.
Virtual Network Interfaces 1
Throughput 1 Gbps or 100 Mbps

Microsoft Hyper-V system requirements

Microsoft Hyper-V is a Windows client application. The following table describes the minimum system requirements.

Component Requirement
Operating System Windows Server 2012 R2
.NET framework Version 2.0 or later
CPU 750 megahertz (MHz), Recommended: 1 gigahertz (GHz) or faster
RAM 1 GB, Recommended: 2 GB
Network Interface Card 100 megabits per second (Mbps) or faster NIC

Installing NetScaler Management and Analytics System

The number of NetScaler MAS server that you can install depends on the memory available on the Hyper-V server.

To install NetScaler MAS:

  1. Start Hyper-V Manager client on your workstation.

  2. On the Action menu, click Import Virtual Machine.

    localized image

  3. Import the Hyper-V image, and do the following:
    1. In the Import Virtual Machine dialog box, in Locate Folder section, browse to the folder in which you saved the NetScaler MAS Hyper-V image, select the folder, and click Next.

    2. In the Select virtual machine section, select the appropriate virtual machine name.

    3. In the Choose Import Type section, select Copy the virtual machine (create a new unique ID) option and click Next.

    4. In the Choose Destination section, you can specify the folders to store the virtual machine files.

      Note

      By default the wizard imports the virtual machine files to default Hyper-V folders on your local host.

      localized image

    5. In the Choose Storage Folders section, you can select the location in which you want to store the virtual hard disks, and then click Next.

    6. You can verify the Virtual Machine details in the summary pane, click Finish.

      localized image

    The NetScaler MAS Hyper-V image appears in the right pane.

  4. Right-right the NetScaler MAS Hyper-V image, and then click Settings.

  5. In the left pane of the dialog box that appears, navigate to Hardware > VM_Bus Network Adaptor, and in the right pane, from the Network drop-down list, select the appropriate network.

    localized image

  6. Click Apply, and then click OK.

  7. Right-click the NetScaler MAS Hyper-V image and click Connect.

  8. On the Console window, click Start button.

  9. Configure the initial network configuration options, as shown in the figure below.

    localized image

  10. After specifying the required IP addresses,  save the configuration settings.

  11. When prompted, logon using nsrecover/nsroot credentials.

    localized image

  12. Execute the deployment script by typing the command at the shell prompt:

    deployment\_type.py
    

    localized image

  13. Select the deployment type as NetScaler MAS Server. If you do not select any option, by default, it is deployed as a server.

    localized image

    Note

    Currently, you cannot deploy connector nodes, database nodes, and/or NetScaler MAS agents because NetScaler MAS does not support Scale-Out deployment.

  14. Type Yes to deploy NetScaler MAS as a standalone deployment.

  15. Type Yes to restart the NetScaler MAS server.

    Note

    After you install NetScaler MAS, you can update the initial configuration settings at a later time.

To update the initial configuration in the NetScaler MAS, type networkconfig in the NetScaler MAS console. The console displays the NetScaler MAS initial network configuration options. You can then update the following parameters on the console:

  • Host name of NetScaler MAS

  • NetScaler MAS IPv4 address

  • Netmask

  • Gateway IPv4 address

  • DNS IPv4 address

Verification

After the server is installed, you can access the graphical user interface (GUI) by typing the IP address of the NetScaler MAS server in the address bar of your browser. The default administrator credentials to log on to the server are nsroot/nsroot.

The browser displays the NetScaler MAS configuration utility.