Troubleshoot: WebSphere Commerce Developer

You might experience the following problems when you use WebSphere Commerce Developer.

 

Context-sensitive help for WebSphere Commerce tools is unavailable

If context-sensitive help pages for WebSphere Commerce Accelerator, Organization Administration Console, or the Administration Console are reported as unavailable, your WebSphere Commerce Developer Help Server might not be properly configured. For detailed instructions on configuring the Help Server, refer to Start and stopping the WebSphere Commerce Information Center.

 

When running the WebSphere Commerce development environment in debug mode, the debugger may time out causing instability

To prevent the debugger from timing out, increase the amount of time before the debugger times out:

  1. Click Window > Preferences.

  2. In the Preferences window, click Java > Debug.

  3. In the Debugger timeout text box, enter a larger number than current the number in the text box.

  4. Click Apply.

When starting the WebSphere Commerce Test Server, the WebSphere Commerce application fails to start.

An error similar to the following displays in the WCDE_installdir/wasprofile/logs/server1/trace.log file: Caused by: com.ibm.ws.exception.ConfigurationWarning: com.ibm.etools.j2ee.commonarchivecore.exception.NoModuleFileException: A file does not exist for module element having uri: WebSphereCommerceServerExtensionsData.jar.

To work around the problem:

  1. In the Project Explorer View, navigate to the WC Project.

  2. Right-click the WC project and select Close Project. The workspace rebuilds.

  3. Right-click the WC project and select Open Project. The workspace rebuilds.

  4. Restart WebSphere Commerce Developer

  5. Start the WebSphere Commerce Test Server

Unable to browse store pages when using port 80

When attempting to access the home page for one of the WebSphere Commerce starter stores (for example, ConsumerDirect), an error message displays. An example of the error message follows: A WebGroup/Virtual Host to handle /webapp/wcs/stores/servlet/ConsumerDirect/index.jsp has not been defined. The virtual host definitions in the WAS might not be functioning properly.

A simple test to verify this situation is to attempt to access the starter store's homepage using port 8000 instead of port 80. For example if ConsumerDirect was published, try to access the store using https://localhost:8000/webapp/wcs/stores/servlet/ConsumerDirect/index.jsp. If port 8000 was successful then the virtual host definitions will need to be updated.

To change the virtual host definitions:

  1. Start the WebSphere Commerce Test Server using either the Rational Application Developer interface or using the startWCServer.bat script.

  2. Access the WAS's console

  3. Select Environment >Virtual Hosts

  4. Select the default_host entry

  5. From the "additional properties" section select "Host Aliases"

  6. Delete the references to port 80 and 443

  7. Save your change to the master configuration.

  8. Restart the server.

You should now be able to access the starter stores using port 80.

Related concepts

WebSphere Commerce development environment