Installation¶

Download the latest stable release and unpack it:

# Set latest release as of writing this
LATEST="0.3.0"

# 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}

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"
```
Configure the nginx_stage installation by modifying the YAML configuration file located at:
```
/etc/ood/config/nginx_stage.yml
```
On a fresh installation you may need to create this file or copy the default file from:
```
/opt/ood/nginx_stage/share/nginx_stage_example.yml
```
You can read Configuration for details on configuration options.

Note

In most cases it isn’t necessary to modify the configuration file as the defaults were chosen to work best with most centers.
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.

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