Contact Free trial Login

Install or Update Runtime Manager Agent

Enterprise Edition

logo cloud disabled logo hybrid active logo server active

Anypoint Runtime Manager agent registers Mule runtime engine (Mule) with Runtime Manager. After Mule is registered, you can manage it using Runtime Manager within the specific environment and Anypoint Platform business group in which Mule was registered. You cannot register Mule with multiple Runtime Manager business groups or environments.

Use the amc_setup command to install and configure the agent, using different parameters depending on the type of console to which you are connecting the agent:

When you run amc_setup, the agent creates the $MULE_HOME/conf/mule-agent.yml with the configuration options you specified. After initial installation, you can:

  • Rerun amc_setup to change the agent configuration or to update the agent version.

  • Modify mule-agent.yml to change the agent configuration.

    Some configuration options, such as extending JMX monitoring to other external services, are not possible using amc_setup. You must manually add them to mule-agent.yml. See Update Agent Configuration in mule-agent.yml.

Requirements and Restrictions

  • Do not register a single Mule runtime engine with more than one Runtime Manager business group or environment.

  • Do not register Mule with Runtime Manager more than once.

  • Do not register a Mule runtime engine with both an older Mule Management Console (MMC) and Runtime Manager.

    If Mule is currently managed in MMC, first unregister it with MMC before running amc_setup.

    MuleSoft support provides migration scripts to migrate from MMC to Runtime Manager.

Compatibility

The version of Runtime Manager agent must support the version of Mule and Runtime Manager you are using. To determine compatibility, check the Runtime Manager Agent Release Notes.

Mule 3.7.x and earlier and the API gateway 2.x and earlier include an earlier version of Runtime Manager agent, which doesn’t provide support for exporting data to external analytics tools. If you are running these earlier versions, you can download and update the agent to the latest version.

Prerequisites

  • Your enterprise license is current.

  • You are running Mule 3.6.0 and later, and the API gateway 2.1 and later.

  • If you must download the agent, you must have an Enterprise support account.

These instructions use paths for Mac or Linux. If you are using Windows, replace the $MULE_HOME path with %MULE_HOME%.

Install the Agent from a Mule Installation

The agent is bundled with the Mule runtime engine installation.

To install the agent:

  1. Download and install Mule.

  2. Run $MULE_HOME/bin/amc_setup and specify parameters for your installation.

Install the Agent From a .zip File

If you need a different version of the agent than the version included in the software distribution, you can download it from the Support Portal.

Download the Agent from the Support Portal

To verify compatibility with your Mule runtime engine and Runtime Manager, check the corresponding Runtime Manager Agent Release Notes.

To download the agent:

  1. Open MuleSoft Help Center.

  2. Click the Support tile.

  3. Click Login in the upper right and log in using your Anypoint Platform credentials.

    You must have an Enterprise support account to download the agent.
  4. In the MuleSoft Support page, click the Downloads tab.

  5. Click Mule Agent.

  6. Locate the agent to install and click Download in the Action column.

Install the Agent

To install the agent from the downloaded .zip file:

  1. Stop Mule or the API gateway runtime.

  2. Extract the downloaded agent-setup-VERSION.zip file to $MULE_HOME/bin.

    If prompted, overwrite any conflicting files.

  3. Run $MULE_HOME/bin/amc_setup and specify parameters for your installation.

  4. Restart Mule or the API gateway runtime.

Update Runtime Manager Agent

If you previously installed the agent with an earlier version of amc_setup, you can update the agent and retain your existing agent configuration in $MULE_HOME/conf/mule-agent.yml.

To update an existing Runtime Manager agent:

  1. Stop Mule or the API gateway runtime.

  2. Extract the downloaded agent-setup-VERSION.zip file to $MULE_HOME/bin.

  3. When prompted, overwrite any conflicting files.

  4. Run $MULE_HOME/bin/amc_setup -U.

    When you run amc_setup with the -U parameter, you can’t include other parameters on the command line.

  5. Restart Mule or the API gateway runtime.

What Happens When You Update the Agent

