Initializing the UDDI Registry node

Use this topic to initialize a UDDI Registry node after set up or migration.

 

Before you begin

You must have already set up a UDDI Registry node, either as a new node or to use for migrating a UDDI Registry V2 node.

 

Overview

The UDDI Registry node has various properties, some of which must be set before initializing the node. There are two categories of UDDI Registry node properties:

  • Mandatory node properties. These properties must be set before the UDDI node can be initialized. You may set these properties as many times as you wish before initialization. However, once the UDDI node has been initialized, these properties will become read only for the lifetime of that UDDI node. It is very important to set these properties correctly.

  • All other properties. These properties may be set before, and after, initialization.

Configure these properties and initialize the node using the UDDI administrative console or JMX management interface.

 

Procedure

  1. Click UDDI > UDDI Nodes > UDDI_node_id to display the properties page for the UDDI Registry node.

  2. Set the mandatory node properties to suitable, and valid, values. These properties are indicated by the presence of a '*' next to the input field. The properties are listed below; more information on each property is given in the context help of the administrative console.

    UDDI node ID

    This must be a text string beginning with 'uddi:' that is unique to this UDDI node. The default value may be sufficient, but if you accept it you should ensure that it is unique.

    UDDI node description

    This is a text string describing the node.

    Root key generator

    This must be a text string beginning with 'uddi:' that is unique to this UDDI node. The default value may be sufficient but may contain text, such as 'keyspace_id', that you should modify to match your system. If you accept the default value, ensure that it is unique for this UDDI node.

    Prefix for generated discoveryURLs

    This should be a valid URL.

  3. If you are migrating from V2 of the UDDI Registry, use the table below to perform the following steps:

    • Set any properties from uddi.properties that must remain the same as V2.

    • Set any properties from uddi.properties that you would like to keep the same (such as dbMaxResultCount).

    V2 UDDI property (set in uddi.property file) V3 UDDI Property (set via Administrative Console or UDDI Administrative Interface) Recommended V3 UDDI property setting
    dbMaxResultCount maximum inquiry response set size You might want to retain the value from V2, but can safely change this (or use the default)
    persister no equivalent Not applicable
    defaultLanguage default language code You are recommended to retain the value from Version 2
    operatorName UDDI node ID You must use a valid value for the UDDI node ID. This will be applied to your V2 data as it is migrated.
    maxSearchKeys maximum search keys You might want to retain the value from V2, but can safely change this (or use the default)
    getServletURLprefix Prefix for generated discoveryURLs You should enter a valid value for your configuration, which should therefore be the same as the value used for V2.
    getServletName no equivalent Not applicable

  4. Set any other properties, such as policy values, that you wish to change from the default settings (or these can be changed at a later time). For an explanation of policies and properties see Manage the UDDI Registry.

  5. Once the properties have been set to appropriate values, click Apply to save your changes. It is important to save the changes before proceeding to the initialize step.

  6. Initialize the UDDI node by clicking Initialize, at the top of the pane. If you are migrating from V2 of the UDDI Registry, the V2 data is migrated now. The initialization may take some time to complete.

 

What to do next

If the node has been migrated from a previous version, return to Migrating to V3 of the UDDI Registry to verify that the migration was successful. If you have created a new node, you are now ready to use the UDDI Registry.


 

Related Tasks


Migrating to V3 of the UDDI Registry