This chapter describes how to add and configure global resources in the Oracle Service Bus (OSB) Administration Console, such as JNDI Providers, SMTP Servers, and Proxy Servers. Global resources can be reused by OSB services.
This chapter includes the following sections:
Use this page to view a list of JNDI Providers and the information shown in Table 31-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 Oracle Service Bus.
Table 31-1 displays UDDI registry configuration settings.
Table 31-1 JNDI Provider Information
| Property | Description |
|---|---|
|
Name |
The unique name assigned to this JNDI Provider. The name is a link to the View JNDI Provider - Configuration page. See Section 31.3, "Editing JNDI Providers." |
|
Provider URL |
The URL of the JNDI Provider. See Section 31.2, "Adding JNDI Providers." |
|
JNDI Cache |
Enabled or Disabled. When enabled, the JNDI context and JNDI objects are cached locally which improves performance when doing an object lookup. Oracle recommends that you keep the JNDI cache enabled. |
|
Actions |
|
|
Options |
|
You add and configure a JNDI Provider resource and make it available in Oracle Service Bus 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 Section 3.1, "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.
Follow the Section 2.3, "Resource Naming Restrictions" for naming guidance.
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. Oracle 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:
protocol://<hostname>:<ms1port>, <hostname>:<ms2port>
For JNDI Request Timeout, enter the number of milliseconds before a request connection times out. Zero (0) means no time limit.
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.
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 Section 3.1, "Using the Change Center."
Locate the JNDI Provider. See Section 31.1, "Viewing JNDI Providers."
Click the JNDI Provider name.
The View JNDI Provider - Configuration page displays the JNDI Provider information shown in Table 31-2.
Table 31-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 Section 4.23, "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 Section 4.22, "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 Section 4.22, "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. Oracle recommends that you keep the JNDI cache enabled. |
|
Provider URL |
The URL for the JNDI Provider. |
|
JNDI Request Timeout |
The JNDI request timeout in milliseconds. The default of zero (0) means no timeout. |
|
User Name and password |
The user name used to access a secure JNDI Provider, with the ability to change the password. |
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.
To delete a 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 Section 3.1, "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 Section 31.1, "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.
Use this page to designate a default SMTP Server (see Section 31.8, "Configuring a Default SMTP Server") and to view a list of SMTP Servers.
SMTP Server resources are used while configuring alert destination resources and E-mail transport-based business services. See Section 6.2, "Adding Alert Destinations".
Table 31-3 displays SMTP Server information.
Table 31-3 SMTP Server Information
| Property | Description |
|---|---|
|
Name |
The unique name assigned to this SMTP Server resource. The name is a link to the View SMTP Server - Configuration page. See Section 31.9, "Editing SMTP Servers." |
|
Server URL |
The URL that points to the SMTP Server. See Section 31.7, "Adding SMTP Servers." |
|
Options |
|
To locate SMTP servers:
Select System Administration > SMTP Servers.
To locate specific SMTP Servers:
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.
Use the Summary of SMTP Servers page to add and configure SMTP Server resources and make them available in Oracle 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 Section 3.1, "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.
Follow the Section 2.3, "Resource Naming Restrictions" for naming guidance.
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.
You can designate one of the configured SMTP Servers as the default server for the domain. See Section 31.7, "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 Section 3.1, "Using the Change Center."
Select System Administration > SMTP Servers.
In the Default SMTP Server panel, click Select Default.
From the Default SMTP Server 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.
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 Section 3.1, "Using the Change Center."
Locate the SMTP Server. See Section 31.6, "Locating SMTP Servers."
Click the SMTP Server name.
The View SMNP Servers - Configuration page displays the information shown in Table 31-4.
Table 31-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 Section 4.23, "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 Section 4.22, "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 Section 4.22, "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.
If you rename an SMTP resource, the new name is automatically updated in the any e-mail business services that reference the SMTP resource in the endpoint URI.
To delete an SMTP server:
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Section 3.1, "Using the Change Center."
Select System Administration > SMTP Servers.
On the Summary of SMTP Servers page, select an SMTP Server. See Section 31.6, "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.
Use this page to view a list of Proxy Servers and the information shown in Table 31-5.
Proxy Server resources are used while configuring the HTTP transport for business services. For more information, see Section 19.2.12, "HTTP Transport Configuration Page."
Table 31-5 displays Proxy Server information.
Table 31-5 Proxy Server Information
| Property | Description |
|---|---|
|
Name |
The unique name assigned to this Proxy Server resource. The name is a link to the View Proxy Server - Configuration page. See Section 31.14, "Editing Proxy Servers." |
|
Options |
|
To locate proxy servers:
Select System Administration > Proxy Servers.
To locate specific Proxy Servers:
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.
Use the Summary of Proxy Servers page to add and configure Proxy Server resources and make them available in Oracle Service Bus as a system resource. You must be in an active session to configure or reconfigure Proxy 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 Section 3.1, "Using the Change Center."
Select System Administration > Proxy Servers.
Click Add.
In the Name field, enter a name for the Proxy Server resource. This is a required field.
Follow the Section 2.3, "Resource Naming Restrictions" for naming guidance.
In the Description field, enter a short description for the Proxy Server resource.
In the Host-Port Parameters section, enter the following information:
In the Server Host field, enter the host name or IP address of the Proxy Server. This is a required field.
The Server Host name for the Oracle Service Bus proxy server must be identical to the server host name of the actual proxy server.
In the Clear Text Port field, enter the Proxy Server clear-text port number.
In the SSL Port field, enter the Proxy Server SSL port number. You must enter either a clear text or SSL port number.
Click Add.
You can configure multiple Proxy Servers for each Proxy Server resource. This enables Oracle Service Bus to perform load balancing and offer fault tolerance features for the Proxy Server resource.
If the Proxy Server performs proxy authentication, 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 Proxy Server is secured.
Click Save to create and save the Proxy Server resource in the current session.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Use this page to view the details of a Proxy 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 Section 3.1, "Using the Change Center."
Locate the Proxy Server. See Section 31.12, "Locating Proxy Servers."
Click the Proxy Server name.
The View Proxy Servers - Configuration page displays the information shown in Table 31-6.
Table 31-6 Proxy Server Information
| Property | Description |
|---|---|
|
Last Modified By |
The user who created or modified this Proxy Server resource. |
|
Last Modified On |
The date and time that the user created or modified this Proxy Server resource. Click the date and time link to view the change history of this resource. See Section 4.23, "View Change History Page." |
|
References |
The number of objects that this Proxy Server references.If such references exist, click the numeric link to view a list of the references. See Section 4.22, "Viewing References to Resources." |
|
Referenced By |
The number of objects that reference this Proxy Server. If such references exist, click the numeric link to view a list of the objects. See Section 4.22, "Viewing References to Resources." |
|
Description |
The description of this Proxy Server, if provided. |
|
Host-Port Parameters |
Details about each Proxy Server in the Proxy Server resource, including the following information:
|
|
User Name |
The user name used for proxy authentication. |
Click Edit to display the Edit Proxy Server - [server-name] page.
The Name field is not editable.
In the Description field, you can edit the short description of the Proxy Server.
In the Host-Port Parameters section, you can add a new Proxy Server by entering the following information:
In the Server Host field, enter the host name or IP address of the Proxy Server. This is a required field.
The Server Host name for the Oracle Service Bus proxy server must be identical to the server host name of the actual proxy server.
In the Clear Text Port field, enter the Proxy Server clear-text port number.
In the SSL Port field, enter the Proxy Server SSL port number. You must enter either a clear text or SSL port number.
Click Add.
You can configure multiple Proxy Servers for each Proxy Server resource. This enables Oracle Service Bus to perform load balancing and offer fault tolerance features for the Proxy Server resource.
You can also edit or delete an existing Proxy Server configuration by doing the following:
Click the Edit icon in the Options field of the Proxy Server you want to edit. Edit the Server Host field, the Clear Text Port field, and the SSL Port field, and click Update.
Click the Delete icon in the Options field of the Proxy Server you want to delete.
You can edit the User Name and Password fields, used for proxy authentication.
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.
To delete a proxy server:
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Section 3.1, "Using the Change Center."
Select System Administration > Proxy Servers.
On the Summary of Proxy Servers page, select a Proxy Server. See Section 31.6, "Locating SMTP Servers."
Click the Delete icon in the Options field of the Proxy Server resource you want to delete. The Proxy 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.