When you update the agent, the amc_setup script:

  • Backs up the current version of the agent:

    • Archives the $MULE_HOME/plugins/MULE_AGENT_PLUGIN_FOLDER to $MULE_HOME/tools/mule-agent-backup.zip

    • Archives any custom modules (usually located in $MULE_HOME/plugins/MULE_AGENT_PLUGIN_FOLDER/lib/modules) to $MULE_HOME/tools/mule-agent-modules-backup.zip

  • Updates agent libraries in $MULE_HOME/plugins/MULE_AGENT_PLUGIN_FOLDER/lib

  • Retains the current $MULE_HOME/conf/mule-agent.yml configuration file

  • Leaves modules in $MULE_HOME/plugins/MULE_AGENT_PLUGIN_FOLDER/lib/modules unchanged

    This folder contains all custom modules added to the agent (not included in the agent distribution).

Uninstall the Agent

To uninstall the agent:

  1. Stop Mule or the API gateway runtime.

  2. Remove these files:

    $MULE_HOME/conf/mule-agent.jks

    $MULE_HOME/conf/mule-agent.yml

  3. Restart Mule or the API gateway runtime.

amc_setup Parameters

Parameters to amc_setup enable you to:

To see available options, run ./amc_setup --help.

Parameter Value Description

--help

Displays help for the command on the command line.

-U

--update

Updates the agent, preserving the existing mule-agent.yml configuration file.

When you update a previous agent installation using -U, you can’t include other parameters on the command line.

-E

--encrypt

Encrypts a passphrase to use in the mule-agent.yml file.

Use this option alone to generate an encrypted passphrase.

--mule-home

mule-home-directory

Specifies the location of the $MULE_HOME directory.

Use this option if you are running the installation script from a location other than $MULE_HOME/bin.

The amc_setup script reads the mule-agent.yml file from ../conf, relative to the directory specified by --mule-home. For example, if the value of --mule-home is /tmp/Mule/bin, amc_setup reads mule-agent.yml from /tmp/Mule/conf.

--skip-gateway-clientid

Skips configuration of the API gateway client_id and client_secret.

-I

--insecure

Configures the agent to use an unencrypted REST connection.

Do not use this parameter with the PCE amc_setup parameters.

This option replaces the contents of $MULE_HOME/conf/mule-agent.yml.

-S

--secure

Configures the agent to establish a TLS connection with an on-premises administration console.

Do not use this parameter with the PCE amc_setup parameters.

This option replaces the contents of $MULE_HOME/conf/mule-agent.yml.

-H

--hybrid

token

server-name

Configures the agent to connect with either Anypoint Platform PCE or cloud-based Anypoint Platform managed by MuleSoft.

  • token is a base64 encoded string that specifies the exact business group and environment with which to register Mule with Runtime Manager.

  • server-name is the instance name used to identify Mule in the Runtime Manager console.

    This name must be unique within the business group’s environment.

-P

--proxy

proxy-host

proxy-port

proxy-user

proxy-password

Specifies the proxy configuration to use when registering with the connection.

Register Mule with the Cloud-Based Runtime Manager

To register Mule with the Anypoint Platform Runtime Manager cloud-based console, you need:

  • A valid registration token, which identifies a specific environment for a specific business group in Anypoint Platform

  • An instance name, which identifies Mule in the Runtime Manager console

To register Mule:

  1. In Runtime Manager, click Servers in the left menu.

  2. Click the Add Server button.

    Runtime Manager generates the amc_setup command, including token and server-name, to use to register Mule in your environment.

    The registration token includes your organization’s ID and the current environment.

  3. Click Copy to copy the command.

  4. In a terminal window, change to the $MULE_HOME/bin directory for the Mule instance that you’re registering.

  5. Paste the command on the command line.

  6. Change the instance name server-name to the unique name to use to label Mule in the Runtime Manager console.

    The server-name value is unique across environments. The server-name can be the same for the same organization in different environments.

  7. Include any other parameters on the amc_setup command line.

    Here is an example amc_setup command:

    ./amc_setup -H myToken myMuleServer --proxy myProxy-host myProxy-port myProxy-user myProxy-password

