Installation of Wildbook Framework is relatively simple, but it does involve installation of a web server, which many users may be unfamiliar with.
To run the framework, you will need a Windows, Mac or Linux laptop or desktop with the following software pre-installed:
Java SE 7
(a.k.a, “Java 1.7”). These are available from Oracle
. At a minimum, download and install the Java Runtime Environment (JRE); if you wish to develop Java programs, download and install the Java Development Kit (JDK), which includes the JRE. Don't forget to define JAVA_HOME as a system environment variable (settings its value to the file system path to Java on your computer) to allow Java-based applications to use your installed Java version.
Tomcat 7 and 8
, which is available from the Apache Software Foundation
. Download the “binary distribution” that is appropriate for your operating system (e.g., “64-bit Windows zip” for 64-bit Windows machines, or “zip” or “tar.gz” for Linux and Macintosh machines). Tomcat is a “servlet container” that can run Java-based applications under a web server. It can also act as a web server by itself. Jetty, older versions of Tomcat, and other J2EE containers/servers may work but have not been tested. Integration of Tomcat with third party web servers (e.g., Apache 2.2.x) is common, but this topic is well beyond the scope of these instructions. These sample instructions assume that Tomcat has been installed on your local laptop or desktop and is listening on port 8080.
Installing Tomcat is beyond the scope of this document, but it is very well documented on the web:
NOTE: Since somewhere around version 7.0.30+ (approximately), Tomcat includes a tomcat7-websockets.jar file that must be removed before Tomcat will load with Wildbook.
Known good configurations
Windows 7, Tomcat 7.0.47, Java 1.7.0_10 (development)
Windows 7, Tomcat 7.0.39, Java 1.7.0_45 (development)
CentOS 6.4, Tomcat 7.0.42, Java 1.7.0_45 (production)
Red Hat 4.1.2-48, Tomcat 6.0.32, Java 1.7.0_45 (production)
Ubuntu 12.04 LTS 64-bit, Tomcat 7.0.50, Java 1.7.0_45-b18. Also required addition of“ Java Advanced Image (JAI) 1.1.3 (jai-1_1_3-lib-linux-amd64-jdk.bin) (development)
Deploying the WAR file
The Framework is downloaded and deployed as a web application archive file (.WAR) in Tomcat. To install this file:
- Using your web browser, download the latest available WAR file (wildbook-XXXXX.war) from the downloads page. For example, version 4.1.0 of Wildbook is deployed through the war file ''wildbook-4.1.0-RELEASE.war''.
- Place the WAR file in the "webapps" folder of Tomcat. For example, if your WAR file is named "wildbook-4.0.3-RELEASE.war":
If Tomcat is not running, the WAR file will be expanded when Tomcat starts in the steps below.
- If you installed Tomcat to "C:\Program Files\Apache Software Foundation\Tomcat" on Windows, then you would place the WAR file in the folder "C:\Program Files\Apache Software Foundation\Tomcat\webapps". The folder "C:\Program Files\Apache Software Foundation\Tomcat\webapps\wildbook-4.1.0-RELEASE" will be created when Tomcat 0-RELEASE.war /Library/Tomcat/webapps" in a Terminal window.
- Open a web browser to the following address:
http://localhost:8080/wildbook-XXXXX For example, if your WAR file is named "wildbook-4.1.0-RELEASE", then the URL to use is
http://localhost:8080/wildbook-4.1.0-RELEASE/.A default landing page for Wildbook Framework is displayed. This steps assumes a basic Tomcat installation on a laptop or desk top (i.e., not a web server) with Tomcat assigned to use its default port 8080. If you are using Tomcat on a web server or assigned it to a different port, you will need to specify that port and use the appropriate URL . Further configuration of the framework is also required to support non-localhost URLs and ports.
- Log into the framework using the default 'tomcat' user ID and 'tomcat123' password.
Wildbook Framework is now ready for use. Keep in mind that Tomcat must be running to enable access to the Framework through your Web browser. If Tomcat is stopped, or your computer is rebooted, Tomcat must be restarted as described above.