Changes between Version 1 and Version 2 of GENIUserWorkspace


Ignore:
Timestamp:
05/25/12 18:51:52 (12 years ago)
Author:
Jeanne Ohren
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GENIUserWorkspace

    v1 v2  
    44
    55== Where can I find the workspace? ==
    6   - Currently on a BBN internal server.  Will be moved to an external server in the near future.
    7     [Add link here]
    8 
    9   - OVF image coming soon
    10     [Add link here]
     6
     7  - You can downloaded it from the BBN FTP server.
     8    - FTP information will be emailed to the appropriate lists.
     9    - Usernames and passwords will be emailed
     10
     11== Installing the VM ==
     12
     131. Install !VirtualBox
     14
     15    Download the !VirtualBox software from http://www.virtualbox.org.
     16
     17    If you already have !VirtualBox installed on your machine, make sure it is version 4.1 or above.
     18
     192. Download !VirtualBox VM image for tutorials
     20
     21    Download the !VirtualBox VM image (GENI UW 12.04 v1.0.ova) from the BBN FTP server.
     22
     233. Install the ''GENI UW 12.04 v1.0.ova'' virtual machine image
     24
     25    Start up !VirtualBox, select File->Import Appliance..., and follow the
     26    instructions.    Accept the default VM settings during the import.
     27
     28    To run the virtual machine, go to the Oracle VM !VirtualBox Manager window, select the VM and click the
     29    green arrow labeled Start at the top of this window.
     30
     31== Configuring Credentials ==
     32
     33You will need three sets of credentials (two optional) when using the user workspace:
     34
     351. A GENI certificate.
     36   This is the SSL certificate (with .pem extension)
     37   that you download from one of the slice authorities (e.g. emulab.net
     38   or pgeni.gpolab.bbn.com)
     39
     40   You can use a certificate with or without a passphrase.
     41
     422. (Optional) An iRODS account.
     43   This is only needed if you want to access an iRODS server from the
     44   user workspace.
     45   You must have the following information in an irods configuration file.
     46
     47{{{
     48    irodsHost
     49    irodsPort
     50    irodsDefResource
     51    irodsHome
     52    irodsCwd
     53    irodsUserName
     54    irodsZone
     55}}}
     56
     57   Make sure you remember the password for your iRODS account.  You will
     58   need this when you run credconfig.sh below.
     59
     60
     613. (Optional)  A Java Keystore file created from your GENI certificate.
     62   '''This is only needed if you want to use Flukes.'''
     63   See https://geni-orca.renci.org/trac/wiki/flukes/#Userauthorization
     64   for instructions on how to generate the keystore file.
     65
     66   Make sure you remember the alias and password that you used when
     67   creating the keystore file.  You will need this when you run Flukes.
     68
     69Transfer these files to a location in your home directory.  You can do this with ftp, scp, or [wiki:#UsingSharedFolders shared folders].
     70
     71With these 1-3 files, you can configure your credentials with the credconfig.sh tool.
     72
     73{{{
     74   $ credconfig.sh -g <path-to-geni-credential> -i <path-to-irods-config> -f <path-to-jks-file>
     75}}}
     76
     77Example:
     78
     79{{{
     80   $ credconfig.sh -g /home/geniuser/gpo_ctcert.pem -f /home/geniuser/pgeni.jks -i /home/geniuser/irods.config
     81}}}
     82
     83A pair of SSH keys will be generated for you using the private key from your GENI certificate.
     84
     85== Using Shared Folders ==
     86
     87If you need to transfer files from your host machine/laptop, the easiest way is typically using Shared Folders.
     88Follow these steps to set up a shared folder on your user workspace.
     89
     901. Go to the !VirtualBox "Devices" menu and select "Shared Folders..."
     91
     922. Click on the "Add" button on the right (looks like a folder with a plus sign).
     93
     943. Select the path of the folder you would like to share with your VM.
     95
     964. Enter the name you would like to give this shared folder in "Folder Name:" (e.g. myshared)
     97
     985. Click on "OK" in the Add Shares window
     99
     1006. Click on "OK" in the Shared Folders window
     101
     1027. Create the directory where you would like you shared folder mounted (e.g. /media/shared): 
     103{{{
     104sudo mkdir /media/shared
     105}}}
     106
     1078. Mount the shared folder: 
     108{{{
     109sudo mount -t vboxsf myshared /media/shared
     110}}}
     111
     112You should now be able to access your folder at /media/shared.
     113
    11114
    12115== Basic Environment ==
    13116
    14   - Ubuntu 10.04
    15   - Oracle JRE 1.6
    16   - Tomcat 6
     117  - Ubuntu 12.04
     118  - OpenJDK JRE 7
    17119  - Most common tools are installed in /opt
    18120  - Home directory structure
     
    22124    .ssl
    23125       - Protogeni certificate
     126       - Java keystore (for Flukes)
    24127    .gcf
    25128       - omni_config
    26129    .irods
    27130       - .irodsEnv:  configuration file for iRODS client
    28     rspecs
    29        - user's rspecs
    30     scripts
    31        - common scripts used for automating tests, etc.
    32     experiments
    33       - gush.prefs
    34       - directory for each experiment (assume that gush is run from here)
    35          - rspecs
    36             - may symlink back to higher level rpecs
    37          - scripts
    38             - may symlink back to higher level scripts
    39          - directory.xml
    40          - gush.prefs (default symlink to upper level)
    41          - helper-scripts
    42              - symlink to /opt/gush/helper-scripts
    43              - gush doesn't seem to have a way to access the common location via PATH or config?
    44          - tests
    45              - test configurations (XML) for gush
     131    .flukes.properties
     132       - Flukes configuration
     133
     134
    46135}}}
    47136
     
    50139== Credentials ==
    51140=== SSH key pair ===
    52   - Generated locally 
     141  - Generated automatically by omni-configure.py
     142     - named geni_key
    53143  - Location added to omni_config
    54144  - Public key installed on slice nodes
     
    56146
    57147=== ProtoGENI certificate ===
    58   - Downloaded from Emulab
    59   - With or without passphrase?
    60   - Location added to omni_config
     148  - Download from Emulab or GPO
     149  - With or without passphrase
     150  - Location added to omni_config, environment variables, and .flukes.properties
    61151
    62152=== iRODS account ===
    63   - Obtained from Shu
    64153  - Configured in $HOME/.irods/.irodsEnv
    65154
     
    80169=== OMNI ===
    81170  - Installed in /opt/gcf
    82   - Version 1.6.1 downloaded from http://trac.gpolab.bbn.com/gcf/wiki/GettingGcf
    83   - omni_config generated by a script (see Niky)
     171  - Version 1.6.2 downloaded from http://trac.gpolab.bbn.com/gcf/wiki/GettingGcf
     172  - omni_config generated by omni-configure.py
    84173  - omni_config installed in each users home directory ($HOME/.gcf/omni_config)
    85174
    86 === GUSH ===
    87   - Installed in /opt/gush.new, symlinked to /opt/gush
    88   - Installed from SVN
    89   - Config files installed in each users direc
    90     - gush.prefs
    91 
    92175=== OMF EC ===
    93   - Installed version 5.3.  (5.4 did not seem to have instructions for Ubuntu lucid)
     176  - Installed version 5.4.
    94177  - Installed according to instructions at http://omf.mytestbed.net/projects/omf/wiki/Installation_Guide_53#Installing-the-Experiment-Controller-EC
    95178
    96 === Digital Object Repository and Data Archive ===
    97   - Repository installed in /opt/dorepository
    98   - web interface installed in /var/lib/tomcat6/webapps
    99   - Currently uses handle server at mda.doregistry.org
    100     - Should this be moved local?
    101   - Uses shared archive at mda.
    102 
    103 === GEMINI Portal ===
    104   - TBD
    105 
    106 === GIMI Portal ===
    107   - TBD
    108 
    109 === Measurement Data Object Descriptor Editor ===
    110   - TBD
    111 
    112 === Development Tools? ===
     179=== iRODS client ===
     180  - Installed in /opt/irods
     181  - Version 3.1 downloaded from https://www.irods.org/download.html
     182  - Config file installed in each users home directory
     183    - .irods/.irodsEnv
     184
     185=== Development Tools ===
    113186  - Emacs
    114187  - Screen
     
    116189  - Perl
    117190  - Git
     191  - SVN
    118192  - Expect
    119   - What else do experimenters need?  Eclipse?  Plugins?
    120 
    121 === iRODS client ===
    122   - Installed in /opt/irods
    123   - Version 3.1 downloaded from https://www.irods.org/download.html
    124   - Config file installed in each users home directory
    125     - .irods/.irodsEnv
     193
     194----
     195
     196== Packages Installed ==
     197 - python-m2crypto
     198 - g++
     199 - git
     200 - subversion
     201 - expect
     202 - vim
     203 - screen
     204 - emacs
     205 - openjdk-7-jre
     206 - icedtea-6-plugin
     207 - apache2
     208 - adobe-flashplugin
     209 - omf-expctl-5.4
    126210
    127211----
     
    134218
    135219  - Passphrases for SSH keys?
    136      - Can use ssh-agent for running scripts, using GUSH
     220     - Can use ssh-agent for running scripts
    137221  - Passphrases for protoGENI certificates?
    138222     - How to script using OMNI?
     
    142226     - GUSH suggests this to avoid some issues
    143227 
    144 ----
    145 
    146 == Where can I find the workspace? ==
    147   - Currently on a BBN internal server.  Will be moved to an external server in the near future.
    148     [Add link here]
    149 
    150   - OVF image coming soon
    151     [Add link here]
    152 
    153 ----
     228
     229----