Changes between Version 11 and Version 12 of DICLOUD/GEC12tutorial
- Timestamp:
- 10/18/11 09:45:29 (13 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
DICLOUD/GEC12tutorial
v11 v12 5 5 Tutorial sections: 6 6 7 * Pre-requisites 8 * Install dependent software packages 9 * Setup !DiCloud's MySQL database 10 * Create Amazon user credentials 11 * Register new user on Amazon EC2 12 * Configuring Amazon for tutorial participants 13 * Enabling access to keys for !DiCloud's web portal 14 * Setup environment variables 15 * Running the !DiCloud server 16 * Using the !DiCloud console 17 * Using the !DiCloud web portal 18 * Running a Gush experiment using !DiCloud and Orca 19 20 == Pre-requisites == 7 * Tutorial: Pre-requisites 8 * Setup: Install dependent software packages 9 * Setup: Configure !DiCloud's MySQL database 10 * Setup: Create Amazon user credentials 11 * Setup: Register new user on Amazon EC2 12 * Tutorial: Configuring Amazon for tutorial participants 13 * Tutorial: Enabling access to keys for !DiCloud's web portal 14 * Tutorial: Setup environment variables 15 * Tutorial: Running the !DiCloud server 16 * Tutorial: Using the !DiCloud console 17 * Tutorial: Using the !DiCloud web portal 18 * Tutorial: Running a Gush experiment using !DiCloud and Orca 19 20 The sections labeled as Setup have already been performed on each tutorial participants VM image, and can be skipped by tutorial participants. We provide them here as an example of how to setup an independent !DiCloud deployment. 21 22 == Tutorial: Pre-requisites == 21 23 22 24 1. Install !VirtualBox: Download the latest [http://www.virtualbox.org VirtualBox software]. If you already have !VirtualBox installed on your machine, make sure it is version 4.08 or above. … … 39 41 }}} 40 42 41 == Install dependent software packages ==43 == Setup: Install dependent software packages == 42 44 43 45 To install dependent software you need root access. The directions assume the user is able to use sudo to run commands as root. … … 57 59 MySQL server will ask you to set a root password. Remember the password. 58 60 59 == Setup !DiCloud's MySQL Server ==61 == Setup: Configure !DiCloud's MySQL Server == 60 62 61 63 First, log into !MySQL and create the dicloud database by running the following commands. … … 80 82 }}} 81 83 82 == Create Amazon user credentials ==84 == Setup: Create Amazon user credentials == 83 85 84 86 Note that tutorial participants should not perform this step. … … 93 95 }}} 94 96 95 == Register new user on Amazon EC2 ==97 == Setup: Register new user on Amazon EC2 == 96 98 97 99 Note that tutorial participants will be able to use a !DiCloud account, and do not need to create there own account. Tutorial participants will also use a pre-existing !DiCloud user, and do not need to perform the steps listed in the rest of this section. … … 104 106 AWSSecretKey=<Your Secret Key Here> 105 107 }}} 106 == Configuring Amazon for Tutorial Participants == 107 108 Tutorial participants should download their certificate, private key, key pair, credential.csv, and geni_aws_credentials.txt files by performing the following commands. 109 110 {{{ 108 109 == Setup: Configure environment variables == 110 111 {{{ 112 $ cd ~/Tutorials/DiCloud 113 $ nano environment 114 115 [ Insert correct from geni_aws_credentials.txt 116 AWS_ACCESS_KEY_ID= 117 AWS_SECRET_ACCESS_KEY= ] 118 119 $ cat environment >> ~/.bashrc 111 120 $ cd ~/Tutorials/DiCloud/ec2/keys 112 $ wget http://geni.cs.umass.edu/geni_cert.pem113 $ wget http://geni.cs.umass.edu/geni_pk.pem114 $ wget http://geni.cs.umass.edu/geni-keypair.pem115 $ wget http://geni.cs.umass.edu/geni-keypair.pub116 $ wget http://geni.cs.umass.edu/geni_aws_credentials.txt117 $ wget http://geni.cs.umass.edu/credentials.csv118 }}}119 120 == Enabling Access to Keys via !DiCloud's Web Portal ==121 122 We also create copies of the certificate and private key and change their ownership to www-data so the web portal can access them.123 124 {{{125 121 $ cp ./geni_pk.pem ./geni_pk_web.pem 126 122 $ sudo chown www-data geni_pk_web.pem … … 131 127 }}} 132 128 133 == Setup environment variables ==134 135 {{{136 $ cd ~/Tutorials/DiCloud137 $ nano environment138 139 [ Insert correct from geni_aws_credentials.txt140 AWS_ACCESS_KEY_ID=141 AWS_SECRET_ACCESS_KEY= ]142 143 $ cat environment >> ~/.bashrc144 }}}145 146 129 Add Access Key Id and Secret Access Key to .s3cfg file. 147 130 Copy .s3cfg file to ~geni … … 151 134 }}} 152 135 153 == Run the !DiCloud server == 136 == Tutorial: Configuring Amazon for Tutorial Participants == 137 138 Tutorial participants should download their certificate, private key, key pair, credential.csv, and geni_aws_credentials.txt files by performing the following commands. 139 140 {{{ 141 $ cd ~/Tutorials/DiCloud/ 142 $ ./key_install geni.cs.umass.edu 143 }}} 144 145 == Tutorial: Run the !DiCloud server == 154 146 155 147 {{{ … … 158 150 }}} 159 151 160 == Using the !DiCloud console ==152 == Tutorial: Using the !DiCloud console == 161 153 162 154 Open a new terminal. We run ntpdate to make sure the time is accurate. Amazon will fail calls from machines with inaccurate local time. … … 256 248 }}} 257 249 258 == Using the !DiCloud web portal ==250 == Tutorial: Using the !DiCloud web portal == 259 251 260 252 Go to http://localhost/vise/dicloud. 261 253 262 == Running a Gush experiment using !DiCloud and/or Orca resources ==254 == Tutorial: Running a Gush experiment using !DiCloud and/or Orca resources == 263 255 264 256 Direction adapted from http://groups.geni.net/geni/wiki/GEC11VMSetup under installing Gush.