IOOS:QuickInstall

From Grid-Appliance Wiki

Jump to: navigation, search

Contents

Install Virtual Machine

  1. For Windows and Linux: Download and install VMware Player
    1. You can alternatively use VMware Server, which is also free and has additional management features. The adcantage of Player is it's simpler to install and a smaller download.
    2. For MacOS users, you can install VMware Fusion or VirtualBox.
      1. VMware Fusion has a 30-day free trial period, but unlike VMware Player, this software is not free
      2. VirtualBox is free.

Download and run the IOOS appliance

  1. Download the Grid Appliance for VMware from this link and place the ga2_ioos.zip file in your desktop.
    1. Note: the rest of this tutorial assumes a version of the Grid Appliance downloaded on Oct 20th 2008 or later.
  2. Extract the ga2.zip file. A directory named "grid_appliance" will be created in your desktop.
  3. Send an email request to Pierre St Juste at ptony82@ufl.edu to obtain IOOS-specific floppy images (all configurations for the virtual machines are stored on floppy images, so floppy images for the IOOS project have to be acquired before running the virtual appliance)
  4. You will receive a zip package ioos_fd.zip containing virtual floppies by email
  5. Once you've obtained the file ioos_fd.zip, copy it to your desktop and unzip it
  6. The file contains three floppy images (Server.img, Client.img, Worker.img). For a default client configuration, you will need to replace the file "fdb.img" in the grid_appliance directory. This can be done as follows.
    1. Delete the file named "fdb.img" in the "grid_appliance" directory
    2. Drag the file "Client.img" you just extracted to the "grid_appliance" directory
    3. Rename "Client.img" to "fdb.img"
  7. Start the virtual machine
    1. For VMware in Windows, browse to the grid_appliance directory and double-click on GridAppliance.vmx
    2. For VMware in Linux, cd to the extracted directory. Then type "vmplayer GridAppliance.vmx" if you are using VMware player, or type "vmware GridAppliance.vmx" if you are using VMware server.
    3. For VirtualBox, please follow this tutorial to learn how to start up the VM

Register your virtual address

  1. Once your appliance finishes booting up, you will see a X11 window user interface running in it.
  2. We will need to know the virtual IP address of your appliance. You can find this information as follows:
    1. Click on a terminal window within the appliance
    2. Type the following command: 
/sbin/ifconfig tapipop|grep "inet addr"
  1. Email the 4-digit IP number that is shown to the left (of the kind 5.xxx.yyy.zzz) to ptony82@ufl.edu
    1. If no number shows up, wait a few minutes and try again - this address can take several seconds to be properly configured

Mount the IOOS data share

  1. Once you submit your IP address, wait for a confirmation email from us
  2. Once you receive this confirmation, type the following commands to mount the IOOS testbed data repository (you will be prompted for your password - the default password is password, you can change that with the command 'passwd'): 
sudo wget http://www.grid-appliance.org/files/ioos/ioos_patch.tgz
sudo tar -xzf ioos_patch.tgz
sudo ./ioos_nfs_install.sh
  1. You will be able to see the following directories in your appliance: 
/home/data/UF
/home/data/UNC
/home/data/USF
/home/data/NCSU
  1. The directory corresponding to your institution will be available for both reading and writing, while the directories for the other institutions will be read-only. You can place files that you will like to make available to the rest of the testbed on your institution's directory.

Transferring files to the IOOS data share

There are two main ways of transferring files to the IOOS share. These are highlighted in the Grid appliance tutorial (scroll down to the section on transferring files). Below is a summary specific to the IOOS setup:

  • Secure FTP (sftp)
    • Linux hosts: you can use the command-line: sftp griduser@aaa.bbb.ccc.ddd, where aaa.bbb.ccc.ddd is the address shown on the top left white window within the Grid appliance. As explained above, the default password is password. Then, cd to the directory of your institution (e.g. /home/data/NCSU) and put the files you want to upload.
    • Windows hosts: you can use a free sftp client (e.g. Putty) to transfer files over sftp. The server address you should use is the numeric address (of the form aaa.bbb.ccc.ddd) shown on the top left white window within the Grid appliance. The user name is griduser. As explained above, the default password is password. Once logged in, change the directory to the directory of your institution (e.g. /home/data/NCSU) and drag the files you want to upload.
  • Samba
    • Windows hosts: follow the instructions from the Grid appliance tutorial to open a window where you can drag-and-drop files into the appliance. These files will be placed under /home/griduser by default; you will need top copy or move them to /home/data/(your institution) within the appliance, with Unix commands like 'cp' or 'tar'
Retrieved from "http://www.grid-appliance.org/wiki/index.php/IOOS:QuickInstall"
Personal tools