Product Documentation

Installing NetScaler MAS on Microsoft Hyper-V

Sep 04, 2017

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.


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


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

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 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


750 megahertz (MHz), Recommended: 1 gigahertz (GHz) or faster


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:
          a. 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.
          b. In the Select virtual machine section, select the appropriate virtual machine name.
          c. In the Choose Import Type section, select Copy the virtual machine (create a new unique ID) option and click Next.
          d. In the Choose Destination section, you can specify the folders to store the virtual machine files.


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

localized image

               e. 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.

                f. 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, select the deployment type as NetScaler MAS server. If you do not  select any option, by default, it will be deployed as a server.

localized image

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

12. Type Yes to restart the NetScaler MAS server.


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 


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.