Frequently asked questions (FAQ) about IBM WebSphere Integration Developer (updated September 2014)

Product documentation


Abstract

The following list includes frequently asked questions (FAQ) about WebSphere Integration Developer to help you troubleshoot potential problems and enhance how you use the product.

As of September 2014, this content is no longer being updated.

Content

Do you have ideas for other FAQ about WebSphere Integration Developer? Give us your feedback in the Rate this page section.



Additional FAQ documents are available in the Related information section.


FAQ table of contents



Planning


1. How can I ensure that WebSphere Integration Developer will coexist with other Eclipse-based products?


2. Where can I find information about the prerequisites between WebSphere Integration Developer and other IBM products?


3. Where can I find information about Business Space?


4. Which versions of IBM Rational ClearCase Remote Client, ClearCase, Rational Team Concert, and WebSphere Integration Developer been tested together?



Installing and configuring

1. How do I install WebSphere Integration Developer and the WebSphere Process Server unit test environment (UTE) silently?

2. How do I install the WebSphere Business Monitor development toolkit and the WebSphere Business Monitor unit test environment (UTE) server in V7.0?

3. How do I extract the WebSphere Integration Developer images from Passport Advantage to be installed successfully?

4. Should I do anything before I reinstall WebSphere Integration Developer?

5. What are the coexisting installation scenarios for WebSphere Business Integration tools?

6. Will anti-virus or other security software affect the WebSphere Integration Developer installation process?

7. Is WebSphere Integration Developer supported on Microsoft Windows 7?

8. Does WebSphere Integration Developer V7.0 support 64-bit technology on Windows and Linux?

9. How do I install a feature pack over an existing fix pack?

10. How can I avoid common installation problems for WebSphere Integration Developer when installing on Windows 7?

11. How do I use the IBM Rational ClearCase Remote Client for Eclipse with WebSphere Integration Developer?

12. How do I use IBM Rational ClearCase SCM Adapter for Eclipse with WebSphere Integration Developer?

13. How do I use the IBM Rational Team Concert client for Eclipse with WebSphere Integration Developer?

14. How do I use the locally installed product documentation instead of the remote help?



Security

1. We use the SCA security permission qualifier to secure a mediation service. What is the recommended approach to access the secured service in an SCA module?

2. When configuring the security identity of modules, can I configure the runtime user and password in WebSphere Integration Developer or must it be done using the WebSphere administrative console while or after the SCA module is deployed?

3. Does WebSphere Integration Developer V7 support the UDDI V3 registry?



Managing processes and services

1. In the Business Object mapper, how do I map fields from a multiple-level embedded array source to a single array target?

2. What are the limitations of the business object mapping editor?

3. Is the lazy parsing mode for business objects supported in WebSphere and WebSphere Enterprise Service Bus?

4. When I make a new version of a Business Process Execution Language (BPEL) process, do I need to run the New process version wizard?

5. How can I add a utility JAR file as a dependency for a project in WebSphere Integration Developer?

6. Why is SoapAction not set when I generate web service export binding?

7. Which functions or features in Rational Application Developer are provided in WebSphere Integration Developer?

8. I am using the foreach transformation in an XML map to copy data from one array type to another. How do I access and use the iteration counter?



Deploying applications

1. How do I stop the unit test environment server from publishing automatically?

2. Is the lazy parsing mode for business objects supported in WebSphere and WebSphere Enterprise Service Bus?

3. Does WebSphere Integration Developer V7.0 support deploying projects into a managed network deployment configuration of a runtime environment?

4. Which versions of WebSphere Integration Developer and WebSphere Process Server are compatible?



Performance

1. How can I improve the performance of WebSphere Business Process Management?

2. How can I improve my productivity when I work in WebSphere Business Process Management?



Testing

1. How do I run test cases from a script?

2. How do I automate my tests?

3. When invoking a module with another client, can the test client functions be used with the module?



Troubleshooting

1. Sometimes, publishing in WebSphere Integration Developer takes too long, and sometimes the server suddenly stops. How do I resolve this issue?

2. How do I resolve synchronization problems in WebSphere Integration Developer V6.x test environment servers (such as WebSphere)?

