3,045
edits
Changes
From Genome Analysis Wiki
Jump to navigationJump to search→Starting the GotCloud AMI
Back to parent: [[GotCloud: Amazon]]
The GotCloud AMI has the Demo data built into it, so just start up the GotCloud AMI.
== Introduction ==
After creating an amazon account (https://aws.amazon.com/), you can start a machine on Amazon using the GotCloud AMI.
The GotCloud AMI contains:
# GotCloud
# Reference Files
# Demo, see [[GotCloud: Amazon Demo]] for instructions on running the demo.
If you prefer not to use the GotCloud AMI, you can start up another AMI and install GotCloud as you normally would on a machine. See [[GotCloud#GotCloud Setup on Any Linux Machine|GotCloud Setup on Any Linux Machine]].
== Starting the GotCloud AMI ==
#Go to the EC2 Dashboard: https://console.aws.amazon.com/ec2/v2/home?region=us-east-1#
## If it is not already selected, select <code>N. Virginia</code> from the dropdown menu in the upper right hand corner of the dashboard.
##* The GotCloud AMI is currently only in the <code>US East (N. Virginia)</code> region, so be sure you are set to that.
## Select the <code>Launch Instance</code> button on the dashboard
#:[[File:Dashboard.png|750px]]
# Select the GotCloud AMI
## Select <code>Community AMIs</code> from the left menu
## Type <code>gotcloud</code> (enter) in the search menu in order to see the GotCloud AMIs
## Click the <code>Select</code> button on the most recent GotCloud AMI
#:[[File:LaunchAMI 1.png|750px]]
# Choose an Instance Type
## Select the Instance Type that you would like to run
##* For the Demo, we suggest <code>c3.2xlarge</code>
## Click the <code>Review and Launch</code> button
##* Optionally you can select <code>Next:Configure Instance Details</code> to additional steps
#:[[File:InstanceType1.png|750px]]
# Review Instance Launch
## Make any updates you would like
##* You can increase the default storage volume or add additional volumes by selecting <code>Edit storage</code>
## When everything is as you like, click the <code>Launch</code> button
#:[[File:ReviewInstance1.png|750px]]
# Select/Create key pair
## If you have an existing key pair that you want to use:
### Select <code>Choose an existing key pair</code>
### Select the key pair
### Check the box to acknowledge that you have access to the private key
### Click <code>Launch Instances</code>
## If you want to create a new key pair:
### Select <code>Create a new key pair</code>
### Name your key pair in the <code>Key pair name</code> field
### Select <code>Download Key</code>
### Click <code>Launch Instances</code>
# You will then see a <code>Launch Status</code> page
## Click the <code>View Instances</code> button in the bottom corner of the page to view your instances.
# Locate your instance
## Wait until your instance indicates <code>running</code>
## Select your instance (it will be highlighted in blue)
## Connect to your instance
##* You can connect in a couple of ways:
##*# Via a standalone SSH client
##*#* Connect using <code>ssh -i pathToYourKey/yourKey.pem ubuntu@yourPublicDNS</code>
##*#** Fill in your key and DNS appropriately
##*# Via Java SSH Client through the browser
##*#* Click the <code>Connect</code> button at the top of the page
##*#* A new window should pop up, in that window:
##*#*# Select <code>A Java SSH Client directly from my browser (Java required)</code>
##*#*# Enter <code>ubuntu</code> in the <code>User name</code> field
##*#*#* <code>ubuntu</code> is the default user in our AMI. GotCloud and example data are stored in the ubuntu user's home directory
##*#*# Enter the path to the private key (including the .pem filename) in the <code>Private key path</code> field
##*#*# Click the <code>Launch SSH Client</code> button
##*#** This will start a terminal on your instance.
#:[[File:RunningInstance1.png|750px]]
# You should now have terminal/command-line access to your instance and can run GotCloud from there.
## The ubuntu home directory has 2 subdirectories
### example - contains the data for the demo
### gotcloud - contains the gotcloud program and source
## Type <code>gotcloud</code> from any directory followed by the desired command-line parameters in order to run GotCloud
## You can try the [[GotCloud: Amazon Demo]] if you would like to test GotCloud
