Last modified Jan, 26, 2017
Install ScaleArc on Hyper-V

Prerequisites

Make sure you have the following prerequisites to successfully deploy ScaleArc in a Windows Hyper-V environment: 

  • A download of the ScaleArc GA software release in ISO format 
  • A Windows 2012 Hyper-V environment containing one or more servers, with 16GB of RAM and 8 virtual CPUs available 
  • Local or shared storage with at least 1TB of available space

Create a virtual machine 

Use the Hyper-V Manager to create a new virtual machine:

  1. Right click on the physical server in the left panel where you want to create your virtual machine. From the right-click menu select New and then Virtual Machine.



  2. The New Virtual Machine Wizard appears. Click on Next to continue.

     
     
  3. Choose a name for the virtual machine and the location to store your virtual machine configuration files. Then, click Next.



  4. Choose the generation of this virtual machine and click on Next. 



  5. Configure the amount of memory you wish to allocate for your virtual machine. The recommended minimum memory is 16GB. Click Next to continue. 



  6. Choose the virtual network adaptor you wish to configure for this virtual machine. Select the appropriate connection for virtual switch and click Next

     
     
  7. Create a Virtual Hard Disk. This disk gets discarded later so choose the default size. Click Next


     
  8. Browse for the installation media for your Virtual Machine OS, and click Next. 



  9. Review the settings for the new virtual machine. Click on Finish to create the virtual machine and close the wizard.


Configure the virtual machine

You need to configure the VM to meet the minimum ScaleArc system requirements.  

  1. Right-click on the newly-created VM from the Hyper-V Manager and click on Settings.


      
  2. Click on Processor under Hardware to change the number of virtual processors to eight. Click Apply. 

    ScaleArc needs a minimum of eight virtual processors or else a kernel panic occurs and blocks the ScaleArc startup.  As a rule of thumb, the total CPUs allocated should be at least two larger than the ScaleArc license that is being installed on the system. Refer here for ScaleArc sizing details.



  3. Choose your main Hard Drive in the left panel. It will be on IDE Controller 0 if you chose Generation 1 or on the SCSI controller, if you chose Generation 2. In the right panel, click Remove under the Virtual Hard Disk in the Media section. In the right panel, click Remove under the Virtual Hard Disk in the Media section. When the old Hard Drive is removed (crossed out), click Apply.



  4. Check if the left panel selection highlight has reverted to the Controller for the hard disk you just removed. If not, select that controller in the left panel. In the IDE Controller section in the right panel, select Hard Drive. Click Add.



  5. Ensure the new hard disk you added In the left panel is selected. Locate the Hard Drive section in the right panel and click New. 

     
     
  6. Click Next (if necessary) to get to the Choose Disk Format screen. Ensure that VHDX is selected in the right panel. Click Next.

     
     
  7. Select Fixed size in the right panel and click Next.



  8. Enter a filename for your virtual hard disk's file. Click Next.


     

  9. Choose a size for your system drive. ScaleArc recommends 100GB for system disks. Click Next.



  10. Finally, verify your settings, and click Finish to create the hard disk. 



  11. Repeat the above steps 4-10 to create a second disk for your log files, this time setting the size that is appropriate for a log file disk. The recommended size of the ScaleArc logging disk varies, depending on the size of the ScaleArc appliance being deployed. Once you have specified the size of the new hard disk and clicked FInish, click to Apply. Then, click OK.  

Install ScaleArc on Hyper-V

  1. In Hyper-V Manager, right click on the virtual machine and click on Connect to power on the virtual machine and start the installation.

     
     
  2. Select the Install ScaleArc option on the Welcome to ScaleArc Installer screen.  Hit Enter. 


Log in to ScaleArc

