ubuntu-nginx-lucee

A set of bash scripts for standing up a Lucee server using nginx and Tomcat on Ubuntu. Uses the Tomcat from the Ubuntu distribution so you can update Tomcat using apt-get update tomcat7

Important: The master branch is now using Lucee 5, for Lucee 4.5 see the lucee45-ubuntu14 branch.

Why would I use this instead of the offical Lucee installers?

• You want to run nginx as your web server
• You want to update Tomcat via apt-get

What does it do?

1. Updates Ubuntu - simply runs apt-get update and apt-get upgrade
2. Downloads Lucee - uses curl to download lucee jars from BitBucket places jars in /opt/lucee/current/
3. Installs & Configures Tomcat 7 - runs apt-get install tomcat7 updates the web.xml server.xml and catalina.properties to configure Lucee servlets and mod_cfml Valve.
4. Installs Oracle JVM - if you downloaded a server-jre and specified its path in the config it will extract it under /opt/lucee/jvm/version and then create a symbolic link /opt/lucee/jvm/current to denote the current jvm version to use. It also edits tomcat config to point to this jvm.
5. Installs & Configures nginx - runs apt-get install nginx to install nginx. Crates a web root directory. Creates a lucee.config file so you can just include lucee.config for any site that uses CFML

Take a look in the scripts/ subfolder to see the script for each step.

How do I run it?

1. Download Oracle JVM - Vist java.oracle.com to download the latest server-jre
2. Downlaod this repository - curl -Lo /root/ubuntu-nginx-lucee.tar.gz https://api.github.com/repos/foundeo/ubuntu-nginx-lucee/tarball/master
3. Extract repository - tar -xzvf /root/ubuntu-nginx-lucee.tar.gz
4. Edit the install.sh - Change any configuration options such as the Lucee Version or JVM version.
5. Copy jvm - make sure the jvm you downloaded from oracle is located in the folder that contains install.sh, eg /root/foundeo-ubuntu-nginx-lucee-abcdefg/
6. Run install.sh - make sure you are root or sudo and run ./install.sh you may need to chmod u+x install.sh to give execute permissions to the script.
7. Set Lucee Passwords - login to /lucee/admin/server.cfm and set the server password, and also set the default web context password.

Limitations / Known Issues

• The servlet definitions and mappings (located in /etc/tomcat7/web.xml) are slimmed down, so if you need things like REST web services, flash/flex remoting support see the Railo docs for web.xml config
• The /lucee/ uri is blocked in /etc/nginx/lucee.conf you must add in your ip address and restart nginx.
• There is no uninstall option
• This script has been tested on Ubuntu 14.04 LTS only

Setting up a Virtual Host

By default nginx on Ubuntu looks in the folder /etc/nginx/sites-enabled/ for configuration nginx files. To setup a site create a file in that folder (another technique you can use is to create the file in /etc/nginx/sites-avaliable/ and then create a symbolic link in sites-enabled to enable the site), for example /etc/nginx/sites-enabled/me.example.com.conf at a minimum it will look like this:

server {
	listen 80;
	server_name me.example.com;
	root /web/me.example.com/wwwroot/;
	include lucee.conf;
}

You may also want to break logging for this site out into its own file, like this:

server {
	listen 80;
	server_name me.example.com;
	root /web/me.example.com/wwwroot/;
	access_log /var/log/nginx/me.example.com.access.log;
	error_log /var/log/nginx/me.example.com.error.log;
	include lucee.conf;
}

If you don't need Lucee/CFML for a given site, simply omit the include lucee.conf; line, like this:

server {
	listen 80;
	server_name img.example.com;
	root /web/img.example.com/wwwroot/;
}

After making changes you need to restart or reload nginx:

sudo service nginx restart

For more information on configuring nginx see the nginx Wiki

Thanks go to Booking Boss for funding the initial work on this script.