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.

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.

Additional Steps for WebSphere 6.1 and 7

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.

Additional Steps for WebSphere 7

1. Copy XmlSchema-1.4.5.jar from ../archibus/WEB-INF/lib to :\\IBM\WebSphere\AppServer\java\jre\lib\endorsed
2. Increase the memory assigned to WebSphere (for instance: -Xms256m –Xmx512m). To do so:

• Open Servers > Server Types > WebSphere Application Servers > server1 > Java and Process Management > Process Definition > Java Virtual Machine.
• Modify the fields 'Initial Heap Size' to 256 and 'Maximum Heap Size' to 512, or more as appropriate.

Additional Steps for WebSphere 8

In order to prevent CSRF error from appearing when using WebSphere8:

1. Open the WebSphere console and navigate to: Servers->Server types->Websphere Application Server->Server 1->Web Container->Session Management
2. Click on the “Enable Cookies” link.
3. In General Properties, uncheck “Set session cookies to HTTP Only to prevent cross-site scripting attacks.” Un-checking this prevents the CSRF Security Error from appearing.
4. Click "Apply" and "Save."

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.

Optional: Install the ARCHIBUS 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. From the DVD, copy archibus_help.WAR into temp folder.
2. Make sure that WebSphere is started.
3. Open the administrative console using the URL http://localhost:9090/admin/.
4. Open "WebSphere enterprise applications" from the left menu.
5. Click Install.
6. Choose "Local Path" if the WAR file is on the machine where you are using the console, and browse to the WAR file location. Choose Next.
7. Enter //Archibus/help for the "Context Root." Choose Next.
8. On the next screen, leave the defaults, and choose "Next."
9. On the next screen, change the "Application Name" field from Archibus_help_war to help. Choose Next to proceed.
10. On the next screen, put a checkbox next to “help” and choose Next.
    
11. On the next screen, put a checkbox next to “help” and choose Next.
12. On the next screen, choose Finish.
13. After the installation completes, choose "Save to Master Configuration."
14. On the Save screen, choose Save to save the change to the master configuration.
    
15. In the Enterprise Applications window, check the box for “help” and choose “Start Application.”

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. You may wish to set up a shortcuts for these.
  • 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 WebSphere 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 ARCHIBUS System Management Help are not available.

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.