3. How do I resolve the following error, which I received when validation of a WSDL import failed:
XSD: Type reference 'http://www.example.com/wsdls#MyType' is unresolved.
How do I resolve this issue?

4. How can collecting diagnostic data (MustGather) help me determine and resolve problems related to Problem Management Records (PMRs)?

5. How do I fix the External Service and External Data wizards, which do not work properly after I installed WebSphere Transformation Extender V8.2 into WebSphere Integration Developer V6.1?

6. Why does the unit test environment (UTE) seem frozen and indicate "starting" after a successful installation of WebSphere Integration Developer V7.0 on Linux?

7. When migrating projects in Rational ClearCase source control from WebSphere Integration Developer V6.0.2 to WebSphere Integration Developer V7, the Migration wizard sometimes re-opens for the migrated projects. What do I do?

8. I received an application startup failure when WebSphere uses an Oracle database. The error message contains "java.sql.SQLException: ORA-01400: cannot insert NULL". What might have caused this failure and how can I fix it?

9. Installing the WebSphere test environment for WebSphere Integration Developer on a Microsoft Windows 7 or Vista 64-bit enterprise operating system using the default installation path fails without warning. How do I fix this problem?

10. Why does the unit test environment (UTE) server not start properly after I have installed the Lotus WebForm Server, which is packaged with WebSphere Integration Developer and WebSphere Dynamic Process Edition, into the UTE server profile in WebSphere Integration Developer and WebSphere Dynamic Process Edition?

11. If WebSphere Integration Developer V7.0.0.5 is installed simultaneously with V7, or is upgraded directly from V7.0.0.3 or a prior V7.0.0.x release, then WebSphere Integration Developer V7.0.0.5 cannot launch. How do I resolve this problem?

12. If WebSphere Integration Developer V7.0.0.5 is installed simultaneously with V7, or is upgraded directly from V7.0.0.3 or a prior V7.0.0.x release, then a configuration error occurs when WebSphere Integration Developer V7.0.0.5 is launched. How do I resolve this problem?

13. If adapter binding classes are not generated using serviceDeploy, how do I generate them using command line builds?

14. How can I help IBM troubleshoot WebSphere Integration Developer issues?

15. Why can I not search PDFs that were generated in WebSphere Integration Developer V7?

16. Why can I not download remote resources when I am importing WSDL or XSD files?

17. Where can I find a compilation of links to documents about diagnosing issues with WebSphere Integration Developer and IBM Integration Designer?

18. What are the known Issues with WebSphere Integration Developer V7.0 Fix Pack 5 (V7.0.0.5)?

19. How do I submit traces and logs to IBM Support?




FAQ questions and answers



Planning


FAQ: How can I ensure that WebSphere Integration Developer will coexist with other Eclipse-based products?
Answer: See Planning for WebSphere Integration Developer to coexist with other Eclipse-based products.


FAQ: Where can I find information about the prerequisites between WebSphere Integration Developer and other IBM products?
Answer: See Software prerequisite matrix builder checks the prerequisites between IBM products.


FAQ: Where can I find information about Business Space?
Answer: Business Space powered by WebSphere is a common component used by many products. For more information, see the Business Space FAQ.


FAQ: Which versions of IBM Rational ClearCase Remote Client, ClearCase, Rational Team Concert, and WebSphere Integration Developer been tested together?
Answer: See Using IBM Rational ClearCase Remote Client, ClearCase, Rational Team Concert, and WebSphere Integration Developer.



Installing and configuring


FAQ: How do I install WebSphere Integration Developer and the WebSphere Process Server unit test environment (UTE) silently?
Answer: See Installing WebSphere Integration Developer and the WebSphere Process Server Unit Test Environment (UTE) silently.


FAQ: How do I install the WebSphere Business Monitor development toolkit and the WebSphere Business Monitor unit test environment (UTE) server in V7.0?
Answer: See Installing the WebSphere Business Monitor development toolkit and the WebSphere Business Monitor unit test environment (UTE) server in V7.0.


FAQ: How do I extract the WebSphere Integration Developer images from Passport Advantage to be installed successfully?
Answer (V6.1, V6.1.2, V6.2): It is important that you extract the required packages to the same folder on your local system. For complete instructions, see Download WebSphere Integration Developer for Windows.
Answer (V7.0): It is important that you extract the required packages to the same folder on your local system. For complete instructions for V7.0, see Download WebSphere Integration Developer V7.0 for Windows.


