Open OnDemand Apps Installer

A utility that downloads and installs the latest stable releases of the Open OnDemand system web applications. The following web applications are installed:

• Dashboard App
• Shell App
• Files App
• File Editor App
• Active Jobs App
• My Jobs App

Installation

From the command line you will clone down this project to a working directory:

scl enable git19 -- git clone https://github.com/OSC/ood-apps-installer.git apps

Go into this working directory:

cd apps

And then check out the latest stable release:

scl enable git19 -- git checkout v1.0.0

Usage

First you will want to build the Open OnDemand web applications in a build directory:

scl enable rh-ruby22 nodejs010 git19 -- rake

This will build all the web applications in the build/ directory. You can parallelize this process with:

scl enable rh-ruby22 nodejs010 git19 -- rake -mj [NUMBER]

where NUMBER is the number of apps to build in parallel.

Note: You can add a default SSH host for the Shell App here by creating the file:

build/shell/.env

with the following contents:

DEFAULT_SSHHOST="cluster.my_center.edu"

After a successful build and any modifications to the apps you make, you will then want to install the apps to their system location at /var/www/ood/apps/sys with:

sudo scl enable rh-ruby22 -- rake install

To install the apps in a different location you'd specify it through the PREFIX environment variable as such:

sudo scl enable rh-ruby22 -- rake install PREFIX=/path/to/install/apps

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/OSC/ood-apps-installer.