Nav

Walkthrough Create Clusters and Server Groups

logo cloud disabled logo hybrid active logo server disabled logo pcf disabled

This document walks you through the steps needed to configure a server in the Runtime Manager, and then add it to a Cluster or a Server Group so that you can deploy apps to multiple servers at a time.

To be able to walk through this scenario, you must have the following: * An Anypoint Platform account that enables you to use the runtime manager * Five servers on-premises that match the Hardware and Software Requirements to run Mule ESB. None of these servers can belong to any existing clusters or server groups.

MISSING:

Some preliminary - troubleshooting steps

when to use cluster / server group

The main difference between a cluster and a server group is that a server group is stateless whilst a cluster does keep track of server states. The servers in a cluster know what state the other servers are in, and so distribute the work load accordingly. Servers in a server group don’t know what the rest of the machines are up to which may lead to less computing efficiency.ct

For more technical details on how clusters work in Mule, see Managing Mule High Availability (HA) Clusters

Configure a Server

config server

The steps below should be carried out for every one of the servers that you wish to use. In this walkthrough, we’ll go through these steps on five different servers.

  1. Download the latest version of Mule ESB and unzip it on your hard drive

  2. Download the compatible version of the Runtime Manager Agent

  3. Unzip the mule-agent-[VERSION].zip file to the $MULE_HOME/bin folder.

    If you happen to have a prior version of the agent installed and are prompted to rename or replace files, select replace all
  4. Log in to your account on the Anypoint Platform

  5. Navigate to Cloudhub and the correct environment, select the Servers tab, then click Add Server

    add server

  6. The Runtime Manager provides you with a default command that includes all of the necessary parameters to install Runtime Manager Agent on a server and have it configured to work with your Anypoint Platform organization. Click Copy to copy this command to your clipboard.

    org code

  7. Open a command line window. CD into the $MULE_HOME/bin folder

  8. Paste the command you just copied and run it

    Replace “server name” with a server name of your choice.
  9. At this point you should see a succes message. If you get any errors, check the troubleshooting section below

Troubleshooting

  1. Check to make sure your Mule instance on the server is running. Type ./mule on the command line. If so, you should see a stream of messages

    screenshot

  2. If so, hit Ctrl + C to stop the process

  3. Verify that your Mule ESB version is compatible with the Runtime Manager Agent version you’re using, check the compatibility matrix. If your versions aren’t compatible, please download the correct versions and follow the steps above once more. If they are, please contact support.

Set up a Cluster

create cluster

  1. In the Servers tab, click Crate Cluster

  2. Select Multicast (because bla bla)

  3. Select the servers you want to include in your cluster

    image

    You can only select stand-alone servers (not part of a previous cluster/server group) that are online
  4. Click Create Cluster

    image

  5. Wait for the servers to restart and come online again. You will be prompted with a success message

If you have already created a cluster and wish to add additional servers to it, follow the steps below:

  1. In the Servers tab, click on the cluster you wish to scale up

  2. On the side panel, click Add Server

    image

  3. Select the server you wish to add

  4. Wait for the servers to restart and come online again. You will be prompted with a success message

Deploy an app to a Cluster

deploy to cluster

  1. Navigate to the Applications tab

  2. Click Deploy to deploy an application

  3. Assign a name to your application and select the target, in this case the cluster you created

    image

  4. Click Choose file to select the application you will deploy

    The file you assign must be a Mule .zip file. See how to export these files from studio in Importing and Exporting in Studio.
  5. Your application should now be deployed and come online

Set up a Server Group

server group

  1. In the Servers tab, click Crate Group

  2. Select the servers you want to include in your group

    image

    You can only select stand-alone servers (not part of a previous cluster/server group) that are online
  3. Click Create Group

    image

  4. Wait for the success message

Deploy an App to a Server Group

deploy to server group

  1. Navigate to the Applications tab

  2. Click Deploy to deploy an application

  3. Assign a name to your application and select the target, in this case the server group you created

    image

  4. Click Choose file to select the application you will deploy

    The file you assign must be a Mule .zip file. See how to export these files from studio in Importing and Exporting in Studio.
  5. Your application should now be deployed and come online

Deploy an App to the Cloud