Troubleshooting Process Designer and Process Center connectivity
Resolve problems starting Process Designer, for example during login, by using various techniques such as correcting invalid connection information or logging errors that are captured with log4J or java.util.logging.
You might encounter an error message similar to this one when you
start Process Designer:
Unable to establish a connection with the Process Center
When you start Process Designer, you must log in using your IBM® BPM user name and password. If you do not already have a user account, contact your IBM BPM administrator. When you log in, you are connected to the Process Center designated during installation of Process Designer.
To
determine your connection status, check the lower right corner of
the Process Designer.
This area of the Designer interface displays status conditions.
Indicator color | Connection to Process Center Server status |
---|---|
Green | Good connection |
Yellow | Slow connection that might cause issues with concurrent edits |
Orange | Even slower connection and more potential issues with concurrent editing |
Red | No connection; check with your IBM Business Process Manager administrator to ensure the Process Center Server is up and running |
If you see a connection error after you log in, try
one of the following tasks:
- Confirm that you are using the correct user name and password.
- Confirm that Process Center is running by accessing it through a browser using the URL in the form http://hostname:port/ProcessCenter. The default port is 9080.
- Check the eclipse.ini file (in the Process Designer installation
directory) to confirm that the Process Center connection
information is correct:
- Find the installation folder of Process Designer on your local computer, for example C:\IBM\ProcessDesigner\v8.5.
- Open the eclipse.ini file and locate -Dcom.ibm.bpm.processcenter.url. Ensure that the URL prefix (http://hostname:port) is the same as the Process Center URL prefix.
- Confirm that your Process Designer version
matches the Process Center version.
If your administrator upgraded Process Center, you
need to upgrade Process Designer to
the same version by accessing Process Center from
a browser and downloading Process Designer.If the two versions are different, you might see a message similar to the following message:
The versions of Process Center("BPM8501-20130922-000036") and Process Designer ("BPM8500-20130525-092636") do not match.
- If you see a blank white Process Designer view or the view does not display fully, or if you see an HTTP error, press F5 to refresh. If the display continues to be blank, enable a security option as described in Process Designer window is blank.
- Process Designer communicates
with Process Center using
the following ports. If you have a firewall or proxy server, or are
running a service that forwards the ports, check that communication
on the following ports is enabled.
Table 2. Process Center ports accessed by Process Designer Port Name Default Number BOOTSTRAP_ADDRESS 2809 CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS 9403 ORB_LISTENER_ADDRESS 9100 SIB_ENDPOINT_ADDRESS 7276 SIB_ENDPOINT_SECURE_ADDRESS 7286 WC_defaulthost 9080 WC_defaulthost_secure 9443 The default ports depend on the server type. Refer to Port number settings in the WebSphere Application Server information center.
- Examine the IBM Business Process Manager logs for errors or information. See IBM Business Process Manager log files.
- Turn on Log4J debug level tracing. See Enabling log4J debug tracing
- Use java.util.logging to write errors to a log. See Enabling java.util.logging