Changes between Version 6 and Version 7 of GENIUserWorkspace


Ignore:
Timestamp:
07/03/12 20:38:35 (7 years ago)
Author:
Jeanne Ohren
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GENIUserWorkspace

    v6 v7  
    66
    77  - Ubuntu 12.04
    8   - Most common tools are installed in /opt
    9 
    10 
    11 == Configuring Credentials ==
    12 
    13 You will need three sets of credentials (two optional) when using the user workspace:
    14 
    15 1. A GENI certificate.
    16    This is the SSL certificate (with .pem extension)
    17    that you download from one of the slice authorities (e.g. emulab.net
    18    or pgeni.gpolab.bbn.com)
    19 
    20    You can use a certificate with or without a passphrase.
    21 
    22 2. (Optional) An iRODS account.
    23    This is only needed if you want to access an iRODS server from the
    24    user workspace.
    25    You must have the following information in an irods configuration file.
    26 
    27 {{{
    28     irodsHost
    29     irodsPort
    30     irodsDefResource
    31     irodsHome
    32     irodsCwd
    33     irodsUserName
    34     irodsZone
    35 }}}
    36 
    37    Make sure you remember the password for your iRODS account.  You will
    38    need this when you run credconfig.sh below.
    39 
    40 
    41 3. (Optional)  A Java Keystore file created from your GENI certificate.
    42    '''This is only needed if you want to use Flukes.'''
    43    See https://geni-orca.renci.org/trac/wiki/flukes/#Userauthorization
    44    for instructions on how to generate the keystore file.
    45 
    46    Make sure you remember the alias and password that you used when
    47    creating the keystore file.  You will need this when you run Flukes.
    48 
    49 Transfer these files to a location in your home directory.  You can do this with ftp, scp, or [wiki:GENIUserWorkspace#UsingSharedFolders shared folders].
    50 
    51 With these 1-3 files, you can configure your credentials with the credconfig.sh tool.
    52 
    53 {{{
    54    $ credconfig.sh -g <path-to-geni-credential> -i <path-to-irods-config> -f <path-to-jks-file>
    55 }}}
    56 
    57 
    58 The -g parameter is required and the -i and -f parameters are optional.
    59 
    60 Example:
    61 
    62 {{{
    63    $ credconfig.sh -g /home/geniuser/gpo_ctcert.pem -f /home/geniuser/pgeni.jks -i /home/geniuser/irods.config
    64 }}}
    65 
    66 A pair of SSH keys will be generated for you using the private key from your GENI certificate.
    67 
    68 == Using Shared Folders ==
    69 
    70 If you need to transfer files from your host machine/laptop, the easiest way is typically using Shared Folders.
    71 Follow these steps to set up a shared folder on your user workspace.
    72 
    73 1. Go to the !VirtualBox "Devices" menu and select "Shared Folders..."
    74 
    75 2. Click on the "Add" button on the right (looks like a folder with a plus sign).
    76 
    77 3. Select the path of the folder you would like to share with your VM.
    78 
    79 4. Enter the name you would like to give this shared folder in "Folder Name:" (e.g. myshared)
    80 
    81 5. Click on "OK" in the Add Shares window
    82 
    83 6. Click on "OK" in the Shared Folders window
    84 
    85 7. Create the directory where you would like you shared folder mounted (e.g. /media/shared): 
    86 {{{
    87 sudo mkdir /media/shared
    88 }}}
    89 
    90 8. Mount the shared folder: 
    91 {{{
    92 sudo mount -t vboxsf myshared /media/shared
    93 }}}
    94 
    95 You should now be able to access your folder at /media/shared.
    96 
    97 
    98 == Basic Environment ==
    99 
    100   - Ubuntu 12.04
    101   - OpenJDK JRE 7
    1028  - Most common tools are installed in /opt
    1039  - Home directory structure
     
    11824}}}
    11925
    120 ----
     26== Credentials ==
    12127
    122 == Credentials ==
    123 === SSH key pair ===
    124   - Generated automatically by omni-configure.py
    125      - named geni_key
    126   - Location added to omni_config
    127   - Public key installed on slice nodes
    128   - Private key can be added to ssh-agent for password-less login
     28The tutorial VM has been set up with temporary GENI credentials to be used during the tutorials.  These credentials will
     29be disabled shortly after GEC14.
    12930
    130 === GENI certificate ===
    131   - Download from Emulab or GPO
    132   - With or without passphrase
    133   - Location added to omni_config, environment variables, and .flukes.properties
    134 
    135 === Java Keystore ===
    136   - This file is needed to run Flukes
    137   - This is generated from the GENI certificate downloaded from Emulab or GPO
    138   - See [https://geni-orca.renci.org/trac/wiki/flukes/#Userauthorization] for instructions on how to generate the JKS file.
    139  
    140 === iRODS account ===
    141   - Configured in $HOME/.irods/.irodsEnv
    142 
    143 ----
     31You can install your own set of credentials by following these [wiki:GENIUserWorkspace/ConfigCredentials Configuring Credentials] instructions.
    14432
    14533== Tools ==
    14634
    14735=== Protogeni test scripts ===
    148   - Used by LAMP scripts
    14936  - Installed in /opt/protogeni
    150 
    151 === LAMP scripts ===
    152   - Installed in /opt/lamp
    153   - Symlinked into /opt/protogeni
    154   - lamp-sendmanifest.py and lamp-getcertificate.py downloaded from links on http://groups.geni.net/geni/wiki/LAMP/Tutorial
    155   - placelampcert.sh written by J. Ohren
    15637
    15738=== OMNI ===
     
    15940  - Version 1.6.2 downloaded from http://trac.gpolab.bbn.com/gcf/wiki/GettingGcf
    16041  - omni_config generated by omni-configure.py
    161   - omni_config installed in each users home directory ($HOME/.gcf/omni_config)
     42  - omni_config installed in home directory ($HOME/.gcf/omni_config)
    16243
    163 === OMF EC ===
     44=== OMF EC, RC, AM ===
    16445  - Installed version 5.4.
    165   - Installed according to instructions at http://omf.mytestbed.net/projects/omf/wiki/Installation_Guide_54#Installing-the-Experiment-Controller-EC
     46  - Installed according these instructions
     47     - http://omf.mytestbed.net/projects/omf/wiki/Installation_Guide_54
    16648
    16749=== iRODS client ===
     
    17052  - Config file installed in each users home directory
    17153    - .irods/.irodsEnv
     54
     55    - Example:
     56{{{
     57# iRODS server host name:
     58irodsHost 'emmy9.casa.umass.edu'
     59# iRODS server port number:
     60irodsPort 1247
     61
     62# Default storage resource name:
     63irodsDefResource 'iRODSUmass'
     64# Home directory in iRODS:
     65irodsHome '/geniRenci/home/gimiXX'
     66# Current directory in iRODS:
     67irodsCwd '/geniRenci/home/gimiXX'
     68# Account name:
     69irodsUserName 'gimiXX'
     70# Zone:
     71irodsZone 'geniRenci'
     72}}}
    17273
    17374=== Development Tools ===
     
    19697 - adobe-flashplugin
    19798 - omf-expctl-5.4
     99 - omf-resctl-5.4
     100 - omf-aggmgr-5.4
     101 - oml2-server
     102 - oml2-iperf
     103 - oml2-nmetrics
     104 - imagemagick
    198105
    199 ----
    200 
    201 == Security Policies ==
    202   - External ports
    203     - HTTP (80)
    204     - HTTPS? (443)
    205     - SSH (22)
    206 
    207   - Passphrases for SSH keys?
    208      - Can use ssh-agent for running scripts
    209   - Passphrases for protoGENI certificates?
    210      - How to script using OMNI?
    211   - Storing GENI credentials?
    212   - !StrictHostKeyChecking in SSH config?
    213      - removes fingerprint verification question
    214      - GUSH suggests this to avoid some issues
    215  
    216 
    217 ----