Cypress 4 AMI Install Instructions - projectcypress/cypress GitHub Wiki

An AMI is a virtual machine template that can be used to clone an instance of an Amazon Elastic Compute Cloud virtual machine. Amazon Virtual machines can be run for a low cost hourly fee (see: http://aws.amazon.com/ec2/pricing/).

You will need an NLM VSAC account to download value set definitions and finalize the installation of the AMI. You can sign up for an NLM VSAC account at https://uts.nlm.nih.gov/home.html. Click the Sign Up link in the upper right of the page.

  1. Go to the Amazon Web Services (AWS) Console. Log into the EC2 console using an Amazon account, or create a new account. On the Main screen select the EC2 link under Amazon Web Services.
  2. The EC2 Dashboard screen should then appear. It provides the necessary functions for creating and managing your instance. If you do not already have a Key Pair, it will be necessary for you to create one. If you do have a Key Pair, skip ahead to the section “Create and Launch Instance”.
  3. Click the “Key Pairs” link under the “Network & Security” section on the left side of the screen.
  4. The “Key Pairs” screen that appears is used to create a key pair consisting of public and private keys used for secure access to the service. Click the “Create Key Pair” button.
  5. Enter a name for the key pair in the resulting window and click the “Yes” button.
  6. You will then be prompted by your browser to save the key file generated by Amazon. Save this file to a location you will easily remember as you will need it later.
  7. Return to the EC2 dashboard screen by clicking “EC2 Dashboard” on the left side of the screen.
  8. Click the “Launch Instance” button on the EC2 dashboard screen.
  9. In the resulting “Choose an Amazon Machine Image” screen, click the “Community AMIs” category on the left side of the screen, and enter “cypress” in the search field to find the available Cypress images. Click the ‘Select” button next to the Cypress AMI you wish to use.
  10. The “Choose an Instance Type” screen should then appear. Select the “All Instance Types” category on the left side of the screen, and select the “m3.large” instance type in the table. Click the “Next: Configure Instance Details” button.
  11. The “Configuration Instance Details” screen should appear. Verify that the default settings match the following illustration, and click the “Next: Add Storage” button.
  12. In the “Add Storage” screen, set the machine size to 20 GB, and click “Next: Tag Instance”.
  13. In the “Tag Instance” screen, enter a name for your Cypress instance in the “Value” field, and click “Next: Configure Security Group”.
  14. On the “Configure Security Group” screen, enter a security group name and description in the fields provided. There should already be a security rule in place for the SSH protocol. Add another rule for the HTTP protocol. Click the “Add Rule” button and select “HTTP” in the protocol drop-down list. The default settings for “Type”, “Port Range”, and “Source” should be as shown below. Click “Review and Launch” to continue.
  15. The “Review Instance Launch” page provides a summary of the AMI details with a preview of all configuration settings that were made during the AMI instance creation process. Review the settings under each category and make any corrections by selecting the corresponding “Edit...” link. When finished, click the “Launch” button to start the AMI.
  16. A dialog will appear for selecting the Key Pair (created earlier) to use with your AMI. Choose the correct Key Pair in the bottom pull down list, and confirm that you have the private key file for the selected Key Pair by checking the acknowledgement checkbox. If you do not have a Key Pair, you can still create one by selecting “Create a new key pair” in the top pull down list. The “Launch Instances” button will become enabled when the dialog has been properly completed.
  17. The “Launch Status” screen will then appear indicating that the launch of your instance has been initiated. The initialization of newly launched instances can take a few minutes. Click the “View Instances” button to see the status of launched instances.

Once you have completed the install, proceed to initial setup.