Contact Us 1-800-596-4880

Installing Mule ESB 3 and the Mule IDE

Installing Mule Enterprise

These instructions are for Mule Enterprise only. For the community or snapshot releases, skip to the next section.

This section describes installation of Mule Enterprise. Follow the instructions for the version of the file you downloaded.

Installing the TAR.GZ

  1. If you downloaded the TAR.GZ version of Mule Enterprise, simply decompress the files into a directory. You must use a decompression utility like WinZip, not just the built-in Windows extractor.

    Do not install Mule in a directory path that contains spaces!
  2. Do one of the following:

    • If you will use the Mule IDE, see http://mulesoft.com.

    • If you will use Maven, skip ahead to set up your Maven repository.

    • Otherwise, skip ahead to the section on Running Mule.

Installing the JAR

  1. If you downloaded the JAR version of Mule Enterprise onto Windows, double-click the file to launch the installer. If you do not have Java associated with JAR files by default, open a command prompt, navigate to the directory where you downloaded the JAR file, and then enter the following command:

    java -jar mule-enterprise-standalone-installer-<version>.jar

    where <version> is the version number in the file name.

  2. Follow the instructions in the installer to install Mule. You will also be given options for installing the Profiler pack, which helps you identify memory leaks in your custom Mule extensions, and the scripting module, which provides facilities for using scripting languages in Mule.

  3. When you are prompted to specify the installation directory, be sure to specify the same directory as you specified for the MULE_HOME environment variable.

  4. If you will use Maven, skip ahead to set up your Maven repository.

Set Up the Maven Repository

You are now ready to set up your Maven repository as follows:

  1. Open a command prompt and navigate to the Mule bin directory.

  2. Type populate_m2_repo.cmd followed by the location of the Maven repository directory (the same directory you specified in the settings.xml file when you installed Maven).

For example:

cd c:\mule\binpopulate_m2_repo.cmd c:\.m2\repository

This step is required to populate the Maven repository with the local Mule Enterprise JAR files from the distribution. Note that when you add Mule Enterprise-only features to your code, you must add the correct dependencies to your POM before building your project with Maven.

You have completed the Mule installation and setup.

Installing the Mule Community or Snapshot Release

This section describes installation of the community or snapshot release on Windows or Linux/UNIX.

  1. If you have a previous release already installed, you should delete the directory where it is installed before installing the later release.

  2. Go to the Mule download page.

  3. Click the link next to the release you want to download. Use the .zip links for installing on Windows and the .tar.gz links for installing on Linux/UNIX. The latest releases are at the top of the page.

  4. On Linux/UNIX, if you must download it through a terminal instead of a browser, or if you must download to a remote computer without X-Windows, use wget. For example, to download the Mule 2.0.1 snapshot using wget, enter the following command on one line:

    wget http://snapshots.dist.codehaus.org/mule/org/mule/distributions/mule-full/2.0.1-SNAPSHOT/mule-full-2.0.1-SNAPSHOT.tar.gz
  5. After the distribution is downloaded, extract the files from it into your installation directory. For example, on Linux/UNIX, you would switch to your installation directory, and then enter the following command:

    tar -xvzf mule-full-2.0.1-SNAPSHOT.tar.gz
    Do not install Mule in a directory path that contains spaces!

Installing Multiple Instances

To install multiple instances of Mule on the same machine, simply unpack the distribution archive as described above to a different location.

Mule 3 does no longer support sharing a Mule installation directory between multiple instances.

Installing the Mule IDE

Download the latest Mule IDE from here. Unzip the file and open the Studio application. If you want to reinstall a legacy version of Mule Studio, contact MuleSoft Support.