Troubleshooting Process Designer

You can troubleshoot common issues that can arise when setting up and using Process Designer.

Procedure

Use the following information to troubleshoot errors with Process Designer setup and use.

Error: No such release is found

When installing a Fix Pack release, the installer process looks for a compatible prior release, report an error, and exit if no such release is found. To resolve this issue, first install the Tools from the prerequisite release as listed in the Fix Pack Readme documentation.

Error: JAVA_HOME is C:\MyJavaLocation\jvm\jre The system cannot find the path specified.

The system cannot find the Java executable, look at the JAVA_HOME value and confirm that the java.exe executable exists at that location. If necessary, resolve the problem by editing the cpetoolenv.bat batch file and changing the JAVA_HOME setting to point to a suitable Java JRE location.

Setting JAVA_HOME, additional notes:

To change the Java JRE used by Process Designer, edit cpetoolenv.bat and change the JAVA_HOME setting .

When editing cpetoolenv.bat to set JAVA_HOME, there can be no spaces around the "=" when assigning a value to %JAVA_HOME%

Do not include spaces in the value of JAVA_HOME location. You can avoid problems caused by spaces in the name by using the Windows short name 8.3 format instead of a long name containing spaces. In a Windows command window, use the DIR /X command to identify the correct short name for the Java path.

For example, the short name for

Program Files (x86)\IBM\Java80\JRE

Might be

Progra~2\IBM\Java80\JRE

Error: Usage: pedesigner connection_point_name

A connection point name was not supplied on the command line. The pedesigner batch file must be given a connection point name at startup time. Resolve the problem by supplying a connection point name. Connection points are used to access a Process Engine region. You can find a valid connection point using the Administration Console for Content Platform Engine. Navigate to Object Stores > Your object store > Administrative > Workflow system > Connection points.

Error: javax.net.ssl.SSLException: Unrecognized SSL message, plaintext connection?

When using HTTPS/SSL to communicate with the Content Platform Engine server, after entering a username and password, a pop-up dialog displays the error message.

Make sure that you are authenticated with any firewall software that might be blocking access to the Content Platform Engine server.

com.filenet.api.exception.EngineRuntimeException; The password was null or empty when trying to create JAAS Subject.

The stand-alone Process Designer throws a benign error in the command prompt at startup.

This is a benign error. When the logon prompt is displayed, the process continues as expected.