FAQ: Should I do anything before I reinstall WebSphere Integration Developer?
Answer: See Pre-installation verification steps.


FAQ: What are the coexisting installation scenarios for WebSphere Business Integration tools?
Answer: See Coexisting installations of WebSphere Business Integration tools.


FAQ: Will anti-virus or other security software affect the WebSphere Integration Developer installation process?
Answer: See Exceptions thrown during installation of WebSphere Integration Developer and Slow installation process for WebSphere Integration Developer. For more information about WebSphere Integration Developer installation troubleshooting, see Troubleshooting the installation process.


FAQ: Is WebSphere Integration Developer supported on Microsoft Windows 7?
Answer: Yes. WebSphere Integration Developer V7.0.0.2 is supported on Windows 7. For information about system requirements, see Detailed hardware and software requirements for WebSphere Integration Developer V7.0.0.2 on Windows.


FAQ: Does WebSphere Integration Developer V7.0 support 64-bit technology on Windows and Linux?
Answer: No. WebSphere Integration Developer V7.0 is not designed to use 64-bit computing and only uses 32-bit technology. For more information, see WebSphere Integration Developer V7.0 support policy for 64-bit technology.


FAQ: How do I install a feature pack over an existing fix pack?
Answer: See Installing over an existing package.


FAQ: How can I avoid common installation problems for WebSphere Integration Developer when installing on Windows 7?
Answer: See Pre-installation check list for WebSphere Integration Developer.


FAQ: How do I use the IBM Rational ClearCase Remote Client for Eclipse with WebSphere Integration Developer?
Answer: See Using the IBM Rational ClearCase Remote Client for Eclipse with WebSphere Integration Developer.


FAQ: How do I use IBM Rational ClearCase SCM Adapter for Eclipse with WebSphere Integration Developer?
Answer: See Using IBM Rational ClearCase SCM Adapter for Eclipse with WebSphere Integration Developer.


FAQ: How do I use the IBM Rational Team Concert client for Eclipse with WebSphere Integration Developer?
Answer: See Using the IBM Rational Team Concert client for Eclipse with WebSphere Integration Developer.


FAQ: How do I use the locally installed product documentation instead of the remote help?
Answer: See Using the locally installed product documentation instead of the remote help.



Security
FAQ: We use the SCA security permission qualifier to secure a mediation service. What is the recommended approach to access the secured service in an SCA module?
Answer: See Accessing the secured service in an SCA module.


FAQ: When configuring the security identity of modules, can I configure the runtime user and password in WebSphere Integration Developer or must it be done using the WebSphere Process Server administrative console while or after the SCA module is deployed?
Answer: See Configuring the security identity for modules.


FAQ: Does WebSphere Integration Developer V7 support the UDDI V3 registry?
Answer: In WebSphere Integration Developer V7, the UDDI V3 registry is supported in the UDDI endpoint lookup primitive in a mediation flow but in external service discovery. See UDDI V3 registry compatibility in IBM WebSphere Integration Developer V7, IBM Integration Developer V7.5, IBM Integration Developer V7.5.1, and IBM Integration Developer V8.0.



Managing processes and services


FAQ: In the Business Object mapper, how do I map fields from a multiple-level embedded array source to a single array target?
Answer: See Mapping fields from a multiple-level embedded array source to a single array target.


FAQ: What are the limitations of the business object mapping editor?
Answer: See Limitations of the business object mapping editor.


FAQ: Is the lazy parsing mode for business objects supported in WebSphere Process Server and WebSphere Enterprise Service Bus?
Answer: See Lazy parsing mode for business objects.


FAQ: When I make a new version of a Business Process Execution Language (BPEL) process, do I need to run the New process version wizard?
Answer: It depends on whether you want running process instances to be migrated to the new version. See Need to use the New Process Version wizard.


FAQ: How can I add a utility JAR file as a dependency for a project in WebSphere Integration Developer?
Answer: Use the dependency editor to add utility JAR files. For more information, see Adding a utility JAR file to a project dependency.


FAQ: Why is SoapAction not set when I generate web service export binding?
Answer: See SoapAction not set when I generate web service export binding.


