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.

Increase the Memory Assigned to WebSphere

1. Make sure that WebSphere is started.
2. Open the administrative console using the URL: http://localhost:9060/admin/. Unless you have established your own conventions, you can log on as any user, as security is not turned on by default.
3.  Increase memory assigned to WebSphere:
   • Open Servers > Server Types > WebSphere Application Servers > server1 > Java and Process Management > Process Definition > Java Virtual Machine.
   • Modify fields:
     • “Initial Heap Size” to 1200
     • “Maximum Heap Size” to 2400, or more as appropriate.

4. Click "OK".
5. Click "Save directly to the master configuration."
6. Restart WebSphere.

Install the Web Application

1. Open Console->Applications->New Application->New Enterprise Application.

2. Choose "Local file system" if the WAR file is on the machine where you are using the console. Click “Next”.

3. Choose “Fast Path”. Click “Next”.

4. Change the "Application Name" field from archibus_war to archibus (this change is not essential, but the result is neater). Click "Next".
5. Check the checkbox next to “ARCHIBUS Web Central” and click "Next."
6. Check the checkbox next to “ARCHIBUS Web Central” and click "Next."
7. Enter /archibus as "Context Root". Click "Next."
8. Click "Finish".
9. After the installation completes, click "Save directly to the master configuration."

Configure ARCHIBUS Web Central

1. Copy your ai-licenses.bin file to your config folder: C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\<ComputerName>Node01Cell\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.

Configuration Changes for WebSphere 8

1. Copy the jaxen-<…>.jar file from \archibus\runtime-lib to \archibus\WEB-INF\lib.
2. Create the folder C:\WebCentral-CXF and move (not copy) from \archibus\WEB-INF\lib the following files:
   • neethi-<version>.jar
   • xmlschema-core-<version>.jar
3. In Console → Environment → Shared Libraries:
   • Create a shared library called WebCentral-CXF. Enter full paths to the directory: C:\WebCentral-CXF.
4. Check "Use an isolated class loader for this shared library" option.
5. Click "OK".
6. Click "Save directly to the master configuration."
7. In Console → Applications → WebSphere enterprise applications → <your application> → Shared library references:
   • Check the WAR module.
   • Click "Reference Shared Libraries."
   • Add the WebCentral-CXF library to the WAR module.
8. Click "OK".
9. Click "OK".
10. Click "Save directly to the master configuration."
11. Restart WebSphere.

Configure Security

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 OK.
5. Click "Save directly to the master configuration."
6. Restart WebSphere.

Optional: Install the ARCHIBUS Help Systems

Accessing online help (either through the Help command or right-clicking on the Process Navigator) automatically brings you to the latest help systems that are stored on the ARCHIBUS web site, such as, http://www.archibus.com/ai/abizfiles/v23_help/archibus_help/user_en/archibus.htm. Since the help systems on archibus.com 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 rather than from the ARCHIBUS web site. 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. Open Console->Applications->New Application->New Enterprise Application.

3. Choose "Local file system" if the WAR file is on the machine where you are using the console. Click “Next”.

4. Choose “Fast Path”. Click “Next”.

5. Change the "Application Name" field from Archibus_help_war to help. Click "Next".

6. Check the checkbox next to “help” and click "Next."

7. Check the checkbox next to “help” and click "Next."

8. Enter /Archibus/help as "Context Root". Click "Next."

9. Click "Finish".

10. After the installation completes, click "Save directly to the master configuration."

11. In Console->Applications-> WebSphere enterprise applications, check “help” and click “Start”.

For information on accessing and configuring the locally-installed help systems, see Installing the ARCHIBUS Help Systems Locally.