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 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 perform 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.
Version 2 UDDI property (which
is set in uddi.property file) |
Version 3 UDDI property (which
is set 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 UDDI node settings. Remember
that you can also change these properties later.
- Click Apply to save your 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 your 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.