Deployment

OS:

Ubuntu 12.04 LTS

OS Dependencies:

• Apache 2 (it has been qa'd with 2.2.22, but it's only being used to proxy HTTP, so I doubt it's really important)
• Node JS 0.10.24 or later (no 0.11 though, odd releases are considered unstable in nodejs-land)
• npm 1.3 or later

Setup of the application:

Structure

The code lives at /opt/libraries-gateway and can be cloned from [1].

Dependencies

Run npm install under /opt/libraries-gateway

HTTP / Proxying

Apache handles all static assets under /public and proxies all other requests to the node webserver which runs on port 5000 (by default). An example config can be found at [2].

Logging

The node process will log to /opt/libraries-gateway/server.log by default. This can be changed in /opt/libraries-gateway/config.js if desired. We’re using bunyan [3] which has a couple of built-in logging capabilities:

• standard out
• file on disk (be it rotating or not)
• syslog [4]
• logstash [5]
• ..

Links

• [1] https://github.com/CUL-DigitalServices/libraries-gateway
• [2] https://github.com/CUL-DigitalServices/libraries-gateway/blob/master/apache/000-default
• [3] https://github.com/trentm/node-bunyan
• [4] https://github.com/mcavage/node-bunyan-syslog
• [5] https://github.com/sheknows/bunyan-logstash