The amc_setup command generates the $MULE_HOME/conf/mule-agent.yml file.

Example mule-agent.yml File

Here is an example mule-agent.yml file generated by the -H option:

transports:
  rest.agent.transport:
    enabled: false
  websocket.transport:
    consoleUri: wss://mule-manager.anypoint.mulesoft.com:443/mule
    handshake:
      enabled: true
      body:
globalConfiguration:
  security:
    keyStorePassword: 42d9515f-3ca9-4ef4-87c0-586bd786b08b
    keyStoreAlias: agent
    keyStoreAliasPassword: 42d9515f-3ca9-4ef4-87c0-586bd786b08b
  authenticationProxy:
    endpoint: https://arm-auth-proxy.prod.cloudhub.io

Register Mule with Anypoint Platform PCE Runtime Manager

With Anypoint Platform Private Cloud Edition (Anypoint Platform PCE), all Runtime Manager services run on-premises rather than in a cloud environment managed by MuleSoft.

To register Mule with PCE Runtime Manager:

  1. Lot in to an Anypoint Platform PCE account.

  2. Ensure that you have correctly set up the DNS entry for your platform.

    See DNS or IP.

  3. Select a business group and environment with which to register Mule.

  4. Within the selected environment, click Servers in the left menu.

  5. Click the Add Server button.

    Runtime Manager generates the amc_setup command, including token and server-name, to use to register Mule in your environment.

    The registration token includes your organization’s ID and the current environment.

  6. Click Copy to copy the command.

  7. In a terminal window, change to the $MULE_HOME/bin directory for the Mule instance that you’re registering.

  8. Paste the command on the command line.

  9. Change the instance name server-name to the unique name to use to label Mule in the Runtime Manager console.

  10. Include any other parameters on the amc_setup command line.

  11. Append parameters to the command line to specify the URLs of services used by Runtime Manager to manage your Mule instance.

    Here is an example amc_setup command:

    ./amc_setup -H myToken myMuleServer -A +http://$DOCKER_IP_ADDRESS:8080/hybrid/api/v1+ -W "wss://_Anypoint Platform host_:8443/mule" -C https://_AnypointPlatform host_/accounts -F https://AnypointPlatformHost/apiplatform

The amc_setup command generates the $MULE_HOME/conf/mule-agent.yml file.

PCE Runtime Manager amc_setup Parameters

This table lists additional parameters required to register Mule with Anypoint Platform PCE Runtime Manager. Append these parameters to the ./amc_setup -H token server-name command.

Do not use these parameters with the -I or S parameters to configure REST API connections.

Parameter Value Description

-A

--amc-host

amc-host

Specifies the service location URL of your local instance of Runtime Manager, such as https://10.0.0.1:8080/hybrid/v1.

You can test whether the service is available at AMC_HOST/hybrid/v1.

-W

--mcm-host

mcm-host

Specifies the service location URL of your local instance of MCM: for example, wss://10.0.0.2:443/mule.

You can test whether the service is available at MCM_HOST/mule.

-C

--cs-host

core-services-host

Specifies the service URL of your local instance of Access Management, for example, https://10.0.0.3:8080/accounts.

You can test whether the service is available at core-services-host/accounts.

-D

--contract-caching-service-host

contract-caching-service-host

Specifies the service location (URL) of your local instance of Contract Caching Service: for example, https://10.0.0.4:8080.

-F

--api-platform-host

api-platform-host

Specifies the service location URL of your local instance of API Manager, for example, https://10.0.0.5:8080/apiplatform.

You can test whether the service is available at API_PLATFORM_HOST/apiplatform.

-Z

--auth-proxy-host

auth-proxy-host

Specifies the service location URL of your Auth Proxy, for example, https://10.0.0.3:8080.

We use cookies to make interactions with our websites and services easy and meaningful, to better understand how they are used and to tailor advertising. You can read more and make your cookie choices here. By continuing to use this site you are giving us your consent to do this.