FAQ: Which functions or features in Rational Application Developer are provided in WebSphere Integration Developer?
Answer: See Functions or features in Rational Application Developer that are and are not in WebSphere Integration Developer.


FAQ: I am using the foreach transformation in an XML map to copy data from one array type to another. How do I access and use the iteration counter?
Answer: See Foreach iteration counter in an XML Map.



Deploying applications

FAQ: How do I stop the unit test environment server from publishing automatically?
Answer: See Stopping the unit test environment server from publishing automatically.


FAQ: Is the lazy parsing mode for business objects supported in WebSphere Process Server and WebSphere Enterprise Service Bus?
Answer: See Lazy parsing mode for business objects.


FAQ: Does WebSphere Integration Developer V7.0 support deploying projects into a managed network deployment configuration of a runtime environment?
Answer: No. WebSphere Integration Developer V7.0 does not support this function.


FAQ: Which versions of WebSphere Integration Developer and WebSphere Process Server are compatible?
Answer: See WebSphere Integration Developer and WebSphere Process Server compatibility.



Performance
FAQ: How can I improve the performance of WebSphere Business Process Management?
Answer:


FAQ: How can I improve my productivity when I work in WebSphere Business Process Management?
Answer: See Tips for working smarter and increasing productivity with WebSphere Integration Developer and the Tuning topic in the WebSphere Process Server for Multiplatforms information center.



Testing


FAQ: How do I run test cases from a script?
Answer: See Testing SOA applications with WebSphere Integration Developer and Ant scripts.


FAQ: How do I automate my tests?
Answer: See Automating tests.


FAQ: When invoking a module with another client, can the test client functions be used with the module?
Answer: The Attach feature is useful when you want to use all the integration test client functions, but a module is not being called from the integration test client. For more information, see Getting the most out of the WebSphere Integration Developer integration test client.



Troubleshooting


FAQ: Sometimes, publishing in WebSphere Integration Developer takes too long, and sometimes the server suddenly stops. How do I resolve this issue?
Answer: See Sometimes publishing takes too long and the server stops.


FAQ: How do I resolve synchronization problems in WebSphere Integration Developer V6.x test environment servers (such as WebSphere Process Server)?
Answer: See Synchronization problems in WebSphere Integration Developer V6 test environment servers.


FAQ: How do I resolve the following error, which I received when validation of a WSDL import failed:

    XSD: Type reference 'http://www.example.com/wsdls#MyType' is unresolved.

The WSDL file validated fine in Altova XMLSpy, but the validation failed in WebSphere Integration Developer.
Answer: See Fixing a validation error for a failed WSDL import.


FAQ: How can collecting diagnostic data (MustGather) help me determine and resolve problems related to Problem Management Records (PMRs)?
Answer: See MustGather: Read first for WebSphere Integration Developer.


FAQ: How do I fix the External Service and External Data wizards, which do not work properly after I installed WebSphere Transformation Extender V8.2 into WebSphere Integration Developer V6.1?
Answer: See Installing WebSphere Transformation Extender V8.2 into WebSphere Integration Developer V6.1 causes wizards for working with External Services and External Data to not work properly.


FAQ: Why does the unit test environment (UTE) seem frozen and indicate "starting" after a successful installation of WebSphere Integration Developer V7.0 on Linux?
Answer: You might need to increase the number of files that can be handled. Try changing ulimit -n 1024 (default) to ulimit -n 4096. For more information see, Increasing the number of file handles on Linux workstations.


FAQ: When migrating projects in Rational ClearCase source control from WebSphere Integration Developer V6.0.2 to WebSphere Integration Developer V7, the Migration wizard sometimes re-opens for the migrated projects. What do I do?
Answer: See Migration wizard reopens when migrating projects in Rational ClearCase source control from WebSphere Integration Developer V6.0.2 to WebSphere Integration Developer V7.


FAQ: I received an application startup failure when WebSphere Process Server uses an Oracle database. The error message contains "java.sql.SQLException: ORA-01400: cannot insert NULL". What might have caused this failure and how can I fix it?
Answer: See Application startup fails when WebSphere Process Server uses an Oracle database.


