Last updated: 07/17/2003

General advice on using the UDDI Registry and advice on applying WebSphere Application Server, Version 5.0.2
This file contains information about troubleshooting, details about UDDI Samples and advice on applying service to the UDDI Registry.

Troubleshooting Information and UDDI Samples

  • General

    Note: There is a section on "UDDI Troubleshooting Tips" in the product documentation listing the common errors and resolutions for setting up or using the UDDI Registry.

    You can run the IBM WebSphere UDDI Registry with WebSphere Application Server security either enabled or disabled. However, you can see unpredictable results if you change between the two settings. For example, if you publish an entity with security disabled, that entity might not be present in the list of registered entities (from the get_registeredInfo request), as the userids could be different.

  • Samples

    There are a number of samples available for the UDDI Registry showing how to use the UDDI APIs. The UDDI samples package is available from the Samples Central page of the IBM WebSphere Developer Domain Web site at: http://www7b.software.ibm.com/wsdd/library/samples/AppServer.html

Applying Service to the UDDI Registry in a Network Deployment and single Application Server environment

  • SetupDB2UDDI Database Wizard (for Network Deployment and Base Application Server)

    WebSphere Application Server, Version 5.0.2 includes an updated version of the SetupDB2UDDI Database Wizard.

    Note: You must apply WebSphere Application Server Network Deployment, Version 5.0.2 to your Network Deployment product to get the updated version of the SetupDB2UDDI.jar file which will be found under <DeploymentManager-install-dir>\UDDIReg\scripts for Windows (<DeploymentManager-install-dir>/UDDIReg/scripts for UNIX Platforms). You must then copy this to the system on which you wish to run it, if this is not the same system on which you have your Network Deployment product.

  • Running the SetupDB2UDDI.jar file in a non-English configuration

    If you are using a non-English installation of DB2, then ensure you have applied at least WebSphere Application Server Network Deployment, Version 5.0.1 before continuing.

    Failure to apply WebSphere Application Server, Version 5.0.1 could result in an invalid username/password message being reported by the wizard.
  • Installing WebSphere Application Server, Version 5.0.2 into a Network Deployment configuration

    If you have previously installed the UDDI Registry, then the installation of WebSphere Application Server, Version 5.0.2 into a Network Deployment environment updates the UDDI Registry application automatically in the appropriate application servers across the cell.

    If you have not previously installed the UDDI Registry, then you should apply WebSphere Application Server Network Deployment, Version 5.0.2 and then follow the instructions on the InfoCenter on Installing and setting up a UDDI Registry.

  • Installing WebSphere Application Server, Version 5.0.2 into a Base Application Server only configuration

    Follow these steps to install WebSphere Application Server, Version 5.0.2:

    1. Stop any Web servers or application servers that you have running.
    2. Install the base part of WebSphere Application Server, Version 5.0.2 onto the base WebSphere Application Server product.
    3. Install the Network Deployment part of WebSphere Application Server, Version 5.0.2 onto the Network Deployment product. This is required as the UDDI Registry is installed with the Network Deployment product.
    4. (Optionally) check DeploymentManager\installableApps to see that the UDDI version.txt is at the new level (level is 2.05)
    5. Deploy the new version of the UDDI Registry from the Network Deployment setup to the base application server following the instructions in the InfoCenter at http://publib7b.boulder.ibm.com/wasinfo1/en/info/ae/ae/twsu_install_singleapp.html called Installing the UDDI Registry into a single application server.
    6. (Optionally) check that the UDDI version.txt in ApplicationServer\installedApps is at the new level (version.txt=2.05).
    7. Restart the base application server and any other web servers or application servers that you previously had running.
  • Location of the Custom Taxonomy Tools

    WebSphere Application Server, Version 5.0.2 includes enhanced support for custom taxonomies within UDDI (for information on this, see Custom Taxonomy Support in the UDDI Registry in the WebSphere Application Server, Version 5.0.2 InfoCenter). After installation of WebSphere Application Server, Version 5.0.2, the custom taxonomy tools can be found in the following locations:

    UDDITaxonomyTools.jar can be found in <DeploymentManager-install-dir>/UDDIReg/scripts. CustomTaxonomy.properties can be found in <DeploymentManager-install-dir>/UDDIReg/scripts. UDDITaxonomyTools.jar provides the tooling for custom taxonomies, and CustomTaxonomy.properties allows you to configure your environment for use within the custom taxonomy tooling.

  • Installing Cloudscape Version 5.1 and post-installation tasks

    If you wish to use Cloudscape Version 5.1 then please refer to Configuring Cloudscape Version 5.1 elsewhere in the InfoCenter for instructions on installing it.

    For instructions in the post installation tasks after installation of Cloudscape Version 5.1 please refer to Cloudscape Version 5.1 post install instructions elsewhere in this InfoCenter. You will need to follow these instructions to convert the Cloudscape database that is supplied with the UDDI Registry to Cloudscape Version 5.1.

  • Uninstalling WebSphere Application Server, Version 5.0.2 from a Network Deployment configuration

    The uninstallation process automatically reinstates the UDDI Registry application to the original version.

  • Uninstalling WebSphere Application Server, Version 5.0.2 from a Base Application Server only configuration

    Follow these steps to uninstall WebSphere Application Server, Version 5.0.2:

    1. Stop all servers.
    2. Uninstall the Network Deployment part of WebSphere Application Server, Version 5.0.2 from the Network Deployment product. This removes this later version and reinstates the original. This is required as the UDDI Registry is packaged with the Network Deployment product.
    3. Uninstall the base part of WebSphere Application Server, Version 5.0.2 from the base WebSphere Application Server product.
    4. (Optionally) check that the Network Deployment DeploymentManager\installableApps is at the correct level. UDDI version.txt=2.03 if you originally had WebSphere Application Server, Version 5 installed, or UDDI version.txt=2.04 if you originally had WebSphere Application Server, Version 5.01 installed. The base application server will still have the UDDI Registry at the later level (UDDI version.txt=2.05).
    5. Redeploy the original version of UDDI Registry from the Network Deployment setup to the base application server following the instructions in the InfoCenter at http://publib7b.boulder.ibm.com/webapp/wasinfo1/index.jsp?deployment=NetworkDeployment&lang;=en called Reinstalling into a single application server.
    6. (Optionally) check that the base application server level is correct (version.txt=2.03 for Version 5, or 2.04 for Version 5.0.1).
    7. Restart the base application server.