Skip Headers
Oracle® Fusion Middleware Administrator's Guide for Oracle Service Bus
11g Release 1 (11.1.1.6.3)

Part Number E15867-08
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

31 Global Resources

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:

31.1 Viewing JNDI Providers

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.

  1. 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.

  2. 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

  • Click the Reset icon to reset the JNDI context to discard the JNDI connection and locally cached objects.

  • Click the Launch Test Console icon to test whether the JNDI Provider can successfully establish a connection and obtain a JNDI context.

Options


31.2 Adding JNDI Providers

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.

  1. 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."

  2. Select System Administration > JNDI Providers.

  3. Click Add.

  4. 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.

  5. In the Description field, enter a short description for the JNDI Provider.

  6. 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.

  7. 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.

  8. 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>

  9. For JNDI Request Timeout, enter the number of milliseconds before a request connection times out. Zero (0) means no time limit.

  10. 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.

  11. Click Save to create and save the JNDI Provider resource in the current session.

  12. To end the session and deploy the configuration to the run time, click Activate under Change Center.

31.3 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.

  1. 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."

  2. Locate the JNDI Provider. See Section 31.1, "Viewing JNDI Providers."

  3. 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.


  4. Click Edit to display the Edit JNDI Provider - [provider-name] page.

    The Name field is not editable.

  5. In the Description field, you can edit the short description of the JNDI Provider.

  6. In the Provider URL field, you can edit the URL of the JNDI Provider.

  7. 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.

  8. Click Save to commit the updates in the current session.

  9. To end the session and deploy the configuration to the run time, click Activate under Change Center.

31.4 Deleting JNDI Providers

To delete a JNDI provider:

  1. 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."

  2. Select System Administration > JNDI Providers.

  3. 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."

  4. 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.

  5. To end the session and deploy the configuration to the run time, click Activate under Change Center.

31.5 Viewing SMTP Servers

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


31.6 Locating SMTP Servers

To locate SMTP servers:

  1. Select System Administration > SMTP Servers.

  2. 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.

31.7 Adding SMTP Servers

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.

  1. 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."

  2. Select System Administration > SMTP Servers.

  3. Click Add.

  4. 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.

  5. In the Description field, enter a short description for the SMTP Server resource.

  6. In the Server URL field, enter the URL that points to the SMTP Server. This is a required field.

  7. In the Port Number field, enter a port number for the SMTP Server (the default port is 25). This is a required field.

  8. 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.

  9. Click Save to create and save the SMTP Server resource in the current session.

  10. To end the session and deploy the configuration to the run time, click Activate under Change Center.

31.8 Configuring a Default SMTP Server

You can designate one of the configured SMTP Servers as the default server for the domain. See Section 31.7, "Adding SMTP Servers."

  1. 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."

  2. Select System Administration > SMTP Servers.

  3. In the Default SMTP Server panel, click Select Default.

  4. From the Default SMTP Server list, select an SMTP Server.

  5. 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.

  6. To end the session and deploy the configuration to the run time, click Activate under Change Center.

31.9 Editing SMTP Servers

Use this page to view the details of an SMTP Server and edit the configuration, if required.

  1. 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."

  2. Locate the SMTP Server. See Section 31.6, "Locating SMTP Servers."

  3. 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.


  4. Click Edit to display the Edit SMTP Server - [server-name] page.

    The Name field is not editable.

  5. In the Description field, you can edit the short description of the SMTP Server.

  6. In the Server URL field, you can edit the URL of the SMTP Server.

  7. In the Port Number field, you can edit the port number.

  8. You can edit the User Name and Password fields.

  9. Click Save to commit the updates in the current session.

  10. 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.

31.10 Deleting SMTP Servers

To delete an SMTP server:

  1. 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."

  2. Select System Administration > SMTP Servers.

  3. On the Summary of SMTP Servers page, select an SMTP Server. See Section 31.6, "Locating SMTP Servers."

  4. 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.

  5. To end the session and deploy the configuration to the run time, click Activate under Change Center.

31.11 Viewing Proxy Servers

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


31.12 Locating Proxy Servers

To locate proxy servers:

  1. Select System Administration > Proxy Servers.

  2. 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.

31.13 Adding Proxy Servers

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.

  1. 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."

  2. Select System Administration > Proxy Servers.

  3. Click Add.

  4. 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.

  5. In the Description field, enter a short description for the Proxy Server resource.

  6. In the Host-Port Parameters section, enter the following information:

    1. 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.

    2. In the Clear Text Port field, enter the Proxy Server clear-text port number.

    3. In the SSL Port field, enter the Proxy Server SSL port number. You must enter either a clear text or SSL port number.

    4. 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.

  7. 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.

  8. Click Save to create and save the Proxy Server resource in the current session.

  9. To end the session and deploy the configuration to the run time, click Activate under Change Center.

31.14 Editing Proxy Servers

Use this page to view the details of a Proxy Server and edit the configuration, if required.

  1. 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."

  2. Locate the Proxy Server. See Section 31.12, "Locating Proxy Servers."

  3. 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:

    • Server Host: The host name or IP address of the Proxy Server.

      The Server Host name for the Oracle Service Bus proxy server must be identical to the server host name of the actual proxy server.

    • Clear Text Port: The Proxy Server clear-text port number.

    • SSL Port: The Proxy Server SSL port number.

    User Name

    The user name used for proxy authentication.


  4. Click Edit to display the Edit Proxy Server - [server-name] page.

    The Name field is not editable.

  5. In the Description field, you can edit the short description of the Proxy Server.

  6. In the Host-Port Parameters section, you can add a new Proxy Server by entering the following information:

    1. 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.

    2. In the Clear Text Port field, enter the Proxy Server clear-text port number.

    3. In the SSL Port field, enter the Proxy Server SSL port number. You must enter either a clear text or SSL port number.

    4. 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.

  7. You can edit the User Name and Password fields, used for proxy authentication.

  8. Click Save to commit the updates in the current session.

  9. To end the session and deploy the configuration to the run time, click Activate under Change Center.

31.15 Deleting Proxy Servers

To delete a proxy server:

  1. 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."

  2. Select System Administration > Proxy Servers.

  3. On the Summary of Proxy Servers page, select a Proxy Server. See Section 31.6, "Locating SMTP Servers."

  4. 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.

  5. To end the session and deploy the configuration to the run time, click Activate under Change Center.