How to Install and Configure a9s BOSH for PCF on AWS

Prerequisites

Ensure that the following tile has been installed:

Install and Configure a9s BOSH for PCF

Complete the following steps to download, install, configure, and deploy a9s BOSH for PCF.

  1. Download the product file from the Pivotal Network.

  2. Navigate to the Pivotal Cloud Foundry Operations Manager (Ops Manager) Installation Dashboard and click Import a Product to upload the product file.

  3. Click Add next to the uploaded a9s BOSH for PCF tile in the Ops Manager Available Products view to add it to your staging area.

  4. Click the newly added tile and review and configure the fields in the Settings pane. For information about the fields, see About Configuring a9s BOSH for PCF below.

  5. Click Apply Changes to deploy the service.

About Configuring a9s BOSH for PCF

Read this section for help completing Step 4 above.

IaaS Settings Section

In the IaaS Settings of the a9s BOSH for PCF tile, you have to choose AWS. Once AWS is selected, the following configuration options must be provided:

Value Description Example
AWS Access Key ID The ID of the Access key used by the a9s BOSH for PCF tile to communicate with the AWS API. Find instruction on how to create a new access key on AWS here. You have to configure the same permissions as you did for the PCF Ops Manager Director (you can also use the same Access Key ID). YOURAWSACCESSKEY
AWS Secret Access Key The secret access key which belongs to the AWS Access Key ID (see above). secret
AWS Default Key Name The name of a keypair on AWS. Find instructions on how to create a keypair on AWS here myawsname
AWS Default Security Group The name of an AWS Security Group, which will be assigned to each virtual machine of an a9s service instance. Ensure that:
  • The machines in this group are allowed to communicate with each other
  • PCF Elastic Runtime can access these machines via Port 3000
  • PCF Elastic Runtime can access these the default port of the respective service type (e.g port 5432 for the a9s PostgreSQL for PCF tile)
sg-56168731
AWS Default Region The AWS Region to which the service instances should be deployed. eu-west-1

Cloud Config Section

Cloud Config is a BOSH term and refers to your infrastructure specific configuration. It encapuslates all specifics so that BOSH can use the same deployment manifests across different IaaS installations.

To create the Cloud Config YAML, you can use the a9s Cloud Config Wizard (see: https://cloud-config.anynines.com/). It provides you a graphical user interface for the specification of all configuration values to ensure you do not miss anything and that you have a proper YAML structure.

Note: Ensure that you have specified a network with the name service-instances, two disk types named small and big and two VM types named small and big.

The big VM and disk types will be used for the creation of service instances when a big service plan should be used, such as mongodb-cluster-big or postgresql-cluster-big. The small VM and disk types will be used for the small service plans such as mongodb-cluster-small or postgresql-cluster-small.

Note: To reduce the risk that a data service instance experiences a split brain situation, ensure you have configured three availalbity zones.

a9s BOSH for PCF cloud config section

Errands Section

Find a description about the errands of the a9s BOSH for tile here.

Create a pull request or raise an issue on the source for this page in GitHub