Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Zuul requires a java servlet container. For this document, I'll assume you're using Tomcat.
As of Zuul 1.5, a JSP 2.2 or higher container is required (such as Tomcat 7). See issue #46 for details.
- 1.5 Release - 4/19/2014
- 1.4 Release - 1/23/2012
- 1.3 Release - 1/6/2012
- 1.2 Release - 12/17/2012
- 1.1 Release - 11/29/2012
- 1.0 Release - 10/25/2012
- Remember to backup your existing installation
- Zuul web context
- Stop your server
- Unzip the .war archive to your application server.
- example: $TOMCAT_HOME/webapps/zuul
- Copy the config files located in WEB-INF/classes/examples somewhere into the server's classpath.
- example: $TOMCAT_HOME/lib
- make the appropriate changes to match your environment
- Start the server
- Access the application http://servername:8080/zuul
In step #2 above, you copied the sample config files into your server's classpath. The zuul-data-config.propeties file contains the database related settings.
By default, it will start up with an embedded database for evaluation purposes. This database will be reset between server restarts so you will need to configure a more permanent location for your data.
- Copy your database driver jar into the server's classpath. e.g.: $TOMCAT_HOME/lib
- it comes with drivers for H2 if you're using it in TCP mode
- Edit zuul-data-config.properties
- Modify the jdbc.zuul.* settings (see comments inside the file)
- Restart your server
Zuul needs to have admin access to the database upon startup in order to create the tables. You can demote its access to read/write after the initial deployment.
Zuul can send out notifications via email. For instance, users can request elevated permissions from the administrators. In order for this functionality to work, the SMTP server will need to be configured.
- Edit the zuul-data-config.properties
- Modify the smtp.* settings
Unfortunately, the JVM does not support strong encryption algorithms by default. You'll need to download and install the Unlimited Strength JCE Policy Files. Simply unzip the jars and place them in your JAVA_HOME/jre/lib/security directory.
OpenID Single Sign On is enabled by default. LDAP authentication is also supported. See the Security Page for more details.