Use this topic to initialize a UDDI registry node after setup or migration.
Before you begin
You must have a UDDI registry node set up, either as a new node, or to use for migrating a
UDDI registry Version 2 node.
About this task
You must set some of the properties of a UDDI registry node before you initialize the node.
The UDDI registry node properties are in two categories:
- Mandatory node properties that must be set before the UDDI node can be initialized. You can set
these properties as many times as you want before initialization. However, after the UDDI node is
initialized, these properties are read-only for the lifetime of that UDDI node. It is very important
to set these properties correctly.
- All other properties. You can set these properties before and after initialization.
You can configure these properties and initialize the node by using the UDDI administrative
console or Java™ Management Extensions (JMX) management
interface.
Procedure
-
Click to display the properties page for the UDDI registry node.
-
Set the mandatory node properties to suitable, and valid, values. These properties are
indicated by the presence of an asterisk (*) next to the input field. The following list summarizes
the properties. For more information on each property, see the context help of the administrative
console.
- UDDI node ID
- This property must be a text string that begins with uddi: and that is
unique to this UDDI node. The default value might be suitable, but ensure that it is unique to the
UDDI node before you use it.
- UDDI node description
- This property is a text string that describes the node.
- Root key generator
- This property must be a text string that begins with uddi: and that is
unique to this UDDI node. The default value might be suitable, but might contain text, such as
keyspace_id, that you must modify to match your system. If you use the
default value, ensure that it is unique to this UDDI node.
- Prefix for generated discoveryURLs
- This property must be a valid Uniform Resource Locator (URL).
-
If you are migrating from Version 2 of the UDDI registry, use the following table to complete
the following steps:
- Set any properties from the uddi.properties file that must remain the same
as Version 2.
- Set any properties from the uddi.properties file that you want to keep the
same value, for example, dbMaxResultCount.
Table 1. Version 2 and Version 3 UDDI properties. The table lists the different UDDI properties for Version 2 and Version 3, along with
additional information about each one.
| Version 2 UDDI property (which is set in uddi.property
file) |
Version 3 UDDI property (which is set by using the administrative
console or UDDI Administrative Interface) |
Recommended Version 3 UDDI property setting |
| dbMaxResultCount |
Maximum inquiry response set size |
You can retain the value from Version 2, change the value, or use the
default. |
| persister |
No equivalent |
Not applicable. |
| defaultLanguage |
Default language code |
Retain the value from Version 2 |
| operatorName |
UDDI node ID |
You must use a valid value for the UDDI node ID. This value is applied to your
Version 2 data as it is migrated. |
| maxSearchKeys |
Maximum search keys |
You can retain the value from Version 2, change the value, or use the
default. |
| getServletURLprefix |
Prefix for generated discoveryURLs |
Enter a valid value for your configuration, which is the same as the value
used for Version 2. |
| getServletName |
No equivalent |
Not applicable. |
-
Set any other properties, such as policy values, that you want to change from the default
settings. For an explanation of policies and properties, see the topic about UDDI node
settings.
Remember that you can also change these properties later.
-
Click Apply to save the changes.
Important: Ensure that the mandatory node properties are set to appropriate values and
that you have saved them, because you cannot change them after initialization. If you do not save
your changes before proceeding to the initialize step, you will have to delete and recreate the
database.
-
After saving the changes, initialize the UDDI node by clicking
Initialize, at the beginning of the pane.
If you are migrating from Version 2 of the UDDI registry, the Version 2 data is migrated now. The
initialization might take some time to complete; to track its progress, return to the node
collection page and click the refresh icon at the beginning of the
Status
column. Alternatively, open a second administrative console window, and use the refresh icon in the
same way. The UDDI node goes through the following states:
- Initialization pending.
- Initialization in progress.
- Migration in progress. This state occurs only if you are migrating.
- Value set creation in progress.
- Activated.
What to do next
If you migrated the node from a previous version, return to the steps in the procedure to
migrate to Version 3 of the UDDI registry, to verify that the migration was successful. If you
created a new node, follow the steps in Using the UDDI registry installation verification test (IVT) to verify that you have
successfully set up the UDDI node.