MuleSoft Setup v1.

MuleSoft
On-Prem Cluster Setup

Page 1
MuleSoft Setup v1.0

Page 2
 MuleSoft Setup v1.0

Contents
1. Introduction....................................................................................................................................................... 5

2. Where do you get the software?......................................................................................................................... 5

2.1 Login to Anypoint Support............................................5
2.2 Click on Support Center..............................................6
2.3 Click on Select Cloud................................................6
2.4 Choose Anypoint Platform.............................................7
2.4.1 Click on Downloads................................................8
2.4.2 Anypoint Studio IDE...............................................8
2.4.3 Mule Runtime......................................................9
2.4.4 Mule Agent.......................................................10

3 JDK Setup Information...................................................................................................................................... 11

3.1 Install JDK.........................................................11
3.2 Verify JAVA_HOME....................................................11
3.3 Setup JAVA_HOME.....................................................12
3.4 Install Mule Runtime Engine.........................................12
3.5 Setup MULE_HOME.....................................................12

4 Install License................................................................................................................................................... 13
4.1 Test Mule Runtime (Before License)..................................13
4.2 Install License.....................................................14
4.3 Test Mule Runtime (After License)...................................15

5 Whitelist all the below URL’s............................................................................................................................ 15

6 Agent setup...................................................................................................................................................... 16

7 Cluster.............................................................................................................................................................. 18
7.1 Create the cluster..................................................18

8 Code Deployment............................................................................................................................................. 20
8.1 Domain Project Deployment...........................................20
8.2 Projects Deployment.................................................20

Page 3
 MuleSoft Setup v1.0

References..................................................................................................................................................................... 24

Page 4
 MuleSoft Setup v1.0

1.Introduction
This document helps in understanding how the muleSoft runtime has to be installed in Linux RedHat
distribution and Cluster them and use with the physical load balancer. In the current scenario where the
mule runtimes are being installed, the native VM OS instances are already installed and Physical load
balancer is already configured.

This rundown shows the before and after license installation and also indicates the server installations
status

2.Where do you get the software?

2.1 Login to Anypoint Support

Link: https://anypoint.mulesoft.com/login/

Username: PlatformUserName

Password: ******

Page 5
 MuleSoft Setup v1.0

2.2 Click on Support Center

2.3 Click on Select Cloud

Page 6
 MuleSoft Setup v1.0

2.4 Choose Anypoint Platform

Page 7
 MuleSoft Setup v1.0

2.4.1 Click on Downloads

Here you can choose important software needed for MuleSoft onprem/Development

2.4.2 Anypoint Studio IDE

Page 8
 MuleSoft Setup v1.0

2.4.3 Mule Runtime

Page 9
 MuleSoft Setup v1.0

2.4.4 Mule Agent

Page 10
 MuleSoft Setup v1.0

3 JDK Setup Information

3.1 Install JDK

