Changes between Version 4 and Version 5 of DICLOUD/GEC12tutorial

Timestamp:

10/17/11 15:31:33 (13 years ago)

Author:

David Irwin

Comment:

--

DICLOUD/GEC12tutorial

@@ -129 +129 @@
 $ sudo chgrp www-data geni_cert_web.pem
 }}}
+
+== Setup Environment Variables ==
+
+
+Step 5:  Setup environment variables
+------------------------------------
+
+{{{
+cd ~/Tutorials/DiCloud
+nano environment
+
+[ Insert correct from geni_aws_credentials.txt
+    AWS_ACCESS_KEY_ID=
+    AWS_SECRET_ACCESS_KEY= ]
+
+cat environment >> ~/.bashrc
+}}}
+
+Add Access Key Id and Secret Access Key to .s3cfg file.
+Copy .s3cfg file to ~geni
+
+{{{
+cp ~/Tutorials/DiCloud/.s3cfg ~/.s3cfg
+}}}
+
+
+== Run the DiCloud server ==
+
+{{{
+cd ~/Tutorials/DiCloud/dicloud/bin
+./dicloud_server.sh
+}}}
+
+
+Step 7: Using the DiCloud console
+---------------------------------
+
+Open a new terminal.  We run ntpdate to make sure the time is accurate.  Amazon will fail calls from machines with inaccurate local time.
+
+{{{
+sudo ntpdate ntp.ubuntu.com
+cd ~/Tutorials/DiCloud/dicloud/bin
+./dicloud_console.sh
+dicloud - not connected>connect localhost 1099
+Connecting to //localhost:1099/dicloud/server
+dicloud - //localhost:1099>ec2 start /home/geni/Tutorials/DiCloud/ec2/keys/geni_cert$
+dicloud - //localhost:1099>help
+Commands available for the main menu are:
+add credit amount_of_money
+   Add credit to the AWS account
+billing history history_size csv|html
+   Get the AWS account activity history in CSV or HTML format (a history of 0 retrie$
+connect DiCloudServerHostName RmiPortNumber
+   Connects to the DiCloud server
+ebs attach cert.pem pk.pem ec2_region ebs_volume_id ec2_instance_id device_name
+   Attach an EBS volume (ebs_volume_id) to the running instance (ec2_instance_id) as$
+ebs create cert.pem pk.pem size_in_gb ec2_region ec2_availability_zone
+   Create an EBS volume
+ebs delete cert.pem pk.pem volume_id ec2_region
+   Delete an EBS volume
+ebs detach cert.pem pk.pem ec2_region ebs_volume_id
+   Detach EBS volume ebs_volume_id from its EC2 instance
+ebs probe cert.pem pk.pem volume_id ec2_region ascii|html
+   Probe an EBS volume and get current status information
+ec2 probe cert.pem pk.pem instance_id ec2_region html|ascii
+   Check the status of a running EC2 instance
+ec2 start cert.pem pk.pem ami_id instance_nb instance_type ec2_region ec2_keypair_na$
+   Start a new EC2 instance
+ec2 stop cert.pem pk.pem instance_id ec2_region ec2_keypair_name
+   Stop an EC2 instance
+get balance
+   Get the AWS account balance
+help
+   Print this help message
+history [<command index>]
+   Display history of commands for the console.
+quit
+   Quit the console
+s3 create bucket_name region
+   Create an S3 bucket
+s3 delete bucket_name region
+   Delete an S3 bucket
+s3 get s3_bucket_name object_name file_path
+   Get the content of an object named object_name into the specified file from the S$
+s3 probe bucket_name region
+   Get information about an S3 bucket
+s3 put s3_bucket_name object_name file_path
+   Put the content of the specified file in an object named object_name in the S3 bu$
+shutdown
+   Shutdown the DiCloud server the console is currently connected to.
+dicloud - //localhost:1099>get balance
+Current balance is: $99.53222835338767
+dicloud - //localhost:1099>ec2 probe /home/geni/Tutorials/DiCloud/ec2/keys/geni_cert.pem /home/geni/Tutorials/DiCloud/ec2/keys/geni_pk.pem i-b87b74d8 us-east-1 ascii
+Instance Id: i-b87b74d8
+AMI Id: ami-78f21911
+Public name: ec2-75-101-245-135.compute-1.amazonaws.com
+Private name: ip-10-244-46-161.ec2.internal
+Public IP: 75.101.245.135
+Private IP: 10.244.46.161
+Instance State: running
+Instance Type: m1.small
+Key pair: geni-keypair
+Start time: 2011-10-17T17:31:41+0000
+Availability zone: us-east-1b
+dicloud - //localhost:1099>quit
+}}}
+
+You can also script the DiCloud console. An example is below.
+
+{{{
+$ echo "connect localhost 1099
+get balance
+quit" > ./getbalance.txt
+$ ./dicloud_console_script.sh -silent < ./getbalance.txt
+}}}
+
+Example use of S3
+
+{{{
+dicloud - //localhost:1099>s3 create gec12-tutorial-1 us
+dicloud - //localhost:1099>s3 put gec12-tutorial-1 test /home/geni/Tutorials/DiCloud/dicloud/bin/dicloud.properties
+Uploading file /home/geni/Tutorials/DiCloud/dicloud/bin/dicloud.properties as object test in bucket gec12-tutorial-1
+dicloud - //localhost:1099>s3 get gec12-tutorial-1 test /home/geni/Tutorials/DiCloud/test
+Downloading file /home/geni/Tutorials/DiCloud/test from object test in bucket gec12-tutorial-1dicloud - //localhost:1099>
+dicloud - //localhost:1099>s3 delete gec12-tutorial-1 us
+}}}
+
+Example use of EBS
+{{{
+dicloud - //localhost:1099>ebs create /home/geni/Tutorials/DiCloud/ec2/keys/geni_cert.pem /home/geni/Tutorials/DiCloud/ec2/keys/geni_pk.pem 1 us-east us-east-1a
+dicloud - //localhost:1099>ebs delete /home/geni/Tutorials/DiCloud/ec2/keys/geni_cert.pem /home/geni/Tutorials/DiCloud/ec2/keys/geni_pk.pem <volume_id> us-east
+}}}
+