Line 1: |
Line 1: |
| + | Back to parent: [[GotCloud: Amazon]] |
| + | |
| == Introduction == | | == Introduction == |
| After creating an amazon account (https://aws.amazon.com/), you can start a machine on Amazon using the GotCloud AMI. | | After creating an amazon account (https://aws.amazon.com/), you can start a machine on Amazon using the GotCloud AMI. |
Line 6: |
Line 8: |
| # Reference Files | | # Reference Files |
| # Demo, see [[GotCloud: Amazon Demo]] for instructions on running the demo. | | # 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 == | | == Starting the GotCloud AMI == |
Line 30: |
Line 34: |
| ## When everything is as you like, click the <code>Launch</code> button | | ## When everything is as you like, click the <code>Launch</code> button |
| #:[[File:ReviewInstance1.png|750px]] | | #:[[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 |