Installing ARCHIBUS Web Central with IBM WebSphere

This topic covers details specific to installing ARCHIBUS Web Central on the IBM WebSphere application server. The text presumes you are familiar with this application server.

Install the Web Application

  1. Make sure that WebSphere is started.
  2. Open the administrative console using the URL http://localhost:9090/admin/. Unless you have established your own conventions, you can log on as any user, as security is not turned on by default.
  3. Open "Applications" from the left menu
  4. Click on "Install New Application."
  5. Choose "Local Path" if the WAR file is on the machine where you are using the console. Enter "/archibus" for the "Context Root." Choose "Next."
  6. On the second screen, leave the defaults and choose "Next."
  7. If you receive an "Application Security Warnings" screen, choose "Continue." Instructions for configuring security are below.
  8. On the fourth screen change the "Application Name" field from archibus_war to archibus. (This change is not essential, but the result is neater.). Choose "Next" to proceed.
  9. On the fifth screen put a checkbox next to ARCHIBUS Web Central and choose "Next."
  10. On the sixth screen put a checkbox next to ARCHIBUS Web Central and choose "Next."
  11. On the seventh screen choose "Finish."
  12. After the installation completes, choose "Save to Master Configuration."
  13. On the Save screen, choose "Save" to save the change to the master configuration.

Configure ARCHIBUS Web Central

  1. Copy your ai-licenses.bin file to your config folder: C:\Program Files\WebSphere\AppServer\installedApps\<ServerName>\archibus.ear\archibus.war\WEB-INF\config.
  2. Update your WEB-INF\config\context\compatibility\afm-config.xml file values per the standard instructions.
  3. Update your project database connections in afm-projects.xml per the standard instructions.
  4. Configure WebSphere to use a parser version required by ARCHIBUS Web Central.

The WebSphere server ships with older versions of JARs than that required by ARCHIBUS Web Central. You must install the JARs versions required by ARCHIBUS Web Central. To do so, create an endorsed folder in \jre\lib, and copy xalan.jar, xercesImpl.jar, log4j-<version>.jar from the WebCentral lib folder to this location.

If you have a Windows server and wish to use the Sybase Runtime server for demonstration or testing of your configuration  copy the JDBC-ODBC bridge file dbjodbc9.dll from \webapps\archibus\WEB-INF\lib to <websphere_home>\bin.

Configure Security

Java 2 Security Warning

If you encounter a security warning when installing ARCHIBUS or when starting the ARCHIBUS Web Central application on the ARCHIBUS Login page, you may have Java 2 Security enforced. This is not a requirement for most sites, but it is the default for some of the development versions of WebSphere.

To eliminate this error, take these steps:

  1. Access the console using the URL http://localhost:9090/admin/
  2. Plus-open "Security" on the left Panel, click on Global Security.
  3. On the right panel, uncheck the "Enforce Java 2 Security" option.
  4. Click "Apply" then "OK" at the bottom of the page.
  5. Click the "Save" button on top of the page to save to master configuration.
  6. Restart the server.

Configuring Web Groups

If you are using WebSphere 6.0 and encounter the "SRVE0017W: Web Group not found: /archibus/index.htm)" error, take these steps.

  1. Access the console using the URL http://localhost:9090/admin/
  2. Plus-open "Applications." On the left panel, click "Enterprise Applications."
  3. On the right panel, you will see a list of installed application. Make sure the "archibus" application is started with a green icon. If not, then check the box and click the "start" button.
  4. Click the "Save" button on top of the page to save to master configuration.
  5. Restart the server.

Install the ARCHIBUS Help Systems

To install the help systems:

  1. Use WinZip or another archive utility to expand \help\archibus-help.zip (located on the product DVD) into a temporary directory, preserving all subfolders.

    The expansion process will create a series of folders, such as:

    \webapps\archibus\schema\ab-system\help\archibus_fm_help\

    \webapps\archibus\schema\ab-system\help\system-management\

  2. From the temporary location, copy the \help\archibus_fm_help\ and \help\system-management\ directories to the\webapps\archibus\schema\ab-system directory on your system.
  3. There is no need to stop the application server if it is already running.

Configure the Basic Rule Wizard for Java 6

Application servers that use Java 6, such as IBM WebSphere 7, require a Java 6 -compatible version of the Basic Rules Compiler. For information, see Installing the Basic Rule Compiler on Java 6 Web Servers.