Novell UDDI Services 2.0

Installation and Deployment Instructions

Table of Contents

1.0 Supported Platforms
2.0 Software Requirements
3.0 System Requirements
4.0 Directory Structure
5.0 Deploying UDDI Services
6.0 Publishing and Inquiring
7.0 Verifying the Deployment
8.0 Undeploying UDDI Services

1.0 Supported Platforms

• All platforms supported by Novell® exteNd™ Application Server 5.0

2.0 Software Requirements

• Novell exteNd Application Server 5.0
• Novell exteNd Workbench 4.1.1
• Novell exteNd Composer 4.1 with UDDI v2 patch
• Internet Explorer 5.5 Support Pack 2 or Netscape Navigator 7.0 or later

3.0 System Requirements

• Same as Novell exteNd Application Server 5.0. However, the minimum memory requirement is 512 MB.

4.0 Directory Structure

The NOVELL_EXTEND_APPSERVER_HOME/UDDI/config directory contains the following directories and files:

• conf - is the directory that contains the UDDI configuration and related files.
• logs - is the directory where UDDI logs are created.
• conf/TreeData.xld - is the XLDAP repository file. All UDDI data is stored in this file by the XLDAP server.
• conf/uddi.conf - is called the UDDI Bootstrap file. This file contains the hostname, ldap port number, and the backend repository used by the UDDI server.
• conf/uddi-file.conf - is the UDDI configuration file. Administrators can modify this file to alter the behavior of the UDDI Server. The changed information will take effect during the next reconfiguration interval specified in this file.
• conf/uddi_v2.xsd - is the standard UDDI v2 XML schema definition file. The UDDI Server validates the UDDI requests encapsulated within SOAP requests against this schema definition.

5.0 Deploying UDDI Services

When you install the Novell exteNd Application Server 5.0 with UDDI Services, the install files for UDDI Services will be copied to the NOVELL_EXTEND_APPSERVER_HOME/UDDI directory, where NOVELL_EXTEND_APPSERVER_HOME is the directory where the exteNd 5 Application Server is installed.

1. Create a UDDI configuration directory (for example, /home/UDDI/config) with rwx permissions for appropriate users.
2. Copy the NOVELL_EXTEND_APPSERVER_HOME/UDDI/conf and NOVELL_EXTEND_APPSERVER_HOME/UDDI/logs directories to the UDDI configuration directory and grant rwx permission to these directories for appropriate users.
3. Verify the contents of the UDDI/conf directory. The following files with the appropriate file permissions should exist:

   Filename	Read	Write	Execute
   TreeData.xld	yes	yes	no
   uddi.conf	yes	yes	no
   uddi-file.conf	yes	yes	no
   uddi_v2.xsd	yes	no	no

4. Open the UDDI_Dep_Plan.xml file from the NOVELL_EXTEND_APPSERVER_HOME/UDDI/install directory and enter the values for the following parameters:

   • uddiconf.dir - is the UDDI configuration directory that contains the conf and logs directory. For example, /home/UDDI/config.
   • debug - is the parameter that enables the XLDAP debug messages to be displayed on the Application Server Console. The default value is false. Changing it to true will enable debug messages.
   • ldapport - is the ldapport number on which the XLDAP server will be started. Enter a non-standard port number that is not being used by any other process on the system.
     

5. You can now deploy UDDI Services. Ensure that the Application Server is up and running.
   At the command prompt, enter:

   SilverCmd DeployWAR hostname:port dbname path/novelluddi.war -f path/UDDI_Dep_Plan.xml -U username -P password -o -v 5

   where hostname is the hostname or IP address of the server running exteNd Application Server and port is its port number,
   dbname is the SilverMaster database name,
   username is the exteNd Application Server administrator name or equivalent, and
   password is your password.

   The -o option overwrites the already deployed UDDI Services, and the -v 5 option is a complete verbose list of the deployment operation.

   The following message is displayed if the deployment has completed successfully:

   Completed deployment to the server for the WAR novelluddi (novelluddi.war)
   Deployment completed successfully.

6.0 Publishing and Inquiring

If you are using Composer 4.1, make sure that it is updated with the UDDI v2 patch. This is the xwb-wsdl-uddi.jar file that should be placed in the designer/lib directory. This patch can be obtained from Novell Technical Support. This is not required if you are using Workbench 4.1.1.

In order to publish and inquire Web services information using the deployed UDDI Services, see Section 4 of the UDDI Services User Guide available in the NOVELL_EXTEND_APPSERVER_HOME/UDDI/doc directory.

7.0 Verifying the Deployment

1. Open the Novell Application Server Management Console (SMC), connect to the Application Server, and view the deployed objects.
   You should see the 'novelluddi' object under the SilverMaster database name.

2. Check if the UDDI Server is up and running by entering the following URL in your browser window:
   http://hostname:port/novelluddi/servlet/rpcrouter
   where hostname is the hostname or IP address of the server running exteNd Application Server and port is its port number.

   The following message is displayed.

   UDDI Server Status
   The server has been initialized successfully.

   This indicates that UDDI Services has been successfully deployed, initialized, and running fine.

8.0 Undeploying UDDI Services

Ensure that the Application server is up and running.

At the command prompt, enter the following:

SilverCmd Undeploy hostname:port dbname novelluddi

Or

Use the undeploy option in SMC to undeploy the 'novelluddi' object, which will undeploy UDDI Services.