FAQ: Installing the WebSphere test environment for WebSphere Integration Developer on a Microsoft Windows 7 or Vista 64-bit enterprise operating system using the default installation path fails without warning. How do I fix this problem?
Answer: See Installing the WebSphere test environment on a Microsoft Windows 7 or Vista 64-bit enterprise operating system fails.


FAQ: Why does the unit test environment (UTE) server not start properly after I have installed the Lotus WebForm Server, which is packaged with WebSphere Integration Developer and WebSphere Dynamic Process Edition, into the UTE server profile in WebSphere Integration Developer and WebSphere Dynamic Process Edition?
Answer: See The unit test environment (UTE) server not start properly after installing the Lotus WebForm Server.


FAQ: If WebSphere Integration Developer V7.0.0.5 is installed simultaneously with V7, or is upgraded directly from V7.0.0.3 or a prior V7.0.0.x release, then WebSphere Integration Developer V7.0.0.5 cannot launch. How do I resolve this problem?
Answer: See When installing or upgrading to WebSphere Integration Developer (WID) V7.0.0.5, user should first install WID V7.0.0.4 or 7.0.0.4 Interim Fix 001.


FAQ: If WebSphere Integration Developer V7.0.0.5 is installed simultaneously with V7, or is upgraded directly from V7.0.0.3 or prior V7.0.0.x release, then a configuration error occurs when WebSphere Integration Developer V7.0.0.5 is launched. How do I resolve this problem?
Answer: See Launching WebSphere Integration Developer (WID) V7.0.0.5 shows configuration error if V7.0.0.5 is installed simultaneously with V7 or is upgraded directly from WID V7.0.0.3 or prior V7.0.0.x versions.


FAQ: If adapter binding classes are not generated using serviceDeploy, how do I generate them using command line builds?
Answer: See Generating adapter bindings using command line builds.


FAQ: How can I help IBM troubleshoot WebSphere Integration Developer issues?
Answer: See Collect troubleshooting data for WebSphere Integration Developer.


FAQ: Why can I not search PDFs that were generated in WebSphere Integration Developer V7?
Answer: PDF documents that are generated from WebSphere Integration Developer V7 cannot be searched. This is a limitation caused by an underlying dependency in the reporting sub-system.


FAQ: Why can I not download remote resources when I am importing WSDL or XSD files?
Answer (V6.2 and V7.0): See Unable to choose Download remote resources option during local WSDL or XSD, or both import.


FAQ: Where can I find a compilation of links to documents about diagnosing issues with WebSphere Integration Developer and IBM Integration Designer?
Answer: See Knowledge Collection: Diagnostic documents for WebSphere Integration Developer and IBM Integration Designer.


FAQ: What are the known Issues with WebSphere Integration Developer V7.0 Fix Pack 5 (V7.0.0.5)?
Answer: See Known Issues: WebSphere Integration Developer V7.0 Fix Pack 5 (V7.0.0.5).


FAQ: How do I submit traces and logs to IBM Support?
Answer: You can use IBM Support Assistant Lite for WebSphere Integration Developer to collect files automatically and package them for sending to IBM or for your own analysis. See Download IBM Support Assistant Lite for WebSphere Integration Developer.




Related information

FAQ - WebSphere Process Server
FAQ - WebSphere Business Monitor
FAQ - WebSphere Business Modeler
FAQ - WebSphere Industry Content Packs
FAQ - WebSphere MQ Workflow
FAQ - Business Space powered by WebSphere
FAQ - WebSphere Decision Center
FAQ - WebSphere Decision Server Events
FAQ - WebSphere Decision Server Rules
FAQ - WebSphere ILOG Decision Validation Services
FAQ - WebSphere ILOG Rule Team Server
FAQ - WebSphere ILOG JRules
FAQ - WebSphere Business Compass

Original publication date

2009/11/22

Product Alias/Synonym

WebSphere Integration Developer
WID

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

WebSphere Integration Developer

Software version:

6.1, 6.1.2, 6.2, 6.2.0.1, 6.2.0.2, 7.0, 7.0.0.1, 7.0.0.2, 7.0.0.3, 7.0.0.4, 7.0.0.5

Operating system(s):

Linux, Windows

Reference #:

7016440

Modified date:

2012-11-15

Translate my page

Machine Translation

Content navigation