Appendix A: Launch the Stack (Custom Installer) - Scale-Out Computing on AWS

Appendix A: Launch the Stack (Custom Installer)

For customers who want to maintain customization and extensibility, this solution allows you to deploy the AWS CloudFormation template using a custom installer in your hosted repository for production environments.

This solution is a collection of AWS CloudFormation templates, Amazon Elastic Compute Cloud (Amazon EC2) user data bootstrap scripts, and Python scripts. Before deploying, create a custom installer based on the build ID you want to use.

Automated Deployments

Before you launch the automated deployment, please review the architecture, prerequisites, and other considerations discussed in this guide. Follow the step-by-step instructions in this section to deploy this solution into your account using a custom installer.

Time to deploy: Approximately 60 minutes

What We'll Cover

Step 1. Download the Solution Template

  • Download the AWS CloudFormation template

Step 2. Create and Upload the Build

  • Create and upload the build

Step 3. Launch the Stack

  • Launch the AWS CloudFormation template into your AWS account.

  • Enter values for required parameter: Stack Name, User Name, Password

  • Review the other template parameters, and adjust if necessary.

Prerequisites

Before deploying this solution, you must create a new Amazon Simple Storage Service (Amazon S3) bucket in your AWS account. Or, you can use an existing Amazon S3 bucket.

Step 1. Download the Solution Template

This solution is open-source and hosted on GitHub. Use the following procedure to download the solution template:

  1. Navigate to the GitHub repository, select Clone or download

  2. Select Download Zip

  3. When the zip file is downloaded, extract the file on your local machine

Step 2. Create and Upload the Build

Use the following procedure to create and upload the build:

  1. Using Python2 or Python3, in a terminal window run the following command:

    $SOCA_DIR/source/manual_build.py

    This command will create a compressed installer folder on your local machine. For example, soca-installer-<xxxx.tar>.

  2. Navigate to the Amazon S3 console, and upload the newly created installer folder to your Amazon S3 bucket.

    Note

    Copy the Amazon S3 folder name and the root folder name for the installer folder you uploaded. You will use these names when deploying the AWS CloudFormation template.

    You can create multiple versions of this solution in the same Amazon S3 bucket. However, the name for each installer folder must be unique.

Step 3. Launch the Stack

This automated AWS CloudFormation template deploys Scale-Out Computing on AWS in the AWS Cloud. Verify that you have completed the prerequisites before you launch the stack.

Note

You are responsible for the cost of the AWS services used while running this solution. See the Cost section for more details. For full details, see the pricing webpage for each AWS service you will be using in this solution.

  1. Sign in to the AWS Management Console, select Choose a file

  2. Navigate to the installer folder you downloaded in Step 3, select the scale-out-computing-on-aws.template

  3. Launch the template, by following the deployment procedure from step 3.