Nav

Download and Launch Anypoint Studio

Anypoint Studio is the graphical integration design environment of the Anypoint Plaform for applications that are deployed to Mule runtime.

For details on installing the Mule standalone runtime, the Mule Management Console, and Mule’s Community runtime, refer to the comprehensive installation instructions and to Setting Up Your Development Environment.

  • Before downloading and launching Anypoint Studio, install Java SE JDK 7 or Java SE JDK 8.

  • If you are using a Mac computer running OS X and if you are installing Anypoint Studio on a new computer or a fresh installation, you must also install JRE 1.6, which provides important libraries used by later JDK versions. Install JDK 6 first and then install JDK 7 or Java SE JDK 8.

    After installing JDK 7 or 8, you need to change the default Java virtual machine (JVM) from v6 to the later version.

    • Open a Terminal and enter this command as shown in the following example:


              
           
1
2
3
4
/usr/libexec/java_home -V
Matching Java Virtual Machines (2):
1.8.0_101, x86_64:        "Java SE 8"        /Library/Java/JavaVirtualMachines/jdk1.8.0_101.jdk/Contents/Home
1.6.0_65-b14-468, x86_64:        "Java SE 6"        /Library/Java/JavaVirtualMachines/1.6.0.jdk/Contents/Home
  • Enter a command such as this that sets the JDK 8 to the default JVM.

export JAVA_HOME=`/usr/libexec/java_home -v 1.8.0_101`

Download and Install

To download and install Anypoint Studio:

  1. Download Anypoint Studio that is compatible with your operating system: Windows, Mac, or Linux.

  2. Check to confirm that JDK 7 or JDK 8 is in place on your system. From the command line (Terminal app for a Mac, Command Prompt for Windows), run: java -version

    The response should appear similar to the following for JDK 7:

    
                
             
    1
    2
    3
    
    java version "1.7.0_75"
    Java(TM) SE Runtime Environment (build 1.7.0_75-b13)
    Java HotSpot(TM) 64-Bit Server VM (build 24.75-b04, mixed mode)

    If a Java runtime environment is not installed, install Java SE JDK 7.

    Mac Installation: In Anypoint Studio version 6 and newer you can no longer unzip the distribution zip file by double-clicking the zip file to extract the software. Before downloading Studio, you must set your Security & Privacy setting to Allow apps downloaded from to Anywhere. Until you allow apps to be downloaded from anywhere, Apple displays the message, "`AnypointStudio` is damaged and can’t be opened. You should move it to the Trash". (This message is incorrect—​it only means that Apple has an issue with apps not downloaded from Apple.)

    To set this:

    1. After downloading Anypoint Studio, unzip the software to create the AnypointStudio.app file. You can use any unzip program to unzip the software. Do not double-click the app program yet.

    2. Click the Apple icon in the upper right corner of your screen, and click System Preferences.

    3. Click Security & Privacy.

    4. Click the lock icon in the lower left of the Security & Privacy menu to unlock so you can change the settings.

    5. Click the General tab.

    6. Supply your Mac password.

    7. Change Allow apps downloaded from to Anywhere:

      mac security and privacy menu

    8. Now double-click AnypointStudio.app and click Open.

  3. Unzip the zip file.

    Windows: It’s important to extract Anypoint Studio into the 'C:\' root folder. Also, if you are using a Windows Anti-Virus application, ensure that the plugin/ and features/ directories are under the “trusted” category.

    OS X: If you’re using OS version Sierra, it’s important that you move your extracted app to the /applications folder before you launch it

  4. Open Anypoint Studio:

    1. Windows: Double-click the AnypointStudio.exe file, located in the AnypointStudio directory.

    2. Linux: Double-click the AnypointStudio file icon, located in the AnypointStudio directory.

      Studiofolderstructure

  5. If the wrong version of Java is present on your computer, the following may occur after you start Studio:

    1. Mac: The command triggers a prompt to install the JDK tools directly from Apple. Follow the instructions to download and install JDK 7 or JDK 8.  See: Running Studio on a Mac

    2. Windows: This message appears when you start Studio: Incompatible JVM - Version <number> of the JVM is not suitable for this product. Version 1.7 or greater is required. Go to Java SE JDK 7 or or Java SE JDK 8, download the JDK, and install it. Then restart AnypointStudio.exe from where you unzipped the software distribution.

  6. Click OK to accept the default workspace.

    workspacelauncher

  7. Anypoint Studio launches, then displays a Welcome page. Click Create a Project to begin development immediately.

Running Studio on a Mac

By default, Mac OS X restricts execution of non-Apple App Store applications. Because you download Anypoint Studio outside the App Store, your system may prevent you from running Studio applications and issue a warning message advising you to change your security settings to proceed.
(Note: you must have Administrator privileges to adjust the security settings.)

  1. On your Mac, open System Preferences, then navigate to Security & Privacy.

  2. In the General tab, under "Allow applications downloaded from:", select the radio button for Anywhere.

Depending on your security configuration, OSX might throw an error message with the description: Application is damaged and can’t be opened. You should move it to the trash.
Apple’s Gatekeeper displays this message because the application bundle is not digitally signed. It’s recommended for you to follow the steps described above to disable Gatekeeper and run Studio for the first time.
You can enable Gatekeeper again after the first successful launch of Studio.

If you’re using a Mac OS, there are two extra considerations when running Anypoint Studio.

Java Runtime Environment

Check to confirm that the Java runtime environment 7 or 8 is in place on your system. From the command line (Terminal app), run: java -version

The JDK 7 response should appear similar to:


         
      
1
2
3
java version "1.7.0_55"
Java(TM) SE Runtime Environment (build 1.7.0_55-b13)
Java HotSpot(TM) 64-Bit Server VM (build 24.55-b03, mixed mode)

The JDK 8 response is similar to:


         
      
1
2
3
java version "1.8.0_51"
Java(TM) SE Runtime Environment (build 1.8.0_51-b16)
Java HotSpot(TM) 64-Bit Server VM (build 25.51-b03, mixed mode)

If a Java runtime environment is not installed, the command triggers a prompt to install the JDK tools directly from Apple. Follow the instructions to download and install JDK 7 or 8.

Installing Enterprise Modules

If you are running Anypoint Studio with Mule Enterprise Edition (EE), you can add additional modules to your Studio instance.

Updating Studio

Anypoint Studio notifies you when an update is available.

You can also check this manually going to Help > Check for Updates.

Keep in mind that updating your Studio installation to the latest release using this method does not update the bundled Runtime version that’s announced in the release notes.

If you updated Studio from the update site and want to get the announced runtime version bundled with your version of Studio follow these steps:

  1. Go to Help > Install New Software …​.

  2. In the Work with drop down menu select Anypoint Studio Update Site.

  3. Expand the Anypoint Studio entry.

  4. Select the Mule Server Runtime {version} that appears listed.

  5. Follow the instructions on screen to complete the installation.

See Also