Troubleshooting and support

If you are having problems with your IBM® Integration Bus Healthcare Pack applications, use the following techniques to help you to diagnose and solve the problems.

For information about the techniques that you can use to diagnose problems, see Troubleshooting and support in the IBM Integration Bus product documentation.

To view the solution to a problem that you encounter when you use IBM Integration Bus Healthcare Pack, select the corresponding problem from the following list:

IBM Integration Bus Healthcare Pack nodes and patterns not shown after installation

Scenario: After you install IBM Integration Bus Healthcare Pack, you cannot see the healthcare patterns in the patterns explorer, and you cannot see the healthcare nodes in the node palette.
Solution: Run the IBM Integration Toolkit with a user ID that has root or administrator authority:
- On Windows, click Start > All Programs > Accessories, right-click Command Prompt, and click Run as administrator. Navigate to your IBM Integration Toolkit installation directory. By default, this directory is C:\Program Files (x86)\IBM\IntegrationToolkit90. Run launcher.bat -clean.
- On Linux, open a terminal and navigate to your IBM Integration Toolkit installation directory. By default, this directory is /opt/IBM/IntegrationToolkit90. Run the command ./launcher -clean. If the nodes and patterns are still not showing, run the command by using sudo, sudo ./launcher -clean.
You need to complete this step only the first time that you open the IBM Integration Toolkit after you install the Patterns, Nodes, and Libraries in the IBM Integration Toolkit component of the IBM Integration Bus Healthcare Pack.

Uninstallation does not complete

Scenario: After an incomplete uninstallation, Healthcare folders and files remain on your computer.
Solution: Check your system for the following Healthcare folders and files, and remove all that remain.
- Remove the HealthcarePack folder.
  - On Windows, the default location is: C:\Program Files\IBM\HealthcarePack
  - On Linux or UNIX, the default location is: /opt/IBM/HealthcarePack
- If you installed the Patterns, Nodes and Libraries in the IBM Integration Toolkit component, remove the com.ibm.broker.healthcare.link file, or replace it with a backup.
  - On Windows, the default location is: C:\Program Files (x86)\IBM\IntegrationToolkit90\links\com.ibm.broker.healthcare.link
  - On Linux, the default location is: /opt/IBM/IntegrationToolkit90/links/com.ibm.broker.healthcare.link
- If you installed the Web-based monitoring component, remove the HealthcareWebMonitoring_3.0.0.0 file.
  - On Windows, the default location is: C:\ProgramData\IBM\MQSI\Common\profiles\HealthcareWebMonitoring_3.0.0.0.cmd
  - On Linux or UNIX, the default location is: /var/mqsi/common/profiles/HealthcareWebMonitoring_3.0.0.0.sh
- If you installed the Operational monitoring in IBM Integration Explorer component, remove the com.ibm.broker.healthcare.link file, or replace it with a backup.
  - On Windows, the default location is: C:\Program Files\IBM\WebSphere MQ\MQExplorer\links\com.ibm.broker.healthcare.link
  - On Linux, the default location is: /opt/mqm/mqexplorer/links/com.ibm.broker.healthcare.link
- If you installed the Medical Device Integration component, remove the MedicalDeviceInputNode_3.0.0.0 file.
  - On Windows, the default location is: C:\ProgramData\IBM\MQSI\Common\profiles\MedicalDeviceInputNode_3.0.0.0.cmd
  - On Linux, the default location is: /var/mqsi/common/profiles/MedicalDeviceInputNode_3.0.0.0.sh

Reverting to an earlier version of the IBM Integration Bus Healthcare Pack

Scenario: You update IBM Integration Bus Healthcare Pack, by reverting to a version of the product you previously installed. However, when you open IBM Integration Toolkit, the contents are not updated to the reverted state.
Explanation: Some changes can result in the plug-in cache configuration becoming out of sync. Cleaning the cache can help to rectify this problem.
Solution:
1. In the Start menu, open IBM Integration Toolkit > IBM Integration Toolkit version, where version is the version number of IBM Integration Toolkit.
2. Right-click Integration Toolkit version. The Integration Toolkit Properties window opens.
3. In the Target field of the Shortcut tab, type -clean at the end of the target name, and click OK.
4. Restart IBM Integration Toolkit .

Error messages when you deploy the MedicalDeviceInput node

Scenario: When you try to deploy a message flow that contains the MedicalDeviceInput to an integration node, the deployment fails and an error message is shown.
Solution: Restart the integration server to which you want to deploy the message flow, and deploy the message flow.

Deploying a BAR file that contains the HL7 DFDL message model produces a BIP5043E error

