Installing and setting up a UDDI Registry

Before you begin

If you wish to use the UDDI User Console using Internet Explorer as your Web browser, and using SSL, you must use Internet Explorer V5.5 with SP2 and security fix Q321232 (which must be applied in that order), or later.

If you are migrating from IBM WebSphere UDDI Registry running on an earlier version of WebSphere , read Migrating from a previous version of IBM WebSphere before installing the new product.

To install the UDDI Registry onto the z/OS platform, access Unix System Services (USS), using for example telnet or Open Edition MVS, then issue the Unix commands described in this task.

Choice of database product to be used as the persistence store

The UDDI Registry application can use either DB2 or Cloudscape as the persistence store for the registry data.

Cloudscape Restriction

Cloudscape Network Server Version 5.1 requires a WebSphere Version 5 datasource to utilize the multiple connection features. As IBM WebSphere UDDI Registry uses a WebSphere Version 4 datasource, this precludes other connections to the Cloudscape database when the UDDI Registry application is in the started state.

Why and when to perform this task

As part of the installation of the IBM WebSphere Application Server with Network Deployment option, you are given the option to install the "UDDI Registry", which is shown under Web Services.

Having selected the UDDI Registry and installed the various files that make up the application, you have two choices as to the environment in which you run it:

  1. Install the UDDI Registry application into the deployment manager cell using DB2 or Cloudscape as the database in which the UDDI Registry data will be held, selecting one of the application servers within the cell in which to run the UDDI Registry.
  2. Install the UDDI Registry application directly into an application server using DB2 or Cloudscape as the database in which the UDDI Registry data will be held. If you choose this option, the application server on which you run the UDDI Registry must not be added into a deployment manager cell, as this would cause the file synchronization within the cell to remove the application.
In most cases you will probably choose option 1, and install the UDDI Registry into a deployment manager cell, but you might find that option 2, to install the UDDI Registry into a standalone application server, is useful for development or test purposes.

Note:

  1. Several WebSphere commands are used during the following procedures, some of which must execute on the DeploymentManager and some of which must execute on the target Application server. The instructions distinguish which is appropriate for each command. The WebSphere commands are in the /bin subdirectory of the appropriate WebSphere install tree. To ensure correct operation of these commands, do one of the following:
    • Ensure that the appropriate bin subdirectory is in your path prior to executing the command
    • Change directory to the appropriate bin subdirectory
    • Fully qualify the path to the commands
  2. It is recommended that you use the version of Java shipped with WebSphere and found in the java/bin subdirectory.
  3. It is also recommended that you execute setupCmdline.bat (on Windows) or source . /setupCmdline.sh on Unix platforms, prior to executing any WebSphere commands.

The following table lists the UDDI Registry files, and the locations into which they are placed by the installation. The Location column shows the subdirectory under the WebSphere DeploymentManager install directory. For Windows platforms, read the "/" directory separator in the location column as a "\" directory separation character.

Files Purpose Location
uddi.ear The UDDI Registry application itself, which is packaged and runs as an enterprise application installableApps
uddi.properties Provides configuration properties for the UDDI Registry application properties
uddiresourcebundles.jar Contains system messages for the UDDI Registry application lib
uddicloudscapeuserfunc.jar Contains functions that are used by Cloudscape if the Cloudscape database is used with the UDDI Registry lib
setupuddi.jacl Administrative script to create a JDBC driver and datasource for the UDDI Registry, and to install the UDDI Registry application in a DeploymentManager Cell UDDIReg/scripts
setupuddimessages.jar Contains setup and install messages for the UDDI Registry application lib
removeuddi.jacl Administrative script to undo the effects of setupuddi.jacl UDDIReg/scripts
appserverremoveuddi.jacl Administrative script to undo the effects of appserversetupuddi.jacl UDDIReg/scripts
appserversetupuddi.jacl Administrative script to create a JDBC driver and datasource for the UDDI Registry, and to install the UDDI Registry application in a single, stand-alone, application server UDDIReg/scripts
SetupDB2UDDI.jar The 'UDDI DB2 Setup Wizard', to create and pre-load the UDDI Registry database if DB2 is to be used as the persistence store UDDIReg/scripts
UDDI20 (directory) Cloudscape directory containing the UDDI Registry tables and pre-loaded data bin
uddiejbclient.jar Class library for use when writing an EJB client to access the UDDI Registry UDDIReg/ejb
Various javadoc files JAVADOC to describe the EJB interface to the UDDI Registry UDDIReg/ejb/javadoc
UDDITaxonomyTools.jar Provides tools for supporting custom taxonomies with the UDDI Registry UDDIReg/scripts
CustomTaxonomy.properties Provides configuration properties to be used the the UDDITaxonomyTools UDDIReg/scripts
UDDIUtilityTools.jar Provides support for import/export of UDDI entities UDDIReg/scripts
UDDIUtilityTools.properties Provides configuration properties for the UDDI Utility Tools UDDIReg/scripts


What to do next

If you intend to run in a Deployment Manager Cell then complete the following task - Installing the UDDI Registry into a deployment manager cell

If you intend to run in a single WebSphere Application server, then complete the following task - Installing the UDDI Registry into a single WebSphere Application Server


Related tasks
Enabling Universal Description, Discovery and Integration (UDDI)



Searchable topic ID:   twsu_install
Last updated: Jun 21, 2007 8:07:48 PM CDT    WebSphere Business Integration Server Foundation, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.wasee.doc/info/ee/ae/twsu_install.html

Library | Support | Terms of Use | Feedback