## Installation

This topic describes how to install and run Arm Mobile Studio on Windows, macOS® and Linux.

### Before you begin

Download the installation package appropriate to your platform. Arm Mobile Studio is available for 64-bit Windows, Linux and macOS.

### Install on Windows

1. Arm Mobile Studio is provided as a zip archive. Right-click the file and select Extract All to unzip it.
2. Arm Mobile Studio requires a valid Arm license. The Starter Edition license (starter_edition.dat) is located inside the Arm Mobile Studio package at the top level. You will need to set up your environment to point to this license. These steps are for Windows 10:
3. In the About window, scroll down to the Related settings section and select System info.
4. In the System window, select Advanced system settings in the left navigation pane.
5. In the System Properties window, choose the Advanced tab, then click the Environment Variables button near the bottom of that tab.
6. Under system variables select New. Then add the following variables:

ARMLMD_LICENSE_FILE=<full\path\to\license>
ARM_TOOL_VARIANT=hv_m

Alternatively, set these variables on the command-line:
set ARMLMD_LICENSE_FILE=<full\path\to\license>
set ARM_TOOL_VARIANT=hv_m

Note: Setting environment variables on the command-line will only persist for the duration of your terminal session.

#### Launch Streamline and Graphics Analyzer on Windows

1. To launch Streamline, navigate to the location where you unzipped the package, go to the streamline folder and double-click the Streamline.exe file.
2. To launch Graphics Analyzer, navigate to the location where you unzipped the package, go to the graphics_analyzer/gui folder, and double-click the aga.exe file.

### Install on macOS

1. Arm Mobile Studio is provided as a gzipped tar archive. Double-click the tar archive to extract it to your preferred location.
2. Arm Mobile Studio requires a valid Arm license. The Starter Edition license (starter_edition.dat) is located inside the Arm Mobile Studio package at the top level. You will need to set up your environment to point to this license. In your macOS terminal:
1. Set the ARMLMD_LICENSE_FILE environment variable to point to the license file:
launchctl setenv ARMLMD_LICENSE_FILE <full/path/to/license>
2. Set the ARM_TOOL_VARIANT environment variable to specify the license type:
launchctl setenv ARM_TOOL_VARIANT hv_m

#### Launch Streamline and Graphics Analyzer on macOS

1. To launch Streamline, navigate to the location where you extracted the package, go to the streamline folder and double-click the Streamline.app file.
2. To launch Graphics Analyzer, navigate to the location where you extracted the package, go to the graphics_analyzer/gui and double-click the Graphics Analyzer.app file.

### Install on Linux

1. Arm Mobile Studio is provided as a gzipped tar archive. Extract this tar archive to your preferred location, using a recent version (1.13 or later) of GNU tar:
 tar xvzf <ARM_Mobile_Studio>.tgz
2. Arm Mobile Studio requires a valid Arm license. The Starter Edition license (starter_edition.dat) is located inside the Arm Mobile Studio package at the top level. You will need to set up your environment to point to this license. In your terminal:
1. Export the ARMLMD_LICENSE_FILE environment variable to point to the license file:
export ARMLMD_LICENSE_FILE=<full/path/to/license>
2. Export the ARM_TOOL_VARIANT environment variable to specify the license type:
export ARM_TOOL_VARIANT=hv_m

Tip: Add these export commands to your rc file (~/.profile ) to make these changes persist beyond your current terminal session. You will need to log out and in again to load any edits made to the .profile file.

#### Launch Streamline and Graphics Analyzer on Linux

1. To launch Streamline, navigate to the location where you extracted the package, go to the streamline folder and double-click the Streamline file.
2. To launch Graphics Analyzer, navigate to the location where you extracted the package, go to the graphics_analyzer/gui folder, and double-click the aga file.