Scenario: You try to deploy a BAR file that contains the HL7 DFDL message model, but an error of type BIP5043E is produced.
Explanation: If you are deploying a BAR file that contains the full HL7 DFDL model (that is, including the HL7 chapters), the default maximum JVM heap size for the integration server (256 MB) might not be large enough for the deployment to complete successfully.
Solution:
1. Increase the integration server maximum heap size to greater than 256 MB. A value of at least 512 MB is recommended. In the command console, type the following command: mqsichangeproperties integration_node -e integration_server -o ComIbmJVMManager -n jvmMaxHeapSize -v size_in_bytes where integration_node is the name of your integration node, integration_server is the name of your integration server, and size_in_bytes is the maximum heap size that you want to use.
2. Restart the integration node, by entering the following commands: mqsistop integration_node, then mqsistart integration_node where integration_node is the name of your integration node.
3. Set the maximum Java heap size to 536870912 bytes, by running the following command: mqsichangeproperties integration_node -e integration_server -o ComIbmJVMManager -n jvmMaxHeapSize -v 536870912, where integration_node is the name of your integration node, and integration_server is the name of your integration server.
4. Restart the integration server by running the following command: mqsireload integration_node -e integration_server where integration_node is the name of your integration node, and integration_server is the name of your integration server.
5. Deploy your BAR file.
The BAR file deploys successfully.

The web-based monitoring web page cannot be opened

Scenario: When you enter the URL for the web-based monitoring page, no page is displayed, or an HTTP 404 Not Found message is shown.
Explanation: This problem might exist because the URL for the web user interface server is incorrect, or the web user interface server is not running.
Solution: Check that you are using the correct URL to access the web-based monitoring web page; see Accessing web-based monitoring. Ensure that the web user interface server is running and is configured correctly; see Configuring the web user interface server and Enabling and disabling the web user interface in the IBM Integration Bus product documentation.

No pattern instances are available to select when you are viewing web-based monitoring

Scenario: When you open the web page for web-based monitoring, the healthcare web-based monitoring page is shown, but no pattern instances are available to select. The message No pattern instances deployed is shown next to the pattern descriptions.
Explanation: This problem might exist because no pattern instances are deployed to the integration node that is running web-based monitoring.
Solution:
1. Ensure that you deployed a pattern instance for the pattern that you want to monitor.
2. Ensure that the integration node to which you deployed your pattern instance is the same integration node that is configured for web-based monitoring. You specify the integration node to use for web-based monitoring when you configure the web user interface server; see Configuring the web user interface server in the IBM Integration Bus product documentation.

Patterns from IBM WebSphere Message Broker Connectivity Pack for Healthcare do not display in web-based monitoring for IBM Integration Bus Healthcare Pack

Scenario: You try to use web-based monitoring to monitor a pattern that you created by using IBM WebSphere® Message Broker Connectivity Pack for Healthcare version 7 or 8. Your patterns do not display.
Explanation: You can use web-based monitoring to monitor patterns that are generated in IBM Integration Bus Healthcare Pack version 3. You can monitor patterns that you created in earlier versions of the product, but you must regenerate them in IBM Integration Bus Healthcare Pack version 3.
Solution: Regenerate your pattern:
- In the Application Development view, open Pattern Instances > pattern_instance_name > Pattern configuration > pattern_instance_name_configuration.xml, where pattern_instance_name is the name of your pattern instance.
- In the Configure Pattern Parameters view, click Generate.
Your pattern is regenerated, and can be used with web-based monitoring.

When you are viewing web-based operational monitoring for a Healthcare pattern, no messages/second or last message information is shown

Scenario: In the web-based operational monitoring page for a Healthcare pattern, in the Messages/second or Last message columns, no information is shown for one or more message flows.
Explanation: This problem might exist because of one of the following explanations:
- Message flow statistics are turned off for this message flow
- No messages have passed through the message flow since the monitoring session was started
- The application or service that contains the message flow is stopped
Solution: Ensure that the application or service that contains the message flow you want to monitor is started and that data is passing through the message flow. Ensure that message flow statistics are turned on for the required message flows. You can turn on message flow statistics by clicking Enable statistics in the Change statistics state column of the monitoring table.

When you create a pattern instance of the Healthcare: HL7 to HL7 DFDL pattern, you see an error message

Scenario: When you create the Healthcare: HL7 to HL7 DFDL pattern, you see an error message and you cannot deploy the pattern.
Explanation: The HL7 DFDL model was imported after the pattern was deployed. You must include a reference to the HL7 DFDL library in your project so that the DFDL library is deployed together with the generated application.
Solution: Import the HL7 DFDL message model:
1. In the Patterns Explorer view, expand Patterns > Healthcare and click HL7 to HL7 DFDL. The Pattern Specification page for the Healthcare: HL7 to HL7 DFDL pattern opens.
2. Click the Resources for the pattern link. The "Resources for the Healthcare: HL7 to HL7 DFDL pattern" page opens.
3. Click the link to import the version of the HL7 DFDL models that you require. The Prepare the Samples window opens.
4. Click Next. The import completes.
5. Click Next. A success message is displayed.
6. Click Finish.
7. In the Application Development tab, select your project.
8. From the menu, selectProject > Clean. The Clean window opens.
9. Select Clean all projects, click OK. When the cleaning process completes successfully, the error message is removed.

Last updated : 2015-12-07 16:17:35

Task topic | Version 3.0.0.1 | ha00200