Follow the steps below to install and configure PrizmDoc® for Java using a distributed deployment model where PrizmDoc® for Java will reside on a different Application Server than ICN.

The PrizmDoc® for Java web application is delivered as a ZIP archive. The zip archive must be reviewed and modified by the target environment user to manage and manipulate the configuration of the web application before and during deployment to the target server.

Deploying the PrizmDoc® for Java web application

NOTE: If PrizmDoc® for Java will be deployed on a different WebSphere instance than ICN, follow the Deployment instructions for WebSphere noted in the previous section that covers a Single Server Installation. For any other Application Server type, follow the instructions below.

  1. Copy the virtualviewer.war file to a location accessible to the application server.

  2. Deploy the virtualviewer.war application following standard application deployment practices for the Application Server being utilized.

Configuring the PrizmDoc® for Java web application

Access the file system where PrizmDoc® for Java was deployed and perform the following configuration changes:

P8ContentHandler.properties

Update the P8ContentHandler.properties file located at /virtualviewer/WEB-INF/classes, following the instructions within the file to set the following properties:

  1. CEUri - To locate your CEUri, follow the instructions in the section Where do I find my CEUri?.

  2. JaasStanza - To learn more about IBM’s available JaasStanza values, and which to use visit: https://www.ibm.com/support/knowledgecenter/SSNW2F_5.5.0/com.ibm.p8.ce.dev.ce.doc/sec_concepts.htm

  3. Admin ID and Password – Both of which are optional

  • The PrizmDoc® for Java P8ContentHandler can complete all required tasks to configure P8 to utilize Annotations within PrizmDoc® for Java. To accomplish this, please provide an Admin ID that has been granted appropriate permissions to create a subclass of the Annotations class, as well as the ability to create a custom property. This ID can be removed once the Annotations configuration is complete. To learn more about PrizmDoc® for Java Annotations, please read the section titled “PrizmDoc® for Java Annotations Support”.

web.xml

Update the path for the “tmpDir” parameter to your desired location if it varies from the default value:

  1. \<param-name\>tmpDir\</param-name\>

  2. \<param-value\>/opt/IBM/P8/sbtmp\</param-value\>

Content Engine Web Service (CEWS)

PrizmDoc® for Java utilizes IBM’s Content Engine Web Service (CEWS) Transport for deployments outside of WebSphere. The IBM Knowledge Center provides instructions for setting up a Thin Client Application that requires CEWS. You can find the instructions on IBM’s website.

PrizmDoc® for Java has preloaded the commonly required JAR files as well as the WcmApiConfig.properties file. Please follow the instructions provided by IBM to ensure that everything is in place and configured correctly for your environment.

WcmApiConfig.properties

The WcmApiConfig.properties file requires updates to reflect the appropriate URL for your CE within the RemoteServerURL, RemoteServerUploadURL and RemoteServerDownloadURL properties.

In addition, ensure that the CryptoKeyFile/UserToken path is correct and that the jaasConfigurationName=FileNetP8WSI.

The WcmApiConfig.properties is located at /virtualviewer/WEB-INF/classes.

config.js

The config.js file, located in /virtualviewer/user-config can be updated to customize the functionality of PrizmDoc® for Java.

If any customizations are required, perform them now. Definitions of the parameters in the config.js file can be found in PrizmDoc® for Java configuration.

SnowboundVirtualViewerPlugin.jar

Copy the SnowboundVirtualViewerPlugin.jar into the ICN Plugins Directory and configure the PrizmDoc® for Java Plugin. Instructions for this step can be found in Installing the PrizmDoc® for Java ICN Connector.

Restart the application

Stop and restart the virtualviewer_war application in the WebSphere Management Console.