Skip to main content

CloudFormation - Lifecycle

The following page describes the process for deploying the Sonatype IQ Server on Amazon Web Services using CloudFormation templates. The CloudFormation templates are for CentOS 7.

Requirements

  • An Amazon Web Services account

  • Subscribe to the CentOS 7 image in the AWS Marketplace

If you have not already subscribed to the CentOS 7 image, do the following:

Navigate your browser to AWS Marketplace and sign in to your AWS account

Click the Continue to Subscribe button

126657313.png

To create the subscription, review the pricing information and accept the terms.

126657314.png

Your subscription request is processing...

126657315.png

Select Template

On the Select Template page, accept the defaults and click the Next button.

126657300.png

Specify Details

On the Specify Details page, fill in the name of your stack (Stack name). Optionally you can provide an EC KeyName for SSH access, a LogGroupName to log to the specified CloudWatch log group, a specific Sonatype IQ Server version to use as well as network-related configuration. Then, click the Next button.

Options

If desired, fill out optional values on the Options page.

126657303.png

Review

On the Review page, make certain to check acknowledgment and accept the other defaults. Select the Create button.

126657311.png

Stack Creation

You are taken to the CloudFormation Stacks page after selecting Create on the Review page.

126657305.png

Stack Completion

After several minutes, stack creation will be completed.

126657306.png

Website URL

To find the resulting Sonatype IQ Server website URL, select the stack name and open the Outputs tab. Then, click the WebsiteURL link.

126657307.png

Login to Sonatype IQ Server

The website URL link will take you to the Sonatype IQ Server login page.

The allocation of AWS resources takes a while and there will be a delay in Sonatype IQ Server spinning up. The CloudWatch log group generated for the stack will provide feedback as to the progress, generally, if there are no logs AWS is still doing its allocation.

126657299.png

SSH access to the Sonatype IQ Instance

To SSH into the AWS IQ Server instance, you need to use your AWS Key Pair, and the username to use is "centos".

Managing the Sonatype IQ Server service

The IQ Server is controlled by the service name "nexus-iq-server.service". Once you SSH into the instance as "centos", you can manage the service with:

To stop the service:

sudo systemctl stop nexus-iq-server.service

To start the service:

sudo systemctl start nexus-iq-server.service