If you have successfully installed ScaleArc, on restart the screen displays a login prompt. This is the first time you are logging in to the ScaleArc system. 

  1. Log in using the following credentials:

    Username:  admin   

    Password :  admin@123 

     
  2. Select option 1 to set the IP address, subnet, and gateway of the ScaleArc system.  Enter 1 to apply the settings. 

     
     
  3. Enter 1 to apply the settings. 

     
     
  4. Once the network is set, use the same IP address in your browser to see the ScaleArc user interfaceIf you have any trouble accessing the ScaleArc user interface make sure you have secured the network cabling and the switch/router configuration is in place. 
  5. By default, ScaleArc uses a self-signed certificate for communication via HTTPS. Since it is self-signed, the screen displays an untrusted certificate alert while accessing ScaleArc. 




  6. Proceed to the ScaleArc License Agreement screen. Read through the license and click Accept EULA.



  7. A successful network setup brings up the Welcome screen.



  8. Follow these steps to add MAC address anonymity. We recommend these steps for all ScaleArc virtual machines to ensure that when they are brought up, their MAC address does not change: 

    1. SSH to the ScaleArc console. (Refer to https://support.scalearc.com/kb/articles/2201 for details.)
    2. Run the following command, using a vi editor:

      sudo vi /etc/sysconfig/network-scripts/ifcfg-eth0


      1. Delete the following lines entirely from the file:
        1. NM_CONTROLLED
        2. HWADDR
        3. UUID
        4. TYPE 
      2. Make sure your file contains only these settings:

        Device="eth0"
        BOOTPROTO=static
        IPADDR=<your ipaddr>
        NETMASK=<your netmask>
        ONBOOT=yes
    3. Save and quit by first entering a colon (:), then wq, so :wq
    4.  Run the following command:

      rm /etc/udev/rules.d/70-persistent-net.rules

      Repeat step 8 as necessary for additional interfaces. Use the ifconfig command from the command line to identify them. Note that you need to remove the 70-persistent-net.rules file only once. 

    5. Restart the VM.

       

  9. You are ready to initialize ScaleArc.  

Migrating ScaleArc appliances

ScaleArc does not recommend or support voluntary or automatic Live Migration of an active (that is, HA Primary or standalone ScaleArc) appliance from one Hyper-V server to another. Testing shows that the migration process results in lost database updates, application server errors, and potentially-corrupted database records. Live Migration is not fast enough to support real-time operations that ScaleArc counts on.

ScaleArc supports cold migration. First, the ScaleArc appliance should be shut down before you begin the migration. Next, you need to configure static MAC addresses and ScaleArc's virtual NICs in a Static IP Pool. Additionally, virtual switches must be configured to both accept and propagate ARP updates or the appliance may not be accessible from the network, following migration. Note that this configuration is not available in Hyper-V Manager; it can only be completed through Microsoft System Center's Virtual Machine Manager, SCVMM. For details on configuring both the network interfaces and the virtual switches, see KB article 4066 on ScaleArc's Customer Support web site. 

Linux-based operating systems such as ScaleArc's base OS use udev rules to associate logical device names for network interfaces (that is, eth0) with physical device names or UUIDs (which translate to MAC addresses). During the migration of a virtual machine from one Hyper-V server to another, the new Hyper-V server, when it is configured by default, changes the MAC address of the Ethernet interface to a new randomly-generated address. This prompts the Linux operating system to ignore the network interface, which fails to restart along with the virtual machine following a migration, resulting in the ScaleArc appliance becoming incapable of communicating on the network. You can avoid this problem by assigning a static MAC address to the network interface. 

If you have configured ScaleArc for HA, the HA Secondary may be Live Migrated, provided you have configured Static MAC and Static IP and the virtual switches accept and propagate routing/forwarding ARP updates.To move both members of an HA pair, move the HA Secondary, perform a manual HA switchover, then move the newly-demoted HA Secondary.

For best survivability in the event of system or network failures, ScaleArc recommends you separate the two appliances of an HA pair onto two Hyper-V servers. In case of a failure, rather than attempting to move the HA Primary off of a failing Hyper-V server, perform an HA switchover from the GUI of the HA Secondary, then attempt to shut down the newly demoted HA Secondary on the failing Hyper-V server. Before bringing up the appliance that was running on the failed Hyper-V server, contact ScaleArc Support for assistance to avoid problems. In an emergency, the HA Secondary detects failure of the HA Primary and takes over the traffic.This happens much faster than a Live Migration.

Should you encounter an emergency on a Hyper-V server running a standalone ScaleArc you have little choice but to attempt a Live Migration. In this case, contact ScaleArc Support to assist you in recovery immediately. Make sure you immediately collect a log dump using the instructions in KB article 2736; use the --date syntax, with no hour specified. The logs should be collected within an hour of the problem to ensure the best assistance by avoiding log rollover; so don't delay. Contact us on our 24x7 toll-free support hotline, listed at support.scalearc.com.

 



On this page

 

Comments

  1. CSS
    2017-02-15 04:56

    In the ISO installation chapter, point 11.

    Specify the virtual disk size and provisioning policy and click on Next. In a production environment ScaleArc recommends creating 2 virtual disks; one for the OS and the other for ScaleArc logs. The minimum recommended storage is 100GB for the OS disk and 2 TB for the disk containing logs.

    The wording will have to be changed, due to the known bug IDB-16636, which will not be fixed in 3.11GA (as per latest info).

    ScaleArc is not able to install with 2 virtual disks attached. It has to start with only 1, the OS, then the second disk will have to be attached later, after the ScaleArc is installed. Otherwise the installation fails.

    Dobroslav

    Reply
  2. CSS
    2017-02-16 01:03

    Note to be added in the Log in to ScaleArc section, prior to #1:

    Please note that at this stage, ScaleArc cannot be accessed except through the virtual machine console, since its IP address has not yet been configured.

    See IDB-15903; this is an interim solution until PM-159 can be fixed, at which point instructions for the Log in to ScaleArc task will need to be revisited to ensure that the new menus are explained. I will update IDB-15903 as well.

    Reply
  3. Add new comment