Skip navigation.
Downloads | Product Documentation | Support

Administration Console Online Help

# Configure foreign servers

A Foreign Server represents a JNDI provider that is outside WebLogic server. It contains information that allows a local WebLogic Server instance to reach a remote JNDI provider, thereby allowing for a number of foreign connection factory and destination objects to be defined on one JNDI directory.

After defining a foreign server, you can configure foreign connection factory and destination objects (queues or topics). You can configure one or more foreign connection factories and destinations for each foreign server.

To configure a foreign server:

1. In the Administration Console, navigate to the topic resource that you want to configure:
   - Navigate to JMS Resources in System Modules
   - Navigate to JMS resources in an application module
2. Create foreign servers in a system module

   After creating a basic foreign server, define a foreign connection factory and foreign destinations:

   1. Create foreign connection factories

      A Foreign Connection Factory contains the JNDI name of the connection factory in the remote JNDI provider, the JNDI name that the connection factory is mapped to in the local WebLogic Server JNDI tree, and an optional user name and password.

   2. Create foreign destinations

      A Foreign Destination represents either a queue or a topic. It contains the destination JNDI name that is looked up on the foreign JNDI provider and the JNDI name that the destination is mapped to on the local WebLogic Server.

3. If you skipped the targeting step when you created a foreign server, or want to change a foreign server's selected subdeployment, you can do so at anytime. See Specify subdeployments for foreign servers.
4. Save your changes:
   - Save Changes to JMS Resources in System Modules
   - Save changes to JMS resources in an application module

Related Tasks

- Delete foreign servers
- Delete foreign destinations
- Delete foreign connection factories

Related Topics

- Configuring Clustered WebLogic JMS Resources
- Enhanced J2EE Support for Using WebLogic JMS With EJBs and Servlets