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.

Note: Archibus V.26.1 does not support IBM WebSphere. (AD-5705)

Increase the Memory Assigned to WebSphere

1. Make sure that WebSphere is started.
2. Open IBM WebSphere console. 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 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. Open IBM WebSphere console.
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.

Make Configuration Changes in WebSphere

1. Create the folder C:\WebCentral-CXF and move (not copy) all the files in \archibus\WEB-INF\lib.
2. In Console → Environment → Shared Libraries:
   • Create a shared library called WebCentral-CXF. Enter full paths to the directory: C:\WebCentral-CXF.
3. Check "Use an isolated class loader for this shared library" option.
4. Click OK.
5. Click "Save directly to the master configuration."
6. 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.
7. Click OK.
8. Click OK.
9. Click "Save directly to the master configuration."
10. In Console → Applications → WebSphere enterprise applications → <your application> → Manage Modules:
    • Click <your application> in Module list.
    • In General Properties page, select “Classes loaded with local class loader first (parent last)” option for Class loader order.
    • Click OK.
    • Click OK.
11. Click "Save directly to the master configuration."
12. In the file system go to the folder …\archibus\WEB-INF\ and edit the file web.xml as follows:
    • Search for the http-only, delete the lines: <cookie-config><http-only>true</http-only></cookie-config>
    • In the top of the file in the tag web-app, locate web-app_3.0.xsd and change to web-app_2.5.xsd
    • In the top of the file in the tag web-app locate version=”3.0” and change to version=”2.5”
13. In the IBM console go to Security -> Global Security ->Programmatic session cookie configuration.
    • Delete the first one: Cookie name=JSESSIONID Cookie path = /.
    • Save changes.
14. Restart WebSphere.
15. Start archibus.

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.

Steps for Geocoding

If your site intends to take advantage of Archibus features for geocoding an address (such as illustrated in the Technologies / User Interface Add-ins/ Geographic Information System (GIS) view/ Map with Address Geocoder view), the signer might need to be added to the local trust store. You can use the "Retrieve from port" option in the administrative console to retrieve the certificate. Follow these steps to do so:

1. Log into the administrative console.
2. Expand Security and click SSL certificate and key management. Under Configuration settings, click Manage endpoint security configurations.
3. Select the appropriate outbound configuration to get to the (cell):win2k8r2stdNode01Cell:(node):win2k8r2stdNode01 management scope.
4. Under Related Items, click Key stores and certificates and click the NodeDefaultTrustStore key store.
5. Under Additional Properties, click Signer certificates and click Retrieve From Port.
6. In the Host field, enter www.arcgis.com in the host name field, enter 443 in the Port field, and null_cert in the Alias field.
7. Click Retrieve Signer Information.
8. Verify that the certificate information is for a certificate that you can trust.

Optional: Install the Archibus Help Systems (not supported in V.26.1 and beyond)

Note: Beginning with Archibus V.26.1, installing the help systems locally using an archibus_help_war file is not supported for the WebLogic server. Instead of the archibus_help_war file, we now provide a series of zip files that can be downloaded from Allbound or obtained from Professional Services. The below procedure applies to pre-V.26.1 Archibus, which supported then archibus_help_war file.

Accessing online help (either through the Help command or right-clicking on the 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/v25.4_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.

Some sites, however, wish users to access 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 extracting them from the the archibus_help_war file, available from SpaceIQ Allbound or Professional Services.

The following folders will be created:

• \archibus_help\system -- for System Management Help, which is always in English.
• \archibus_help\user_xx – where "xx" represents the language, such as \user_en for English and \user_de for Gerrnan.

Follow this procedure:

1. Copy the archibus_help_war into a 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.