Changes between Version 11 and Version 12 of DICLOUD/GEC12tutorial


Ignore:
Timestamp:
10/18/11 09:45:29 (13 years ago)
Author:
David Irwin
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • DICLOUD/GEC12tutorial

    v11 v12  
    55Tutorial sections:
    66
    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
     20The 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 ==
    2123
    2224 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.
     
    3941}}}
    4042
    41 == Install dependent software packages ==
     43== Setup: Install dependent software packages ==
    4244
    4345To install dependent software you need root access. The directions assume the user is able to use sudo to run commands as root.
     
    5759MySQL server will ask you to set a root password. Remember the password.
    5860
    59 == Setup !DiCloud's MySQL Server ==
     61== Setup: Configure !DiCloud's MySQL Server ==
    6062
    6163First, log into !MySQL and create the dicloud database by running the following commands.
     
    8082}}}
    8183
    82 == Create Amazon user credentials ==
     84== Setup: Create Amazon user credentials ==
    8385
    8486Note that tutorial participants should not perform this step.
     
    9395}}}
    9496
    95 == Register new user on Amazon EC2 ==
     97== Setup: Register new user on Amazon EC2 ==
    9698
    9799Note 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.
     
    104106AWSSecretKey=<Your Secret Key Here>
    105107}}}
    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
    111120$ cd ~/Tutorials/DiCloud/ec2/keys
    112 $ wget http://geni.cs.umass.edu/geni_cert.pem
    113 $ wget http://geni.cs.umass.edu/geni_pk.pem
    114 $ wget http://geni.cs.umass.edu/geni-keypair.pem
    115 $ wget http://geni.cs.umass.edu/geni-keypair.pub
    116 $ wget http://geni.cs.umass.edu/geni_aws_credentials.txt
    117 $ wget http://geni.cs.umass.edu/credentials.csv
    118 }}}
    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 {{{
    125121$ cp ./geni_pk.pem ./geni_pk_web.pem
    126122$ sudo chown www-data geni_pk_web.pem
     
    131127}}}
    132128
    133 == Setup environment variables ==
    134 
    135 {{{
    136 $ cd ~/Tutorials/DiCloud
    137 $ nano environment
    138 
    139 [ Insert correct from geni_aws_credentials.txt
    140     AWS_ACCESS_KEY_ID=
    141     AWS_SECRET_ACCESS_KEY= ]
    142 
    143 $ cat environment >> ~/.bashrc
    144 }}}
    145 
    146129Add Access Key Id and Secret Access Key to .s3cfg file.
    147130Copy .s3cfg file to ~geni
     
    151134}}}
    152135
    153 == Run the !DiCloud server ==
     136== Tutorial: Configuring Amazon for Tutorial Participants ==
     137
     138Tutorial 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 ==
    154146
    155147{{{
     
    158150}}}
    159151
    160 == Using the !DiCloud console ==
     152== Tutorial: Using the !DiCloud console ==
    161153
    162154Open a new terminal.  We run ntpdate to make sure the time is accurate.  Amazon will fail calls from machines with inaccurate local time.
     
    256248}}}
    257249
    258 == Using the !DiCloud web portal ==
     250== Tutorial: Using the !DiCloud web portal ==
    259251
    260252Go to http://localhost/vise/dicloud.
    261253
    262 == Running a Gush experiment using !DiCloud and/or Orca resources ==
     254== Tutorial: Running a Gush experiment using !DiCloud and/or Orca resources ==
    263255
    264256Direction adapted from http://groups.geni.net/geni/wiki/GEC11VMSetup under installing Gush.