Network Deployment (Distributed operating systems), v8.0 > Troubleshoot and support > Troubleshoot web services

UDDI registry troubleshooting

Common errors that can occur when you use the UDDI registry include database and data source errors, JavaScript syntax errors on pages in the UDDI user console, a UDDI node not appearing in the administrative console list of available nodes, and not being able to issue UDDI requests. During UDDI registry use, messages to report events or errors might be issued. Use these messages first to resolve any problems. For further assistance, review the following list of troubleshooting tips.

For more details about a problem, enable trace for UDDI. You can enable or disable trace by using the admin console. The component for the UDDI registry is com.ibm.uddi. We can enable trace for the UDDI registry at several levels of granularity. For example, to enable all UDDI registry tracing, specify the following:

com.ibm.uddi.*=all

The following list contains some problems that might occur when you set up or use the UDDI registry, and suggested solutions.

Procedure

• The first startup of the UDDI application might take time to complete.

  • When you start the UDDI registry application for the first time with a new UDDI registry database, it must complete UDDI initialization, which occurs automatically for a default UDDI node, or when requested for a customized UDDI node. UDDI initialization populates the UDDI registry with predefined data and entities, and can take time to complete. This is expected behavior, and affects only the first startup of the UDDI application.

  • If you use the wsadmin utility to issue a command to start the UDDI application, depending on your TCP timeout settings, this request might time out while it waits for UDDI to complete initialization. UDDI initialization and starting the UDDI application continue to complete normally; they are not affected by this timeout.

• (AIX) (Solaris) On UNIX and Linux platforms, if you use DB2, before you issue the startServer.sh server1 command, run the db2profile script. This script is in the DB2 instance home directory under the sqllib directory.

  To invoke the db2profile script, type the following. Notice that a single space character follows the period (.).

  . /home/db2inst1/sqllib/db2profile
  

  On UNIX and Linux platforms, the DB2 user must have a db2profile at $HOME/sqllib/db2profile

• JavaScript syntax errors might occur on several web pages in the UDDI user console. This problem is caused by a limitation about URL rewriting. To avoid this limitation, cookies must be enabled in client browsers, the application server must have cookies enabled as the session tracking mechanism, and URL rewriting must be disabled.

• For a remote DB2 database, if attaching to the remote system causes problems, one possible cause might be IP addressing. This situation does not occur when the remote system uses a static IP address. However, if the remote system uses Dynamic Host Configuration Protocol (DHCP), each system must be aware of the subnet mask of the other system.

  (Windows) To find the subnet mask, start a command prompt and run on the remote system:

  ipconfig
  

  On the host system, you might need to edit the WINS addresses to add the remote subnet mask. Use the following steps:

  1. Click START > Network and Dial-up Connections > Local Area Network Connection 2 > Internet Protocol (TCP/IP) , and click Properties.

  2. Click Advanced.

  3. Click the WINS tab and add the new subnet mask.
  4. Move the new subnet mask to the top of the list by highlighting it and pressing the up arrow until the new subnet mask is at the top of the list of WINS addresses.

  Use the ifconfig command to determine the subnet mask.

• The UDDI node is not in the list of available nodes on the admin console. Check that the UDDI application is started on the relevant node and server.
• We cannot issue UDDI requests, for example, you start the UDDI user console but errors occur when you try to publish or inquire. Consider the following reasons:
  • The database is not currently loaded or configured. Check the output from creating the database.
  • The database is not correctly configured. Check that the JDBC provider and data source definitions are correct by clicking Test Connection on the admin console.
  • The UDDI node is not initialized. Check the UDDI node page on the admin console. If the status of the node is not activated or deactivated, set any policies or properties, then try to initialize the node.
  • The UDDI node is currently deactivated while UDDI runtime settings are updated. Check the UDDI node page on the admin console. If the status of the node is deactivated, wait for the status to become activated, then try the request again.

• When you try to save a business entity in a UDDI registry that runs on WAS v7.0 or later, but the registry uses a Cloudscape or Apache Derby database created using an earlier version of the product, the following error might occur:

  Serious technical error has occurred while processing the request.
  

  This error occurs if a UDDI database currently uses Apache Derby Version 10.2 or later and we have upgraded the servers to WAS v7.0 or later. We must migrate the UDDI database. See the topic about migrating a UDDI database that uses Apache Derby.

What to do next

If we have not resolved your problem, see the problem determination information on the WAS support web page.
Work with trace
Use the DB2 Universal JDBC Driver to access DB2 for z/OS
Migrate a UDDI database that uses Apache Derby
Administer the UDDI registry

Related

UDDI Utility Tools limitations and resolutions
WAS Support

+

Search Tips   |   Advanced Search