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

Optional: Install the Online Help Systems

Accessing online help from Web Central (either through the Help command or right-clicking on the Process Navigator) automatically brings you to the latest help systems that are stored on www.archibus.com.

Since these help systems are continually updated, accessing online help from these locations ensures that you are working with the very latest help release from ARCHIBUS, Inc.

However, some sites wish to have users access the online help from the company's network. In this case, you can install the help systems on your network by obtaining them from the ARCHIBUS DVD. Follow this procedure:

1. On the DVD, locate \help\archibus-help.zip.
2. Use WinZip or another archive utility to expand the zip into a temporary directory, preserving all subfolders.

3. The expansion process will create a series of folders:

   • system (for System Management Help)

   • user (for ARCHIBUS Help)

4. Create an “archibus_help” folder in \tomcat\webapps\.

5. Expand this archive into a new the \webapps\archibus_help folder, preserving subfolders as you do so.

6. Restart tomcat.

Accessing the locally installed help systems

There are a few ways to access the locally installed help systems.

• After Web Central starts, enter the following URLs to start the ARCHIBUS Help systems.

  • ARCHIBUS Help: http://localhost:9080/archibus/help/user/archibus.htm
  • ARCHIBUS System Management Help: http://localhost:9080/archibus/help/system/afm-sysman.htm
• If you want the local help to appear when you select Web Central's Help command or the right-click Help menu from the Process Navigator, you must edit the WEBINF\Config\help.properties file and assign the new URL to Help.url.
• Clicking Help link on a Smart Client that is pointed to the Tomcat application server will also access this Help.

Note: You can follow the same procedure for localized versions of ARCHIBUS Help. The only difference is that you add the abbreviation for the locale to the "user" folder in the URL, such as http://localhost:9080/archibus/help/user_it/archibus.htm for the Italian version of ARCHIBUS Help. Localized versions of System Management Help are not available.

Configuring ARCHIBUS

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