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 top 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 top 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.