IBM Support

How to install the IBM FileNet P8 Case Foundation stand-alone Process Designer application on a Windows computer

Question & Answer


Question

What are the steps to install the stand-alone Process Designer application on a Windows computer?

Cause

Many browsers are starting to limit or prevent Java applets from running in the context of a web page.  Starting with IBM FileNet P8 Content Platform Engine 5.2.1 Fix Pack 7, the Process Engine Java based applications (Process Designer, Process Administrator, etc.) can be run using a new stand-alone Process Designer client application, which is not dependent on a browser.  The stand-alone Process Designer application is also available in IBM FileNet Content Platform Engine 5.5.x.

Answer

This document provide details on the installation of the stand-alone application.  For more details on the application, please review Technote 7049480.
The IBM FileNet Content Platform Engine 5.5.x Server installation package is used to install the stand-alone Process Designer tool. 

During the Content Platform Engine Server installation setup, you will be prompted for the "Process Designer JRE Directory" - this is the location on the local Windows computer that the stand-alone Process Designer application will set for the java run-time .  You can use the CPE local JRE (the default) or point to an existing JRE that is installed on the Windows host computer.

Your input will be entered into the cpetoolenv.bat file automatically.

image-20190820190608-1

IBM FileNet Content Platform Engine 5.2.1 Fix Pack 7+ Server:
The files to run the stand-alone Process Designer application are included with IBM FileNet Content Platform Engine 5.2.1 Fix Pack 7 server if the tools option was selected.

Configure the stand-alone Process Designer:
You will find the Windows batch files in the "tools/PE" directory, as seen highlighted in this screen shot:

If needed, edit the "cpetoolenv.bat" file to include a valid JRE as the "JAVA_HOME=" value.
The following screen shot is an example:

2. Open a Windows command prompt in the "PE" directory and run the pedesigner.bat file to start the Process Designer stand-alone application.

NOTE: depending upon your Windows Server version, you may be able to create a desktop shortcut which will run the Process Designer application directly, by including the Connection Point in the "Target" value:

3. At the logon screen, input appropriate user credentials:

Note: A benign error is display in the cmd prompt.  The error "com.filenet.api.exception.EngineRuntimeException; The password was null or empty when trying to create JAAS Subject." can be ignored.

4. The stand-alone Process Designer application includes a "Tools" menu option, from which you can launch Process Administrator:

On a Windows Client PC (non-CPE server):

In order to deploy the Process Designer stand-alone application on a non-Content Platform Engine server Windows computer, you must first install the "Tools" from the IBM Content Platform Engine 5.2.1 or 5.5.x installer.  When using 5.2.1, also install the "Tools" from the 5.2.1 Fix Pack 7 installer.

NOTE: after following these instructions, all of the normal Process Engine server tools in the "tools\PE" directory (i.e. vwtool) will be available.

1 a - For IBM FileNet Content Platform Engine 5.2.1, copy both the 5.2.1 server base installer files, and the 5.2.1 server Fix Pack 7 installer files to the target Windows computer.


1 b - For IBM FileNet Content Platform Engine 5.5.x, copy the 5.5.x server base installer files to the target Windows computer.
2. Run the installer, and select only the "tools" option during the installer setup:


 

3. When prompted for the "Process Designer JRE Directory" - this is the Java run-time location on the local Windows computer that the stand-alone Process Designer application will utilize.  You must point to an existing Java run-time installed on the Windows host computer.  Your input will be entered into the cpetoolenv.bat file automatically.
 

image-20190820190608-1


3. Input the target IBM FileNet Content Platform Engine server URL to which the stand-alone application will be connecting, for example:

4. After completing the initial setup pages, run the CPE 5.2.1 installation to install the required "Tools" on the Windows computer.

5. For CPE 5.2.1 only; when the CPE 5.2.1 installation is completed, then run the CPE 5.2.1 FP7 installer, again, choosing only the "Tools" option:

6. When the installation is completed, you will find the two Process Designer application batch files in the "tools\PE" directory:

7. Confirm the "cpetoolenv.bat" file includes your JRE as the "JAVA_HOME=" value.  The following screen shot is an example:

8. From the Windows command prompt, run the pedesigner.bat (including the Connection Point):

9. At the logon screen, input appropriate user credentials:

Note: A benign error is display in the cmd prompt.  The error "com.filenet.api.exception.EngineRuntimeException; The password was null or empty when trying to create JAAS Subject." can be ignored.


10. The Process Designer stand-alone application includes a "Tools" menu option, from which you can now launch Process Administrator:
How to change target servers:
In order to run the Process Designer application on a different IBM Content Platform Engine server, you must edit the WcmApiConfig.properties file.
For example:  C:\Program Files (x86)\IBM\FileNet\ContentEngine\tools\PE\config\WcmApiConfig.properties

The following value must point to a valid server:
RemoteServerUrl = http://<server_name>:<port>/wsi/FNCEWS40MTOM/

NOTE: an invalid URL will cause a runtime failure, for example:
Caused by: java.lang.RuntimeException: Error 500: com.filenet.api.exception.EngineRuntimeException: FNRCA0015E: API_INVALID_URI: An invalid URI was found for connection http://ecmdemo1:9080/wsi/api/pesendapi.

[{"Business Unit":{"code":"BU004","label":"Hybrid Cloud"},"Product":{"code":"SSTHRT","label":"Case Foundation"},"Component":"Process Engine","Platform":[{"code":"PF033","label":"Windows"}],"Version":"5.2.1, 5.5.x","Edition":"All Editions"}]

Product Synonym

PE; CPE; Process Engne

Document Information

Modified date:
03 September 2019

UID

swg22007000