AMP Cluster

This guide will help walk you through the necessary steps to install AMP Cluster. To run it and use it, consult the AMP Cluster section of the operations guide.

Prerequisites

As a customer of AMP you should have access to the cloudsoft-amp-all tarball. If you do not have access to this, please contact Cloudsoft. Ensure that this tarball has been expanded and is in an accessible place.

Ensure that you have an up to date BR CLI installed. If you do not, the quickest way to get one is to go to your running AMP server, select the menu icon in the top right and select the CLI download page. From that page, please select the flavour that will work with your operating system.

Installation

In the expanded cloudsoft-amp-all directory, navigate to:

extras/amp-cluster

In this folder you will find a file named ampcluster-api-{version}.jar. This jar is the stand-alone AMP Cluster API. When deploying an AMP Cluster, you will be asked to provide a link to an ampcluster-api JAR. Please host this file in a location that is accessible to the cloud in which you are going to deploy the cluster. For example, it could be hosted in an S3 bucket or your enterprise’s artifact repository.

Once that has been done we need to add the cluster bundle to a running AMP (the “overseer”). This bundle contains the entities required to deploy the cluster from AMP. Please use the br CLI to login to the AMP overseer server (here assuming it’s running at localhost with user user):

br login http://localhost:8081 user
# you will then be prompted for PASSWORD

Then add the AMP Cluster bundle to your AMP:

br catalog add amp-cluster-bundle-{version}.jar

Running and More Information

To create an AMP cluster instance, navigate to your running AMP. You can deploy AMP cluster like any other application, either by selecting it in the catalog, or composing it in the blueprint composer. Follow the instructions in the AMP Cluster section of the operations manual.

Appendix

AMP of AMPs - Previous versions of AMP used AMP of AMPs which is superseded by AMP Cluster. AMP Cluster however does not yet support isolated tenants so in some use cases the information here may be useful to manually build an AMP of AMPs where required. Please note that the blueprints for AMP of AMP are no longer supported, so some manual effort will be required. Multi-tenancy capabilities are planned via AMP Cluster are planned for a subsequent release which will restore all the capabilities of AMP of AMPs.