Line 1: |
Line 1: |
− | == Starting GotCloud AMI ==
| + | Back to parent: [[GotCloud: Amazon]] |
− | After creating an amazon account (https://aws.amazon.com/), you can run the GotCloud demo on 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 |