Installing ARCHIBUS Web Central with Apache Tomcat

This section covers details specific to the Apache Tomcat application server.

Installing ARCHIBUS with Tomcat

The most straightforward way of installing ARCHIBUS with Apache Tomcat is to expand the files into the webapps folder directly.

  1. Use WinZip or other archive utility to open archibus.WAR.
  2. Expand this archive into a new the webapps\archibus folder, preserving subfolders as you do so. The expansion process will create a series of folders, such as:
    webapps\archibus\WEB-INF
    webapps\archibus\projects
    webapps\archibus\schema
    ...
  3. Copy your ai-licenses.bin to the webapps\archibus\WEB-INF\config folder.
  4. Verify that your database server is started, then start the Tomcat application server.

Alternately, you can copy the archibus.WAR to your webapps folder, start Tomcat to have the application server expand the .WAR file, copy the ai-licenses.bin file to the webapps\archibus\WEB-INF\config folder, then restart Tomcat.

Once Tomcat is started you can right-click on the icon in the System Tray and use the Open Console Monitor and Shutdown selections at need. When you see the Configuration Manager listing ARCHIBUS messages, the ARCHIBUS application is loading.

Apache Tomcat 7

If you are using Tomcat 7, add this line to Tomcat7/conf/context.xml:

<Context useHttpOnly="false">

This setting eliminates a CSRF error on startup. By default, Tomcat 7 disallows session cookies in JavaScript, a feature required by the DWR subsystem used by ARCHIBUS. DWR does its own check against CSRF, so this change is safe. Sites wishing more security against session spoofing and cross-site scripting should use HTTPS, which is compatible with Web Central.

Other Tomcat Options

Using the Windows Service Manager

You can use the Windows service manager to start and stop Tomcat. This makes restarts easier.

The service manager also gives you the option of having Tomcat restart the application server (and there by restart ARCHIBUS Web Central) or even restart the computer should it encounter an error.

The service manager also gives you the option of specifying startup dependencies -- such as a dependency on the database service, which must be running.

See also the following web site.

http://jakarta.apache.org/commons/daemon/procrun.html

Configuring ARCHIBUS

For other configuration settings, such as settings for connecting to your email server or for security, please see Configuration Options.