21 WebLogic Server Foreign JNDI Providers

This chapter describes the tasks you can perform to create, monitor, and configure foreign JNDI providers. A foreign JNDI provider represents a JNDI tree that resides outside of a WebLogic Server environment. This could be a JNDI tree in a different server environment or within an external Java program. By setting up a foreign JNDI provider you can lookup and use a remote object with the same ease as using an object bound in your WebLogic Server instance. In other words, you can access local and remote objects using a single WebLogic Server connection.

Note:

If you are logged into a domain partition, navigate from the Domain Partition menu.

This chapter includes the following sections:

• Create foreign JNDI providers

• Monitor foreign JNDI providers

• Configure foreign JNDI providers

Create foreign JNDI providers

To create a new foreign JNDI provider:

1. From the WebLogic Domain menu, select Other Services, then select Foreign JNDI Providers.

   The Foreign JNDI Provider table displays information about the foreign JNDI providers that have been configured in the current WebLogic Server domain.

2. Click Create.
3. Define the configuration settings for your new foreign JNDI provider on each of the following pages:

   • General Configuration

   • Targets

   • Review

4. Click Create.

General Configuration

On the General Configuration page, you can define general configuration settings for your new foreign JNDI provider:

• Name: enter a name for the foreign JNDI provider.

• Scope: select the scope for this foreign JNDI provider.

• Initial Context Factory: enter the name of the class that must be instantiated to access the JNDI provider. This class name depends on the JNDI provider and the vendor that are being used. The value corresponds to the standard JNDI property, java.naming.factory.initial.

• Provider URL: enter the URL that WebLogic Server will use to contact the JNDI provider. This value corresponds to the standard JNDI property, java.naming.provider.url.

• User: enter the name of a user authorized to access the foreign JNDI.

• Password: enter the user password.

• Confirm Password: confirm the user password.

• Properties: click Add to specify any additional properties that must be set for the JNDI provider. These properties will be passed directly to the constructor for the JNDI provider's InitialContext class. Express each property as a name=value pair, separated by commas.

For more information about these fields, see Configuration Options.

Targets

On the Targets page, select the server instances and clusters on which you want to target the new foreign JNDI provider.

For more information, see Configuration Options.

Review

On the Review page, review the configuration for this foreign JNDI provider.

For more information, see Configuration Options.

Monitor foreign JNDI providers

To monitor the foreign JNDI providers configured in the domain:

1. From the WebLogic Domain menu, select Other Services, then select Foreign JNDI Providers.

   The Foreign JNDI Providers table displays information about the foreign JNDI providers that have been configured in the current WebLogic Server domain, such as:

   • Name

   • Initial Context Factory

   • Provider URL

   • User

   • Scope

   • Resource Group / Template

   • Domain Partitions

   • Targets

   For more information about these fields, see Configuration Options.

Optionally, select View to access the following table options:

• Columns: add or remove the columns displayed in the table

• Detach: detach the table (viewing option)

• Sort: sort the columns in ascending or descending order

• Reorder: change the order of the columns displayed

• Query by Example

Configure foreign JNDI providers

A foreign JNDI provider represents a JNDI tree that resides outside of a WebLogic Server environment. This could be a JNDI tree in a different server environment or within an external Java program. By setting up a foreign JNDI provider you can lookup and use a remote object with the same ease as using an object bound in your WebLogic Server instance. In other words, you can access local and remote objects using a single WebLogic Server connection.

This section includes the following tasks:

• Configure foreign JNDI provider general settings

• Configure foreign JNDI object links

• Create foreign JNDI object links

• Configure a foreign JNDI object link

• Configure tags for a foreign JNDI provider

• Target a foreign JNDI provider

• Create foreign JNDI provider notes

Configure foreign JNDI provider general settings

To configure general settings for a specific foreign JNDI provider:

1. From the WebLogic Domain menu, select Other Services, then select Foreign JNDI Providers.
2. In the Foreign JNDI Provider table, select the name of the foreign JNDI provider you want to configure.
3. Select Configuration, then select General.
4. From the General Settings page, you can view and define configuration information for this foreign JNDI provider, such as:

   • Name

   • Scope

   • Initial Context Factory

   • Provider URL

   • User

   • Password

   • Confirm Password

   • Properties

   For more information about these fields, see Configuration Options.

5. Click Apply.

Configure foreign JNDI object links

A foreign JNDI object link represents a local link to an object in a foreign (remote) JNDI tree. After you create a foreign JNDI provider you can add foreign JNDI links that set up a relationship between a name in your local JNDI tree and the object in the remote tree.

To configure foreign JNDI object links:

1. From the WebLogic Domain menu, select Other Services, then select Foreign JNDI Providers.
2. In the Foreign JNDI Provider table, select the name of the foreign JNDI provider you want to configure.
3. Select Configuration, then select Links.
4. From the Links page, you can view configuration information about the foreign JNDI object links associated with this foreign JNDI provider, such as:

   • Name

   • Local JNDI Name

   • Remote JNDI Name

   For more information about these fields, see Configuration Options.

5. To create a new foreign JNDI link, click Create. See Create foreign JNDI object links.
6. To delete an existing foreign JNDI link, select the foreign JNDI link and click Delete.

Create foreign JNDI object links

To create object links to a foreign JNDI provider:

1. From the WebLogic Domain menu, select Other Services, then select Foreign JNDI Providers.
2. In the Foreign JNDI Provider table, select the name of the foreign JNDI provider to which you want to create object links.
3. Select Configuration, then select Links.
4. Click Create.
5. Define the configuration settings for your new foreign JNDI object link on each of the following pages:

   • General Configuration

   • Review

6. Click Create.

General Configuration

On the General Configuration page, you can define general configuration settings for your new foreign JNDI object link

• Name: enter a name for the foreign JNDI link.

• Local JNDI Name: specify the name that the remote JNDI object will be bound to in the local server's JNDI tree and used to look up the object on the local server.

• Remote JNDI Name: specify the name of the remote object that will be looked up in the foreign JNDI directory.

For more information about these fields, see Configuration Options.

Review

On the Review page, review the configuration for this foreign JNDI object link.

For more information, see Configuration Options.

Configure a foreign JNDI object link

A foreign JNDI object link represents a local link to an object in a foreign (remote) JNDI tree. After you create a foreign JNDI provider you can add foreign JNDI links that set up a relationship between a name in your local JNDI tree and the object in the remote tree.

This section includes the following tasks:

• Configure foreign JNDI link general settings

• Create foreign JNDI link notes

Configure foreign JNDI link general settings

To configure general settings for a foreign JNDI object link:

1. From the WebLogic Domain menu, select Other Services, then select Foreign JNDI Providers.
2. In the Foreign JNDI Provider table, select the name of the foreign JNDI provider you want to configure.
3. Select Configuration, then select Links.
4. In the Foreign JNDI Links table, select the name of the foreign JNDI object link you want to configure.
5. Select General.
6. From the General page, you can configure general information about this foreign JNDI object link, such as:

   • Name

   • Local JNDI Name

   • Remote JNDI Name

   For more information about these fields, see Configuration Options.

7. Click Apply.

Create foreign JNDI link notes

To create notes to describe the configuration of this foreign JNDI link:

1. From the WebLogic Domain menu, select Other Services, then select Foreign JNDI Providers.
2. In the Foreign JNDI Provider table, select the name of the foreign JNDI provider you want to configure.
3. Select Configuration, then select Links.
4. In the Foreign JNDI Links table, select the name of the foreign JNDI object link you want to configure.
5. Select Notes.
6. On the Notes page, enter your notes.

   For more information, see Configuration Options.

7. Click Save.

Configure tags for a foreign JNDI provider

To configure tags for a specific foreign JNDI provider:

1. From the WebLogic Domain menu, select Other Services, then select Foreign JNDI Providers.
2. In the Foreign JNDI Provider table, select the name of the foreign JNDI provider you want to configure.
3. Select Tags.
4. On the Tags page, you can configure the tags associated with this foreign JNDI provider:

   • In Add new tag, create a new tag by entering the tag name.

   • In Tags, move existing tags from the Available column to the Chosen column to associate these tags with foreign JNDI provider.

   For more information, see Configuration Options.

5. Click Apply.

Target a foreign JNDI provider

To target a specific foreign JNDI provider:

1. From the WebLogic Domain menu, select Other Services, then select Foreign JNDI Providers.
2. In the Foreign JNDI Provider table, select the name of the foreign JNDI provider you want to configure.
3. Select Targets.
4. From the Targets page, you can specify the WebLogic Server instances and clusters to which you want to target this foreign JNDI provider.

   For more information, see Configuration Options../FMWCH/pagehelp/Corecorejndiforeignjndiprovidertargetdeploytitle.html.

5. Click Save.

Create foreign JNDI provider notes

To create notes to describe the configuration of this foreign JNDI provider:

1. From the WebLogic Domain menu, select Other Services, then select Foreign JNDI Providers.
2. In the Foreign JNDI Provider table, select the name of the foreign JNDI provider you want to configure.
3. Select Notes.
4. On the Notes page, enter your notes.

   For more information, see ../FMWCH/pagehelp/Corecorejndiforeignjndiprovidernotestitle.htmlConfiguration Options.

5. Click Save.