intel® Hardware Accelerated Execution Manager Installation Guide-microsoft windows *

Introduced

This article will guide you through the installation of intel® hardware accelerated Execution Manager (intel® ®HAXM), a hardware-assisted virtualization engine (hypervisor) that can speed up android* development with intel® Virtualization Technology (VT).

Pre-conditions

Intel HAXM requires that the android* SDK (version 17 or higher) be installed first. For more information, please visit the android* Developer website (http://developer.android.com/sdk/).

System Requirements

Hardware requirements:

• intel® processors that support Vt-x, EM64T, and Virus Protection (XD) features
• At least 1 GB of available RAM

Supported Operating systems:

• Microsoft Windows * 8 (32/64-bit)
• Microsoft Windows * 7 (32/64-bit)
• Microsoft Windows vista* (32/64-bit)
• Microsoft Windows * XP SP2 (32-bit only)

Important: Intel HAXM is not available on systems that do not use Intel processors or that use Intel processors that are missing the hardware features described in the "Hardware Requirements" section above.
To determine what features your Intel processor has, please visit the http://ark.intel.com/zh-cn/
。 In addition, Intel HAXM must be used with the android* x86 emulator image provided by Intel.
Intel HAXM cannot be used with arm* android* emulator images or non-Intel x86 android* emulator images.

Download intel® ®HAXM

Review
When installing Intel HAXM, you can choose either through the Android* SDK Manager (recommended) or manually (that is, manually download the installer from Intel's website).
Note: intel® HAXM is not yet automatically checked for updates. To get the latest version, use the android* SDK Manager (recommended) or download the Intel HAXM package from the intel® Developer Zone android* Developer website.

Manual download

1. Please go to http://software.intel.com/en-us/android.
2. Select the intel® HAXM installer package for your platform.
3. Unzip the installer and use the installation instructions that are appropriate for your platform.

Download via android* SDK Manager

1. Start the android* SDK Manager.
2. Under Extras, select the check box next to "Intel x86 Emulator Accelerator (HAXM)"

3. Click "Install Package ..."     Button. 4. Review the Intel Corporation license agreement.     If you accept the terms, select "Accept" and click "Install". 5. The SDK Manager downloads the installer to the "extras" directory in the SDK home directory. The SDK manager may prompt for "installed", but the true meaning of the hint is to download the Intel HAXM executable file.     You will still need to run Setup from the "Extras" directory to ensure that the installation is completed successfully. 6. Unzip the installer in the "Extras" directory and use the installation instructions that are appropriate for your platform. Installing the intel® ®HAXM on Windows *

Warning: Intel HAXM will not install if your system does not meet system requirements, including support for Intel processor features such as Intel Virtualization Technology (VT).

1. Download the installer package from http://software.intel.com/en-us/android or by using the SDK Manager.
2. Run the Setup program (and accept the UAC prompt if applicable).
   1. If you have an older version of intel® HAXM installed, you will see a dialog box notification:
      
      

      Click "Yes" to upgrade the intel® HAXM, or click "No" to leave the installation page to keep Intel HAXM as the currently installed version.

   2. You will see a welcome screen:
      
      

      Note: You can access the documentation at any time by clicking on the Intel HAXM documentation

3. Click "Next"
4. You will be prompted to adjust the amount of RAM allocated to Intel HAXM:
   
   

   Note: This installer can also be used as a configuration tool for intel® HAXM. To change the settings for your memory, run the installer again.

5. The next screen will confirm your Intel HAXM memory allocation settings:
   
   
6. After the Intel HAXM installation is complete, please click "Finish" to leave the installer.
   Intel® HAXM is now installed and ready to use.

To find out if Intel HAXM is running, open a command Prompt window and execute the following command:sc query intelhaxm

If Intel HAXM is running, the command displays a status message indicating that the status is: "4 RUNNING".
To stop or start intel® HAXM, use the following command:
Stop it:

sc stop intelhaxm

Begin:

sc start intelhaxm

Tuning intel® ®HAXM Memory allocation

To change the amount of memory allocated to Intel HAXM, run the Setup program again.

Remove intel® HAXM

Warning: Please close all android* x86 emulator instances before removing Intel HAXM. The HAXM in use cannot be removed.

To uninstall Intel HAXM, run the installer again or use the Control Panel.

Important: The acceleration features of all intel® ®x86 android* emulators will be disabled after removing Intel HAXM. The existing android* virtual appliance will continue to work, but it cannot get accelerated.

android* emulator acceleration will be re-enabled after reinstalling Intel HAXM.

Trouble shooting

Intel HAXM requires the use of an android* x86 system image provided by Intel. These images can be downloaded through the Android* SDK Manager or manually from the intel® Developer Zone website.

Intel virus Protection (XD) feature error

When installing Intel HAXM, you may encounter an error about Intel XD support.
This error message may be caused by the following conditions:

• Intel XD is not supported by computer processors.
• Intel XD is not enabled.

Intel XD is not supported

Intel HAXM requires an Intel processor with virus protection (XD) capability and therefore cannot be used on a system that lacks this hardware feature. To determine what features are available on your Intel processor, please visit http://ark.intel.com/zh-cn/.

Intel XD is not enabled

In some cases, the Intel XD disable may occur in the system BIOS, so it must be enabled in the BIOS setup program. To access the BIOS Setup program, you must hold down a setting key while your computer is booting. Which setting key to use depends on the BIOS you are using, in general, the setting key is one of the F2, Delete, or ESC keys. Intel XD may be identified as "XD", "Execute Disable", "No Execute", or "Hardware DEP" in the BIOS setup program, depending on which BIOS is used.

In addition to Intel XD, the Windows * Host may also need to support DEP (Data Execution Protection), for more information please refer to this article microsoft* KB: http://support.microsoft.com/kb/875352.

For specific information about how to enter BIOS settings and enable Intel XD, contact your hardware manufacturer.

Intel Virtualization Technology (VT-X) features

When installing intel® HAXM, you may encounter an error about vt-x support.
This error message may be caused by the following conditions:

• Intel Vt-x is not supported by computer processors
• Intel Vt-x is not enabled

Intel Vt-x is not supported

Intel HAXM requires an Intel processor with vt-x capability and cannot be used on a system that lacks this hardware feature. To determine what features are available on your Intel processor, please visit http://ark.intel.com/zh-cn/.

Intel Vt-x is not enabled

In some cases, the disabling of Intel Vt-x may occur in the system BIOS, so it must be enabled in the BIOS setup program. To access the BIOS Setup program, you must hold down a key while your computer is booting. Which setting key to use depends on the BIOS you are using, in general, the setting key is one of the F2, Delete, or ESC keys. In the BIOS Setup program, Intel VT may be identified as "VT", "Virtualization Technology", or "vt-d". Ensure that all virtualization features are enabled.

Contact your hardware manufacturer for specific information on how to enter the BIOS setup and enable Intel VT.

Tips and Tricks

Here are some suggestions to help you get the best experience from the android* simulator by using the intel® HAXM driver.

• Enable GPU acceleration for your image in the AVD manager. The HAXM driver can perform most CPU instructions locally through Intel Virtualization technology in the processor, and GPU acceleration unloads the opengl* call to the host GPU.
• Launch the emulator from the command line for more detailed output.
  • Use the following command to start the emulator:
    emulator-x86 –avd <avd name> -partition-size 1024 –gpu on -verbose
  • A partition size of 1024 allows you to install a 1 GB app. This differs from the size of the SD card in the AVD manager, which specifies the storage capacity that is dedicated to the media file within the emulator. The GPU is set to "on" to provide better graphics performance.
• Ensure that the "Path" environment variable for the GPU emulation library is set through the Control Panel > System > Advanced System Settings > Environment Variables, or each time Start a new command prompt by manually setting it. If you are using multiple SDK installations, we recommend that you set them up manually. The following <sdk install location> usually refers to "C:\users\<your USERNAME>\ANDROID-SDK"
  set PATH=%PATH%;<sdk install location>\tools\lib
• When installing intel® HAXM, set the driver to ensure that only half the capacity of the available RAM in the system is used. For example, if your system has 6 GB of installed memory, use 3 GB for the intel® HAXM driver. This helps to balance memory well between the HAXM driver and the system memory.
• It is recommended that you set the device RAM size to less than 1024MB when you create the image.
• Sometimes, when you start an image for the first time, the image is displayed hanging on the splash screen. The startup process is complete, but the home screen is still not displayed. Click on the "Home" button on the simulator to display the home screen.
• If you find performance issues on Windows 8, we recommend that you disable Hyper-V.
• For more command-line options for starting the emulator, refer to the android* developer website.

Change Log

• The Linux kernel has been updated to 3.4 in the emulator
• Resolves performance issues with running HAXM from within a Windows virtual machine on a VMware workstation
• Debugging support is added to Windows by creating a C:\HaxLogs.log file so that the emulator can be terminated in a normal manner without causing a BSOD
• Improved stability

intel® Hardware Accelerated Execution Manager Installation Guide-microsoft windows *