Contact Us 1-800-596-4880

Installing Connectors

Mule Runtime Engine versions 3.5, 3.6, and 3.7 reached End of Life on or before January 25, 2020. For more information, contact your Customer Success Manager to determine how you can migrate to the latest Mule version.

This page explains how to install connectors, uninstall connectors, and work with connector dependencies in both Anypoint Studio and Maven.

To Install From Anypoint Exchange

Anypoint Exchange lets you view details on a connector. However to install a connector, you need to first open Anypoint Studio.

In Anypoint Studio, click the X Anypoint Exchange icon in the taskbar.

When Exchange opens, search for the connector to install, click Install, and follow the prompts to install the connector.

To Install From the Studio Help Menu

If a connector or connector version is not available from Anypoint Exchange, you can install the connector using Anypoint Studio.

  1. Verify if a connector is already installed by clicking Help > Installation Details and searching for the connector. Click Close.

  2. Click Help > Install New Software.

  3. Set Work With to Anypoint Connectors Update Site.

  4. Expand a category and click the checkbox for the connector you want to install.

  5. Click Next, Next, I accept the terms of the license agreement, Finish, and restart Studio when prompted.

  6. From a Mule Project in Studio, search for the connector and drag it to the Canvas.

To Uninstall Connectors Using the Studio Visual Editor

  1. Under the Anypoint Studio menu, select About Anypoint Studio.

    AboutAnypointStudio
  2. In the About Anypoint Studio window, click Installation Details to display a list of the connectors you have installed on your instance of Anypoint Studio.

    AboutAnypointStudioMay2014-ed
  3. In the Installed Software tab, select the line item you wish to uninstall, then click Uninstall….

    InstalledSoftware
    To uninstall more than one item, click to select the first line item, then hold down the CRTL key (PC) or command key (Mac) as you click other line items.
  4. Click Finish to uninstall the item(s) you selected.

    uninstalldetails

To Uninstall Connectors Using Maven

To uninstall a connector, remove the Maven dependency for that connector from your pom.xml file.

Dependencies - Anypoint Studio

Automatic Dependency Management

In an Anypoint Studio project that does not include Maven support, when you add a connector to your flow, Studio automatically adds all of its dependencies (including .jar files) to your project’s classpath. Mule manages each connector’s dependencies as an Eclipse user library. Because Studio adds a connector’s dependencies to your project’s classpath, you can reference connector classes within other projects in your Anypoint Studio instance.

In an Anypoint Studio project that is built with Maven support, when you add a connector to your flow, Studio automatically adds the dependency (and the inclusion element to the maven-mule-plugin, if needed) to your pom file. Then, it refreshes your project dependencies based on the new contents of your pom file, and the connector (and its transitive dependencies) will appear referenced in your project’s "Referenced Libraries" section as a set of references to .jar files in your local m2 repository.

Manually Adding Connector Dependencies

Complete the following procedure to manually add connector dependencies to your project’s classpath in Studio.

  1. In the Package Explorer pane, right-click on your project’s name, then select Build Path > Add Libraries.

  2. In the Add Libraries wizard, select Anypoint Connector Dependencies, then click Next.

    AddLibrary1
  3. Check the boxes associated with the connector dependencies you wish to add to your project’s classpath.

    AddLibrary2
  4. Click Finish to add the dependencies.

Dependencies - Maven

If you are installing a connector as a Maven dependency, ensure that you complete the following three steps for each connector:

  1. To make any connector module available to a Mavenized Mule application, first add the following repositories to your pom.xml file:

    <repositories>
        <repository>
            <id>mulesoft-releases</id>
            <name>MuleSoft Repository</name>
            <url>https://repository.mulesoft.org/releases/</url>
            <layout>default</layout>
        </repository>
        <repository>
            <id>mulesoft-snapshots</id>
            <name>MuleSoft Snapshot Repository</name>
            <url>https://repository.mulesoft.org/snapshots/</url>
            <layout>default</layout>
        </repository>
    </repositories>
  2. Then add the module as a dependency to your project, replacing insert-artifactId-here with the artifactId of the specific module you are adding and replacing RELEASE with the version of this module.

    <dependency>
        <groupId>org.mule.modules</groupId>
        <artifactId>insert-artifactId-here</artifactId>
        <version>RELEASE</version>
    </dependency>
  3. If you plan to use this module inside a Mule application, you need to add it to the packaging process. As such, the final zip file which contains your flows and Java code will also contain this module and its dependencies. Add a special inclusion to the configuration of the Mule-Maven plugin for this module, replacing insert-artifactId-here with the artifactId of the specific module you are adding.

    <plugin>
        <groupId>org.mule.tools</groupId>
        <artifactId>maven-mule-plugin</artifactId>
        <extensions>true</extensions>
        <configuration>
            <excludeMuleDependencies>false</excludeMuleDependencies>
            <inclusions>
                <inclusion>
                    <groupId>org.mule.modules</groupId>
                    <artifactId>insert-artifactId-here</artifactId>
                </inclusion>
            </inclusions>
        </configuration>
    </plugin>

See Also