You use the Global Resources module to add and configure JNDI Providers and SMTP Servers and make them available in ALSB as system resources.
Viewing JNDI Providers
Use this page to view a list of JNDI Providers and the information shown in Table 28-1.
Additionally, you can search for JNDI Providers that you have previously configured.
To restrict the number of items in the list or locate specific JNDI Providers:
Click the Open icon to display additional search filters. If you specify multiple search criteria, only results that match all the criteria will be returned.
Enter the name of the JNDI Provider you want to find in the Name field, and click Search to search for a specific entry.
You can enter wildcard characters (? for a single character; * for multiple characters) to perform a more general search.
Enter the Provider URL of the JNDI Provider you want to find, and click Search.
Click View All to remove the search filters and display all the JNDI Provider resources that are configured to work with ALSB.
Enabled or Disabled. When enabled, the JNDI context and JNDI objects are cached locally which improves performance when doing an object lookup. BEA recommends that you keep the JNDI cache enabled.
Actions
Click the Reset icon to reset the JNDI context to discard the JNDI connection and locally cached objects.
Click the Launch Test Consoleicon to test whether the JNDI Provider can successfully establish a connection and obtain a JNDI context.
Options
Click the Rename icon to rename the JNDI Provider.
You add and configure a JNDI Provider resource and make it available in ALSB as a system resource. You must be in an active session.
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select System Administration > JNDI Providers.
Click Add.
In the Name field, enter a name for the JNDI Provider resource. This is a required field.
In the Description field, enter a short description for the JNDI Provider.
Keep the JNDI Cache option Enabled (default) or select Disabled.
When enabled, the JNDI context and JNDI objects are cached locally which improves performance when doing an object lookup. BEA recommends that you keep the JNDI cache enabled.
In the Provider URL field, enter the URL for the JNDI Provider in the format: protocol://host:port
You can use any protocol, for example, http, https, t3, t3s, iiop, iiops.
This is a required field.
In the case of clusters, the JNDI Provider URL should be configured with a comma-separated list of Managed Servers, in the format:
If access to the target JNDI Provider requires a user name and password, enter a user name in the User Name field, and the associated password in the Password and Confirm Password fields.
These fields are optional, and required only if the JNDI tree is secured.
Click Save to create and save the JNDI Provider resource in the current session.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Editing JNDI Providers
Use this page to view the details of a JNDI Provider and edit the configuration, if required. Additionally, you can reset the JNDI Provider cache and to test the connection to the JNDI Provider.
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
The View JNDI Provider - Configuration page displays the JNDI Provider information shown in Table 28-2.
Table 28-2 JNDI Provider Information
Property
Description
Last Modified By
The user who created or modified this JNDI Provider resource, or imported it into the configuration.
Last Modified On
The date and time that the user created or modified this JNDI Provider resource, or imported it into the configuration. Click the date and time link to view the change history of this resource. See View Change History page.
References
The number of objects that this JNDI Provider references. If such references exist, click the numeric link to view a list of the references. See Viewing References to Resources.
Referenced By
The number of objects that reference this JNDI Provider. If such references exist, click the numeric link to view a list of the objects. See Viewing References to Resources.
Description
A description of this JNDI Provider.
JNDI Cache
Enabled or Disabled. When enabled, the JNDI context and JNDI objects are cached locally which improves performance when doing an object lookup. BEA recommends that you keep the JNDI cache enabled.
Provider URL
The URL for the JNDI Provider.
User Name
The user name used to access a secure JNDI Provider.
Click Edit to display the Edit JNDI Provider - [provider-name] page.
The Name field is not editable.
In the Description field, you can edit the short description of the JNDI Provider.
In the Provider URL field, you can edit the URL of the JNDI Provider.
You can edit the User Name and Password fields.
If the JNDI Provider was configured with a user name and password, then the User Name will not be editable. You can edit the New Password and Confirm Password fields. If the JNDI was not configured with a user name and password, then the User Name field will be editable, and you can enter a new user name.
Click Save to commit the updates in the current session.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Deleting JNDI Providers
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select System Administration > JNDI Providers.
In the Summary of JNDI Providers page, select a JNDI Provider. You can also search for a specific JNDI Provider using the Search option. See Viewing JNDI Providers.
Click the Delete icon in the Options field of the JNDI Provider you want to delete. A Deletion Warning icon is displayed when other resources reference this resource. You can delete the resource with a warning confirmation. This might result in conflicts due to unresolved references to the deleted resource.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Resort the list. Click on an underlined column name. Ascending and descending arrows indicate the sort order. Click the column name to change the sort order.
Scroll through the pages. Use the page controls above or below the table. Go to a page by selecting the page number or by using the arrow buttons to go to the next, previous, first, or last page.
Adding SMTP Servers
Use the Summary of SMTP Servers page to add and configure SMTP Server resources and make them available in AquaLogic Service Bus as a system resource. You must be in an active session to configure or reconfigure SMTP Server resources.
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select System Administration > SMTP Servers.
Click Add.
In the Name field, enter a name for the SMTP Server resource. This is a required field.
In the Description field, enter a short description for the SMTP Server resource.
In the Server URL field, enter the URL that points to the SMTP Server. This is a required field.
In the Port Number field, enter a port number for the SMTP Server (the default port is 25). This is a required field.
If access to the target SMTP Server requires a user name and password, enter a user name in the User Name field, and the associated password in the Password and Confirm Password fields.
These fields are optional, and required only if the SMTP Server is secured.
Click Save to create and save the SMTP Server resource in the current session.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Configuring a Default SMTP Server
You can designate one of the configured SMTP Servers as the default server for the domain. See Adding SMTP Servers.
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select System Administration > SMTP Servers.
In the Default SMTP Server panel, click Select Default.
From the Default SMTP Server drop-down list, select an SMTP Server.
Click Make Default.
The Summary of SMTP Servers page is displayed with the selected SMTP Server shown as the default SMTP Server for the domain.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Editing SMTP Servers
Use this page to view the details of an SMTP Server and edit the configuration, if required.
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
The View SMNP Servers - Configuration page displays the information shown in Table 28-4.
Table 28-4 SMTP Server Information
Property
Description
Last Modified By
The user who created or modified this SMTP Server resource.
Last Modified On
The date and time that the user created or modified this SMTP Server resource. Click the date and time link to view the change history of this resource. See View Change History page.
References
The number of objects that this SMTP Server references.If such references exist, click the numeric link to view a list of the references. See Viewing References to Resources.
Referenced By
The number of objects that reference this SMTP Server. If such references exist, click the numeric link to view a list of the objects. See Viewing References to Resources.
Description
The description of this SMTP Server, if provided.
Server URL
The URL that points to the location of the SMTP Server.
Port Number
The port number for this SMTP Server. This is port 25 by default.
User Name
The user name used to access a secure SMTP Server.
Click Edit to display the Edit SMTP Server - [server-name] page.
The Name field is not editable.
In the Description field, you can edit the short description of the SMTP Server.
In the Server URL field, you can edit the URL of the SMTP Server.
In the Port Number field, you can edit the port number.
You can edit the User Name and Password fields.
Click Save to commit the updates in the current session.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Deleting SMTP Servers
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select System Administration > SMTP Servers.
On the Summary of SMTP Servers page, select an SMTP Server. See Locating SMTP Servers.
Click the Delete icon in the Options field of the SMTP Server resource you want to delete. The SMTP Server resource is deleted in the current session. A Deletion Warning icon is displayed when other resources reference this resource. You can delete the resource with a warning confirmation. This might result in conflicts due to unresolved references to the deleted resource.
To end the session and deploy the configuration to the run time, click Activate under Change Center.