Software AG Products 10.5 | Administering Integration Server | Configuring Integration Server for JMS Messaging | Working with JNDI Providers | Creating a JNDI Provider Alias
 
Creating a JNDI Provider Alias
Use the following procedure to create an alias to a JNDI provider.
*To create a JNDI provider alias
1. Open Integration Server Administrator if it is not already open.
2. In the Settings menu of the Navigation panel, click Messaging.
3. Under JMS Configuration, click JNDI Settings.
4. Click Create JNDI Provider Alias.
5. Specify the following information for the JNDI provider alias:
Field
Description
JNDI Alias Name
The alias name that you want to assign to this JNDI provider.
Description
A description for this JNDI alias.
Predefined JNDI Templates
The JNDI template that you want to use.
The JNDI templates provide information that you can use to complete alias configuration for a specific provider.
Note:
After you create a JNDI provider, Integration Server Administrator displays Current Settings as the value of the Predefined JNDI Templates field. This indicates that Integration Server uses the currently specified settings for the JNDI provider alias.
Initial Context Factory
The class name of the JNDI provider. The JNDI provider uses the initial context as the starting point for resolving names for naming and directory operations.
If you selected a predefined JNDI template, Integration Server displays the initial context factory for the provider.
Provider URL
The primary URL of the initial context for sessions with the JNDI provider. The URL specifies the JNDI directory in which the JNDI provider stores JMS administered objects.
If you selected a predefined JNDI template, replace the placeholder information in brackets << >> with information specific to your configuration.
If you are using Software AG Universal Messaging, this is the Universal Messaging realm server in the format nsp://UM_host:UM_port (for example, nsp://127.0.0.1:9000).
If you are using a cluster of Universal Messaging realm servers, supply a list of the URLs to each realm server in the cluster. Use a colon or semi-colon to separate each URL:
*Separate the URLs using a comma if Integration Server always attempts to connect to the first Universal Messaging server in the list, only trying the second Universal Messaging server in the list if the first server becomes unavailable
*Separate the URLs using a semicolon if Integration Server connects to a randomly chosen URL from the list. This may result in better distribution of clients across the servers in the cluster.
Note:
You must specify a URL for every Universal Messaging server in the cluster. Integration Server connects only to the Universal Messaging servers for which you specify a URL. Consequently, Integration Server creates resources such as destinations or durable subscribers on the specified Universal Messaging servers. If you specify only one Universal Messaging server in a cluster, the resources will be local to that server only.
Note:
If the JMS connection alias uses this JNDI provider alias to connect to Universal Messaging cluster and the JMS connection alias is configured to follow the master, Integration Server always connects to the master realm server in the cluster. By default, Integration Server is configured to follow the master realm server in a cluster. Software AG recommends using a comma-separated list of URLs if the JMS connection alias follows the master. For more information about the Enable Follow the Master option for a JMS connection alias, see Creating a JMS Connection Alias
Provider URL Failover List
A list of the failover URLs of the initial context for sessions with the JNDI provider. Specify one URL per line. If the connection to the primary JNDI provider becomes unavailable, Integration Server automatically attempts a connection to a JNDI provider specified in this list.
For more information about setting up a JNDI provider failover list, see Creating a JNDI Provider Failover List.
Security Principal
The principal name, or user name supplied by Integration Server to the JNDI provider, if the provider requires one for accessing the JNDI directory.
For information about whether or not the JNDI provider requires security principal information, consult the product documentation for the JNDI provider.
Security Credentials
The credentials, or password, that Integration Server provides to the JNDI provider, if the provider requires security credentials to access the JNDI directory.
For information about whether or not the JNDI provider requires security credentials, consult the product documentation for the JNDI provider.
Other Properties
Any additional properties the JNDI provider requires for configuration. For example, you might need to specify the classpath for any additional .jar or class files that the JNDI provider needs to connect to the JNDI.
When you select a predefined JNDI template, Integration Server populates this field with any additional properties and placeholder information required by the JNDI provider.
For more information about additional properties or classes required by a JNDI provider and the location of those files, see the product documentation for the JNDI provider.
6. Use SSL: If you want to establish a secure communication between Integration Server and the JNDI provider, choose Yes and set up the parameters in SSL Settings and JNDI Property Names (Provider Specific). By default, the value is No.
7. In SSL Settings, specify the following:
Field
Description
Truststore Alias
The alias for the truststore that contains the certificates of the Certificate Authority (CA) for the JNDI provider.
You must select a truststore alias or a keystore alias if you want to set up SSL communication.
Keystore Alias
The alias for the keystore that contains the client certificates for Integration Server to use when connecting to the JNDI provider.
Key Alias
The alias to the key that contains the private key for connecting to the JNDI provider. The key alias must be in the keystore specified in Keystore Alias.
8. In JNDI Property Names (JNDI Provider Specific), specify the following:
Field
Description
Truststore Property Name
The JNDI property name for storing the truststore location.
The JNDI property name for the truststore location is mandatory if you set up Truststore Alias in SSL Settings.
Truststore Password Property Name
The JNDI property name for storing the truststore password.
The JNDI property name for the truststore password is mandatory if you set up Truststore Alias in SSL Settings.
Keystore Property Name
The JNDI property name for storing the keystore location.
The JNDI property name for the keystore location is mandatory if you set up Keystore Alias in SSL Settings.
Keystore Password Property Name
The JNDI property name for storing the keystore password.
The JNDI property name for the keystore password is mandatory if you set up Keystore Alias in SSL Settings..
Keystore Format Property Name
The JNDI property name for storing the keystore format. This field is optional.
Private Key Property Name
The JNDI property name for storing the private key name. This field is optional.
9. Click Save Changes.