Using the Oracle Service Bus Console

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Global Resources

You use the Global Resources module to add and configure JNDI Providers, SMTP Servers, and Proxy Servers, and make them available in Oracle Service Bus 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.

  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.
  3. Table 28-1 displays UDDI registry configuration settings.

    Table 28-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 Editing JNDI Providers.
    Provider URL
    The URL of the JNDI Provider. See 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
    • Click the Rename icon to rename the JNDI Provider.
    • Click the Delete icon to delete a specific JNDI Provider. See Deleting JNDI Providers

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 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.
  5. In the Description field, enter a short description for the JNDI Provider.
  6. Keep the JNDI Cache option Enabled (default) or select Disabled.
  7. 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.

  8. In the Provider URL field, enter the URL for the JNDI Provider in the format: protocol://host:port
  9. You can use any protocol, for example, http, https, t3, t3s, iiop, iiops.

    This is a required field.

  10. In the case of clusters, the JNDI Provider URL should be configured with a comma-separated list of Managed Servers, in the format:
  11. protocol://<hostname>:<ms1port>, <hostname>:<ms2port>

  12. 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.
  13. These fields are optional, and required only if the JNDI tree is secured.

  14. Click Save to create and save the JNDI Provider resource in the current session.
  15. 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.

  1. 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.
  2. Locate the JNDI Provider. See Viewing JNDI Providers.
  3. Click the JNDI Provider name.
  4. 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. Oracle 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.

  5. Click Edit to display the Edit JNDI Provider - [provider-name] page.
  6. The Name field is not editable.

  7. In the Description field, you can edit the short description of the JNDI Provider.
  8. In the Provider URL field, you can edit the URL of the JNDI Provider.
  9. You can edit the User Name and Password fields.
  10. 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.

  11. Click Save to commit the updates in the current session.
  12. To end the session and deploy the configuration to the run time, click Activate under Change Center.

Deleting JNDI Providers

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

Viewing SMTP Servers

Use this page to designate a default SMTP Server (see 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 Adding Alert Destinations and Create/Edit a Business Service - E-Mail Transport Configuration Page.

Table 28-3 displays SMTP Server information.

Table 28-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 Editing SMTP Servers.
Server URL
The URL that points to the SMTP Server. See Adding SMTP Servers.
Options
  • Click the Rename icon to rename this SMTP Server resource.
  • Click the Delete icon to delete a specific SMTP Server. See Deleting SMTP Servers.

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

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 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.
  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.
  9. These fields are optional, and required only if the SMTP Server is secured.

  10. Click Save to create and save the SMTP Server resource in the current session.
  11. 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.

  1. 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.
  2. Select System Administration > SMTP Servers.
  3. In the Default SMTP Server panel, click Select Default.
  4. From the Default SMTP Server drop-down list, select an SMTP Server.
  5. Click Make Default.
  6. The Summary of SMTP Servers page is displayed with the selected SMTP Server shown as the default SMTP Server for the domain.

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

  1. 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.
  2. Locate the SMTP Server. See Locating SMTP Servers.
  3. Click the SMTP Server name.
  4. 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.

  5. Click Edit to display the Edit SMTP Server - [server-name] page.
  6. The Name field is not editable.

  7. In the Description field, you can edit the short description of the SMTP Server.
  8. In the Server URL field, you can edit the URL of the SMTP Server.
  9. In the Port Number field, you can edit the port number.
  10. You can edit the User Name and Password fields.
  11. Click Save to commit the updates in the current session.
  12. To end the session and deploy the configuration to the run time, click Activate under Change Center.

Deleting 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 Using the Change Center.
  2. Select System Administration > SMTP Servers.
  3. On the Summary of SMTP Servers page, select an SMTP Server. See 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.

Viewing Proxy Servers

Use this page to view a list of Proxy Servers and the information shown in Table 28-5.

Proxy Server resources are used while configuring the HTTP transport for business services. For more information, see HTTP Transport Configuration Page.

Table 28-5 displays Proxy Server information.

Table 28-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 Editing Proxy Servers.
Options
  • Click the Rename icon to rename this Proxy Server resource.
  • Click the Delete icon to delete a specific Proxy Server. See Deleting Proxy Servers.

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

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 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.
  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.
    2. The Server Host name for the Oracle Service Bus proxy server must be identical to the server host name of the actual proxy server.

    3. In the Clear Text Port field, enter the Proxy Server clear-text port number.
    4. In the SSL Port field, enter the Proxy Server SSL port number. You must enter either a clear text or SSL port number.
    5. Click Add.
    6. 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.
  8. These fields are optional, and required only if the Proxy Server is secured.

  9. Click Save to create and save the Proxy Server resource in the current session.
  10. To end the session and deploy the configuration to the run time, click Activate under Change Center.

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 Using the Change Center.
  2. Locate the Proxy Server. See Locating Proxy Servers.
  3. Click the Proxy Server name.
  4. The View Proxy Servers - Configuration page displays the information shown in Table 28-6.

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

  5. Click Edit to display the Edit Proxy Server - [server-name] page.
  6. The Name field is not editable.

  7. In the Description field, you can edit the short description of the Proxy Server.
  8. 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.
    2. The Server Host name for the Oracle Service Bus proxy server must be identical to the server host name of the actual proxy server.

    3. In the Clear Text Port field, enter the Proxy Server clear-text port number.
    4. In the SSL Port field, enter the Proxy Server SSL port number. You must enter either a clear text or SSL port number.
    5. Click Add.
    6. 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.
  9. You can edit the User Name and Password fields, used for proxy authentication.
  10. Click Save to commit the updates in the current session.
  11. To end the session and deploy the configuration to the run time, click Activate under Change Center.

Deleting Proxy 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 Using the Change Center.
  2. Select System Administration > Proxy Servers.
  3. On the Summary of Proxy Servers page, select a Proxy Server. See 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.

  Back to Top       Previous  Next