Install either Open JDK from here (https://openjdk.java.net/install) or Oracle JDK from
here (https://www.oracle.com/in/java/technologies/javase-jdk15-downloads.html)

3.2 Verify JAVA_HOME

Check if the java home is set to respective JDK’s in both the VM’s, you can check this by
typing following command in terminal windows

3.2.1 Download MuleRuntime Environment

3.2.2 The link is available from you can download the MuleRunTime
binaries, from here (https://help.mulesoft.com/s/support)
3.2.3 For this installation, we have chosen mule-ee-distribution-
standalone-3.9.0-20220127 as this is the latest version as of this
runtime configuration.

Page 11
 MuleSoft Setup v1.0

3.3 Setup JAVA_HOME

3.3.1 Under ~/.bashrc, add following MuleSoft Home entry

3.4 Install Mule Runtime Engine

3.4.1 Create a directory under /mule-runtime as ‘mule’

3.4.2 Navigate to /mule-runtime/ mule-ee-distribution-standalone-3.9.0-
20220127
3.4.3 Explode the mule-ee-distribution-standalone-3.9.0-20220127.tar
file downloaded from step 3 under
3.4.4 Repeat the same in the second VM as well

3.5 Setup MULE_HOME

3.5.1 Under ~/.bashrc, add following MuleSoft Home entry

Page 12
 MuleSoft Setup v1.0

4 Install License

4.1 Test Mule Runtime (Before License)

4.1.1 From the terminal, run following $MULE_HOME/bin/mule and you

should see following output.

4.1.2 Server 1 Dev

Page 13
 MuleSoft Setup v1.0

4.2 Install License

4.2.1 Take a backup of license.lic file received from MuleSoft/MuleSoft

sales representative
4.2.2 Copy license.lic to /bin directory
4.2.3 Run $MULE_HOME/bin/mule -installLicense license.lic form
terminal window and you should see following output.

Page 14
 MuleSoft Setup v1.0

4.3 Test Mule Runtime (After License)

4.3.1 Run Mule EE Server with on terminal window., you should see this

5 Whitelist all the below URL’s

5.1.1 White list all these URL’s in all the VM’s which you want to them
cluster.

URLS
mule-manager.anypoint.mulesoft.com (Port 443)
mule-manager.eu1.anypoint.mulesoft.com (Port 443)
runtime-manager.anypoint.mulesoft.com (Port 443)
runtime-manager.eu1.anypoint.mulesoft.com (Port 443)
runtime-manager.gov.anypoint.mulesoft.com (Port 443)
arm-auth-proxy.prod.cloudhub.io (Port 443)
data-authenticator.anypoint.mulesoft.com (Port 443)
mule-manager.anypoint.mulesoft.com (Port 443)
mule-manager.eu1.anypoint.mulesoft.com (Port 443)

Page 15
 MuleSoft Setup v1.0

runtime-manager.anypoint.mulesoft.com (Port 443)

runtime-manager.eu1.anypoint.mulesoft.com (Port 443)
runtime-manager.gov.anypoint.mulesoft.com (Port 443)
exchange2-asset-manager-kprod.s3.amazonaws.com: (Port 443)
anypoint.mulesoft.com (Port 443)
analytics-ingest.anypoint.mulesoft.com (Port 443)
arm-auth-proxy.prod.cloudhub.io (Port 443)
data-authenticator.anypoint.mulesoft.com (Port 443)
runtime-manager.gov.anypoint.mulesoft.com (Port 443)
data-authenticator.gov.anypoint.mulesoft.com (Port 443)
gov.anypoint.mulesoft.com (Port 443)
eu1.anypoint.mulesoft.com (Port 443)
analytics-ingest.eu1.anypoint.mulesoft.com (Port 443)
arm-auth-proxy.prod-eu.msap.io (Port 443)
data-authenticator.eu1.anypoint.mulesoft.com (Port 443)

6 Agent setup
6.1 Stop the Mule server if it is already running: Stop Mule Runtime:
$MULE_HOME/bin/mule stop
6.2 unzip agent-setup-1.14.2.zip -d /data/mule-runtime/mule-enterprise-standalone-3.9.0-
20220127/bin

6.3 Execute the below commands:

6.4 Check mule-agent.jks and mule-agent.yml files are there in /conf folder if there
6.5 Delete mule-agent.jks file from conf folder

Page 16
 MuleSoft Setup v1.0

6.6 Add Server in the Anypoint Platform – Click on the Add Server

6.7 Copy the command from the clipboard and run from the console /bin folder
6.8 ./amc_setup -H abcf3162-d6ae-4ba1-abeb-2bf68af75a4e---668594 Test

Page 17
 MuleSoft Setup v1.0

6.9 $MULE_HOME/bin/amc_setup –U
6.10 Start the Mule server $MULE_HOME/bin/mule start
6.11 Repeat all these steps in all the needed VM’s which need to be part of the Cluster.

7 Cluster
7.1 Create the cluster

7.1.1 Add all the required Servers to the platform and start them from
the backend
7.1.2 Click on Create Cluster

Page 18
 MuleSoft Setup v1.0

7.1.3 Select all the required servers to cluster

7.1.4 Once clustered all the needed servers you can do activities like
start, stop the servers and deploy the applications directly from the
Anypoint platform.

Page 19
 MuleSoft Setup v1.0

8 Code Deployment
8.1 Domain Project Deployment
8.1.1 Extract the Domain project from the Anypoint Studio which is a zip
File

8.1.2 Upload it to the Server’s by using any FTP client tool E.g. WINSCP

8.1.3 Repeat the same with the server2 as well and check in the both the
servers, respective anchor file must be generated
automatically, in case of any error then please check the logs at the
location
/data/mule-runtime/mule-enterprise-standalone-3.9.0/logs/mule_
ee.log

8.2 Projects Deployment

8.2.1 Extract all the projects i.e. zip file and deploy them as below.
8.2.2 Log into Anypoint Platform with the valid credentials.

Page 20
MuleSoft Setup v1.0

Page 21
 MuleSoft Setup v1.0

8.2.3 Click on the Runtime Manager tab

8.2.4 Select the required Environment

8.2.5 Click on the Applications and then Deployments

Page 22
 MuleSoft Setup v1.0

8.2.6 Select the application file path and Name enter the Application
Name. Note: “_” is not allowed so use “-“ if required
8.2.7 Select the Deployment Target is the cluster you’ve configured.

8.2.8 Check for the application status, it should be Started otherwise you
have to check the logs(/data/mule-runtime/mule-enterprise-
standalone-3.9.0/logs/mule_ee.log) to identify the issue.

Page 23
 MuleSoft Setup v1.0

References
1. https://docs.mulesoft.com/mule-runtime/4.3/mule-standalone
2. https://docs.mulesoft.com/

Page 24