Installation Instructions for Intel® Hardware Accelerated Execution Manager - Mac OS X*

Last Updated April 15, 2014

Introduction

This document will guide you through installing the Intel® Hardware Accelerated Execution Manager (Intel® HAXM), a hardware-assisted virtualization engine (hypervisor) that uses Intel® Virtualization Technology (VT) to speed up Android* development.

Prerequisites

Intel HAXM requires the Android* SDK to be installed (version 17 or higher). For more information, refer to the Android* developer website (http://developer.android.com/sdk/).

System Requirements

Hardware Requirements:

  • Intel® processor with support for Intel® VT-x, Intel® EM64T (Intel® 64), and Execute Disable (XD) Bit functionality
  • At least 1 GB of available RAM

Supported Operating Systems:

  • Mac OS X* 10.6 (32/64-bit) or 10.7 (32/64-bit) or 10.8 (64-bit) or 10.9 (64-bit)

Important: Intel HAXM cannot be used on systems without an Intel processor, or with an Intel processor that lacks the hardware features described in the "Hardware Requirements" section above.To determine the capabilities of your Intel processor, visit http://ark.intel.com/
Additionally, Intel HAXM can be used only with Android* x86 emulator images provided by Intel.
Intel HAXM cannot be used with ARM* Android* emulator images or non-Intel x86 Android* emulator images
.

Downloading Intel® HAXM

Overview
Intel HAXM can be installed either through the Android* SDK Manager (recommended), or manually, by downloading the installer from Intel's website.

Note: Intel HAXM does not currently check for updates automatically. To get the latest version, download the Intel HAXM package using the Android* SDK Manager (recommended) or from the Intel® Developer Zone Android* developer site.

Downloading Manually

  1. Go to http://software.intel.com/en-us/android.
  2. Choose the Intel HAXM installer package for your platform.
  3. Extract the installer and follow installation instructions for your platform.

Downloading through Android* SDK Manager

  1. Start the Android* SDK Manager.
  2. Under Extras, check the box next to Intel x86 Emulator Accelerator (HAXM).
  3. Click the "Install package…" button. 
  4. Review the Intel Corporation license agreement. If you accept the terms, select Accept and click Install.
  5. The SDK Manager will download the installer to the "tools" directory, under the main SDK directory.
  6. Extract the installer inside the "tools" directory and follow the installation instructions for your platform.

Installing Intel® HAXM on Mac OS X*

Warning: Intel® Hardware Accelerated Execution Manager (Intel® HAXM) installation will fail if your system does not meet the system requirements, including support for Intel® processor features, such as Intel® Virtualization Technology (Intel® VT).

  1. Download the installer package from http://software.intel.com/en-us/android or using the SDK Manager.
  2. Open the DMG file, then run the installer contained inside.
  3. If an older version Intel HAXM is already installed, you will see a notification dialog:

    Click "OK" to dismiss the dialog. Then you can either exit the installer, to keep your current version of Intel HAXM, or continue with installation and upgrade Intel HAXM.

  4. You will see a welcome screen:

  5. Click "Continue"
  6. You will be prompted to adjust the amount of RAM that will be allocated to Intel HAXM.

    Note: The installer also functions as a configuration tool for Intel HAXM. To change memory settings, run the installer again.

  7. The next screen confirms your Intel HAXM memory allocation settings:

  8. Select the drive where Intel HAXM will be installed, then click Continue.
  9. Once Intel HAXM is installed, click Close to exit the installer.

Intel HAXM is now installed and ready to use.

To verify that Intel HAXM is running, open a terminal window and execute the following command:

kextstat | grep intel

If Intel HAXM is operating correctly, the command will show a status message indicating that the kernel extension named "com.intel.kext.intelhaxm" is loaded.

To stop or start Intel HAXM, use the following commands:

Stop:

sudo kextunload –b com.intel.kext.intelhaxm

Start:

sudo kextload –b com.intel.kext.intelhaxm

Adjusting Intel® HAXM Memory Allocation

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

Removing Intel® HAXM

Warning: Close all instances of the Android* x86 emulator before removing Intel HAXM. Intel HAXM cannot be removed while in use.

To uninstall Intel HAXM, open a terminal window and execute this command:

sudo /System/Library/Extensions/intelhaxm.kext/Contents/Resources/uninstall.sh

You will be prompted for your current user password. Follow the uninstaller prompts to remove Intel HAXM.

Important: Removing Intel HAXM will disable acceleration of all Intel® x86 Android* emulators. Existing Android* Virtual Devices will continue to function, but will no longer be accelerated.

Installing Intel HAXM again will re-enable Android* emulator acceleration.

Using Intel® HAXM

Intel HAXM requires 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 x86 Android* emulator images will automatically be executed using the "emulator-x86" binary, provided with the Android* SDK. If Intel HAXM is installed and working, emulation will be accelerated by Intel HAXM (using Intel Virtualization Technology).

Troubleshooting

Intel HAXM requires 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 Execute Disable (XD) Bit capability error
When installing Intel HAXM, you may encounter an error regarding Intel XD support.
This error message can be triggered by the following conditions:

  • Intel XD is not supported by your computer’s processor
  • Intel XD is not enabled

Intel XD is not supported
Intel HAXM requires an Intel processor with Execute Disable (XD) Bit functionality and cannot be used on systems lacking this hardware feature. To determine the capabilities of your Intel processor, visit http://ark.intel.com/.

Intel XD is not enabled
Note: Apple* computers have Intel XD permanently enabled if supported by the processor.
If you receive an error message indicating that Intel XD is not enabled, your computer does not meet the minimum system requirements to use Intel HAXM. To determine the capabilities of your Intel processor, visit http://ark.intel.com/.

Intel® Virtualization Technology (VT-x) capability

When installing Intel HAXM, you may encounter an error regarding Intel VT-x support.

This error message can be triggered by the following conditions:

Intel VT-x is not supported by your computer’s processor

  • Intel VT-x is not enabled

Intel VT-x is not supported
Intel HAXM requires an Intel processor with Intel VT-x functionality and cannot be used on systems lacking this hardware feature. To determine the capabilities of your Intel® processor, visit http://ark.intel.com/.

Intel VT-x not enabled
Note: Apple* computers have Intel VT-x permanently enabled if supported by the processor.
If you receive an error message indicating that Intel VT is not enabled, your computer does not meet the minimum system requirements to use Intel HAXM. To determine the capabilities of your Intel processor, visit http://ark.intel.com/.

Tips and Tricks

Below are some recommendations to get the best experience out of the Android* emulator using the Intel HAXM driver.

  • Enable the GPU acceleration in the AVD Manager for your image. The Intel HAXM driver executes most CPU instructions natively through Intel Virtualization Technology in the processor and the GPU acceleration offloads the OpenGL* calls to the host GPU.
  • Use the following command in the terminal to launch the emulator:

    ./emulator-x86 –avd <avd name> -partition-size 1024 –gpu on
     
    • A partition-size of 1024 allows 1 GB of apps to be installed. This is different from the SDCard size option in the AVD manager, which specifies how much storage for storing Media files is allotted inside of the emulator. Setting the GPU to on will provide better graphics performance.
    • Make sure that your environment variables for the GL libraries are set correctly. Set the LD_LIBRARY_PATH by using the following command in the terminal. Modify the command to point to where your SDK installation is. 

      export LD_LIBRARY_PATH=<sdk install location>/tools/lib

      To automatically run this command whenever a new terminal is started, you can add this command to your ~/.bash_profile script.
  • When installing Intel HAXM, set the driver to use half of the available RAM in the system. For example, if your system has 6 gigs of installed memory then use 3 gigs for the Intel HAXM driver. This allows a good balance of memory for the Intel HAXM driver as compared to the system memory.
  • When creating the image don’t set the "Device ram size" larger than the amount of RAM allocated to the Intel HAXM driver. In the example above the Device ram size should not be larger than 3 gigs since only 3 gigs were allocated to Intel HAXM.
  • Sometimes, when booting an image for the first time, it will appear to be hung at the boot screen. The boot process is completed but the home screen is not being shown. Click on the home button on the emulator to show the home screen.
  • More command line options for booting the emulator are located at the Android* developer website.

Changelog

  • This version merges the hotfix 1.0.7 and was validated on all supported platforms, including Mac OS X* Mavericks (10.9) and Windows* 8.1.
  • Fixed several installer issues