wiki:instance_rodeo

Version 2 (modified by ehb, 3 months ago) (diff)

--

SGCI Rodeo Instructions

PRELIMINARY COPY OF ATOMSPHERE INSTRUCTIONS... NEEDS EDITING/TESTING

A prepared instance for GenApp is available for TACC/RODEO's through an arrangement with SGCI through their hosting service.

Prerequisites

To utilize this, you must have an active XSEDE allocation on Jetstream. Getting Started with XSEDE.

If you are unfamiliar with Jetstream's Atmosphere, you will likely need to gain familiarity with how to launch and connect to an instance.

In particular, you will need to add your public ssh key to User->settings->Advanced->SSH Configuration

Rodeo Image

  • GenApp Ubuntu 16_04 Dev Docker (current version 1.0-alpha)

!GenApp Rodeo Launch

Setting up

  1. Login with your credentials
    • ssh xsede-username@ip-address-from-atmosphere-instance
      • where xsede-username is replaced by your XSEDE user name
      • and ip-address-from-atmosphere-instance is the ip address for this instance reported from Atmosphere after the instance has gone "Active"
  2. Update the operating system
    • sudo apt-get update && sudo apt-get dist-upgrade
    • if instructed, reboot the system and go back to step 1.
  3. Add your user to the "genapp" group
    • $ sudo usermod -a -G genapp xsede-username
      • where xsede-username is replaced by your XSEDE user name
  4. Logout and login again
  5. update to the latest version of GenApp
    • $ svn update /src/genapp
  6. Set the configuration for your instance
    • $ $GENAPP/sbin/setconfig.pl -f -pj
      • The created $GENAPP/etc/config.json can also be manually edited
      • $ $GENAPP/sbin/setconfig -h will list options available for advanced usage
  7. Reconfigure your system
    • $ $GENAPP/sbin/reconfig
  • The VM instance should now be ready to use.
  • You should next follow post install steps outlined here.
    • note that the postfix mail server is already setup and running, but you will need to add proper values to each application's appconfig.json manually if you wish to use the "admin" and "feedback" systems.
    • e.g. add or edit this block in appconfig.json, replacing the key values appropriately:
          "mail"     : {
      	"admin"    : "someadmin@some.ip"
      	,"feedback" : "somefeedbackadress@some.ip"
      	,"from"     : "the.host.name"
          }
      
      • in a future update, we will work to simplify the email setup

Security

Attachments (2)

Download all attachments as: .zip