Oracle9iAS Portal Developer Kit

Node registration

The wwpro_api_node_registry package contains Oracle Portal node registration APIs. These methods are used by the portlet provider administration UI and by developers to register provider nodes and to create connection paths (database links) to remote nodes.

Methods in this package are deprecated in Oracle9iAS Portal 9.0.2. Only the get_local_node_id function remains valid. The functionality has been replaced with a set of provider group APIs.

Note:

Node registration

Node registration is the process of storing information about remote nodes in the local node. The local node is created during Oracle Portal installation. All other nodes are remote nodes. When a remote node is registered, all providers local to the remote node that have their Accept Registration flag set will be registered to the local node.

Database links to the local node

For each remote node, a database link is made from the local to the remote node. This link can be defined as a Net8 connect identifier or Net8 connect descriptor.

  • A Net8 connect identifier uses predefined parameters to locate the desired node and to create the database link. If a node's database link is created as a connect identifier, the link is created with the DB_LINK_HOST as that identifier. When a link is established, the identifier is sent to Net8 to be resolved into a Net8 connect descriptor.

  • A Net8 connect descriptor provides Net8 with the data it needs to make the connection to the remote node. If a node's database link is created as a connect descriptor, then the DB_HOST_ADDRESS, DB_HOST_PORT and DB_HOST_SERVICE_NAME are used to form a descriptor. That descriptor is used in the creation of the database link. When a link is established, the descriptor is sent to Net8 and is recognized by Net8 as a descriptor, not an identifier.

Editing remote node information

The database link for a remote node is created when the remote node is registered. Each time a remote node is edited, the database link is dropped and recreated.

Term

Definition

node

An Oracle Portal installation. There can be more than one Oracle Portal instance (installation) on an Oracle 8i installation.

local node

The current Oracle Portal installation.

Net8

A component product of the standard Oracle networking package that enables network servers to easily communicate with one another.

node registration

The process of storing information about a remote Oracle Portal installation in the current Oracle Portal instance to make remote providers available in the local node.

remote node

An Oracle Portal installation other than the current (local) installation.

Remote providers

Portlet providers installed on nodes other than the local node.

 

Related topics

The PL/SQL API Reference is part of the Portal Developer Kit on Portal Studio