Installation

1. Download the latest stable release and unpack it:

   # Set latest release as of writing this
   LATEST="0.2.1"
   
   # Download latest release
   wget --content-disposition https://github.com/OSC/nginx_stage/archive/v${LATEST}.tar.gz
   
   # Unpack this archive
   tar xzvf nginx_stage-${LATEST}.tar.gz
   
   # Change working directory
   cd nginx_stage-${LATEST}
   

2. Install this package in default PREFIX=/opt/ood/nginx_stage location:

   sudo scl enable rh-ruby22 -- rake install
   

   Note

   The location of the installation can be changed by altering the PREFIX environment variable:

   sudo scl enable rh-ruby22 -- rake install PREFIX="/tmp/nginx_stage"
   

3. Configure the nginx_stage installation by modifying:

   /opt/ood/nginx_stage/config/nginx_stage.yml
   

   You can read Configuration for details on configuration options.

4. Confirm that the Apache proxy is running as the user apache. By default nginx_stage will only give permissions to the apache user to access the NGINX Unix domain socket files.

5. Give the Apache proxy user apache elevated privileges when running nginx_stage by adding a sudo entry as:

   # /etc/sudoers.d/ood
   
   Defaults:apache     !requiretty, !authenticate
   apache ALL=(ALL) NOPASSWD: /opt/ood/nginx_stage/sbin/nginx_stage