Developing on apps test.awesim.org

1. Dev host is now apps-test.awesim.org

All development should occur on apps-test.awesim.org. Access 2 ways:

ssh oakley.osc.edu and then from an Oakley login node ssh apps-test.awesim.org
from the dashboard at apps-test.awesim.org, go to "My Sandbox Apps" or My Shared Apps" and click the "Shell" button next to an app to open the web based shell to that directory

2. Environment setup: use software collections (scl)

Run this command to start bash with the software packages available:

efranz@webtest04:~$ scl enable rh-ruby22 nodejs010 git19 v8314 python27 -- bash
efranz@webtest04:~$ which ruby
/opt/rh/rh-ruby22/root/usr/bin/ruby
efranz@webtest04:~$
efranz@webtest04:~$ ruby --version
ruby 2.2.2p95 (2015-04-13 revision 50295) [x86_64-linux-gnu]

Or add this to your .bash_profile:

if [[ ${HOSTNAME%%.*} == webtest04* ]]
then
  scl enable rh-ruby22 nodejs010 git19 v8314 python27 -- bash
fi

Note that we now use Ruby 2.2.2 (instead of Ruby 2.0.0).

3. Install gems of an app in `vendor/bundle`

Gems are no longer system installed. All the gems your app requires should be installed with the app by running:

bin/bundle install --path vendor/bundle

This will install all the gems from GitHub or rubygems.org into $APPROOT/vendor/bundle

4. Dev apps are at ~/awesim/dev and shared apps are at ~/awesim/share

Dev apps are any directory under ~/awesim/dev. You don't need to name the directories "rails#" anymore.

5. Access https://apps-test.awesim.org for accessing and testing apps

Use this until apps.awesim.org is switched over

6. The web hosts are isolated from the clusters

The web hosts have access to project space and the user home directories, but not to software installed on Oakley or Ruby or access to the module system.

7. Accessing production log files.

Log files are located at /var/log/nginx/<user> on the appropriate host.

Both the stdout and stderr from the app process are piped to error.log.