The following table lists the pages you can access from the System Administration module. It also lists the tasks and help topics associated with each page.
Table 24-1 System Administration Pages, Tasks and Help Topics
Page
Associated Tasks
Help Topics
Global Settings
Enable or disable global monitoring of all services
Turn global monitoring for business and proxy services on and off at the domain level. You can enable or disable monitoring for all services only from within a session. See
Reset monitoring statistics for all services in your configuration. You can reset statistics whether or not you are in a session. See Resetting Statistics for All Services
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session for making changes to the current configuration. To learn more, see Using the Change Center.
From the left navigation pane, select Global Settings from under System Administration.
Select the Enable Monitoring checkbox under Monitoring Configuration for the system to start collecting monitoring statistics for all services in your configuration.
Click Save. The monitoring configuration is updated in the current session.
Note:
When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.
Note:
When you enable global monitoring, the aggregator immediately begins to collect monitoring statistics. However, there may be a short delay (approximately a minute) before these statistics become available on the Service Monitoring Summary page. When statistics become available, the Service Monitoring Summary page displays the entire list of services that are being monitored and their latest statistics. To learn more, see "Refresh Rate of Monitored Information" in Monitoring in the AquaLogic Service Bus User Guide.
To Disable Global Monitoring of Services
Note:
If you disable monitoring for all services, all statistics collected so far for those services are deleted as well. These statistics cannot be restored using the session Undo function. You can use Undo to enable monitoring again for the services, but the delete of the statistics is irreversible.
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session for making changes to the current configuration. To learn more, see Using the Change Center.
From the left navigation pane, select Global Settings from under System Administration.
Uncheck the Enable Monitoring checkbox under Monitoring Configuration for the system to stop collecting monitoring statistics for all services in your configuration.
Click Save. The monitoring configuration is updated in the current session.
Note:
When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.
Note:
This option overrides the Enable Monitoring option that you can select for specific business and proxy services. To learn more, see Configuring Monitoring for Specific Services.
The Global Settings page allows you to reset monitoring statistics for all services in your configuration. You can reset statistics whether or not you are in a session.
To Reset Statistics for All Services
From the left navigation pane, select Global Settings from under System Administration.
Click Reset All Statistics under Statistics-Gathering. When you confirm you want to reset statistics, the system deletes all monitoring statistics that were collected for all services in your configuration since the last time you clicked Reset All Statistics.
Note:
The system does not delete the statistics being collected during the Current Aggregation Interval for any of the services. The length of the aggregation intervals may also be different for each service. Additionally, after you click Reset All Statistics, the system immediately starts collecting monitoring statistics for the services again.
Setting the Dashboard Polling Interval Refresh Rate
The Global Settings page allows you to set the polling interval refresh rate for the Dashboard page in the Monitoring module. The default refresh rate is one minute, but you can also select another predefined range.
To Set the Dashboard Polling Interval Refresh Rate
From the left navigation pane, select Global Settings from under System Administration. The Global Settings page is displayed.
In the Interval Refresh Setting field under Interval Refresh, select 1, 2, 3, or 5 as the refresh rate for the Dashboard page. For example, if you select 5, the refresh rate for the Dashboard page is every 5 minutes.
The Import Configuration Data page allows you to import objects that contain configuration data that has previously been exported from another AquaLogic Service Bus domain and exported as a JAR file. You first open the JAR file, and then work on the configuration data and customize it. You can choose to import only a subset of the exported data, or change values of certain configuration data.
Note:
You cannot export users, groups, roles, certificates, or access control policies when you export a configuration, as these objects are created through the WebLogic Server. Therefore, you must create these objects again when you import an exported configuration.
Importing Service Accounts or Proxy Service Providers
If the JAR file was created by AquaLogic Service Bus 2.5 or later and contains service accounts or proxy service providers, you can import these resources along with the user names, passwords, local-user to remote-user mappings, and alias to key-pair bindings that they contain. For each proxy service provider, AquaLogic Service Bus imports the alias to key-pair binding into the PKI credential mapping provider. If this data was encrypted during export, you must supply the password that was used to encrypt the data. If you do not know the password, you can import all other non-encrypted resources.
If you import a service account or proxy service provider and a corresponding resource of the same name already exists in your domain, the imported resource will overwrite the one already in your domain, even if the one already in your domain has been modified during the current session.
AquaLogic Service Bus completely overwrites the existing resource; it does not merge the data. For example, if an imported proxy service provider contains an alias to key-pair binding for digital signatures and the proxy service provider that is already in your domain contains alias to key-pair bindings for both digital signatures and digital encryption, after the import process the proxy service provider will contain only the imported alias to key-pair binding for digital signatures.
If the JAR file was created by AquaLogic Service Bus 2.1 or earlier, for each service account in the JAR, the import process searches the AquaLogic Service Bus internal LDAP server for user names and passwords that match those in the imported service account. If it finds a match, the import process copies the credentials into the service account. If it does not find a match, you must add credentials to the service account before you can activate the session.
For each proxy service provider in an AquaLogic Service Bus 2.1 JAR, the import process searches the AquaLogic Service Bus internal LDAP server for alias to key-pair bindings that match those in the imported proxy service provider. If it finds a match, it allows the proxy service provider to use those key-pair bindings. If it does not find a match, the import process imports the proxy service provider without any key-pair bindings. While it is valid to create a proxy service provider that contains no key-pair bindings, if you want to use the provider to provide credentials, you must use the AquaLogic Service Bus Console to add key-pair bindings to the proxy service provider.
To Import Configuration Data
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session for making changes to the current configuration. To learn more, see Using the Change Center.
From the left navigation pane, select Import Resources from under System Administration. The Import Configuration Data page is displayed.
Select an exported configuration file:
In the File Name field, click Browse to locate the directory where the configuration JAR file is stored.
Select the configuration JAR file, then click Open.
Click Next. The following information is displayed:
Table 24-2 Configuration File Details
Property
Description
Name
The name of the project.
Type
The resource type, which is Project.
Encrypted
Indicates whether the resource is encrypted.
When you are re-importing a resource but desire to protect any customization made to the existing resource, select Preserve Environment Variables.
If you want to ensure that all associated resources are imported, select Include Dependencies.
Select the objects you want to import:
To display each object contained in the configuration JAR file, expand the folder for the file. The checkbox associated with each object is selected. The following information is displayed for each object:
Table 24-3 Configuration JAR Details
Property
Description
Name
The name and path of the resource. The path is the project name and the name of the folder in which the resource resides.
Uncheck the objects that you do not want to import.
To import the configuration JAR file, click Import.
If the JAR file contains resources with user name and password data that was encrypted when it was exported, the Import Configuration Data - Security Settings window is displayed. Enter the password that was used to encrypt the data (see Exporting Configuration Data). Then click Finish Import.
Note:
If you do not know the password that was used to encrypt the resource data, click the Back button and remove the checkbox that is next to the resource. You can import all other non-encrypted resources without knowing the password.
The Processing Configuration Data pop-up window is displayed. You should wait until this window closes before you do anything else on the console. The window closes automatically when the system finishes importing the objects. The Import Configuration Data page is displayed, which includes a message that you have successfully deployed the data.
Review the Import Summary. The following information is displayed.
Table 24-4 Import Summary Information
Property
Description
Status
Whether or not the resource was imported successfully.
Note:
A WSDL may be temporarily marked as invalid until all of its dependencies are imported. When the import action is completed, however, the configuration service re-validates the files marked invalid.
Name
The name of the resource. The path is the project name and the name of the folder in which the resource resides.
Path
The path of the resource. The path is the project name and the name of the folder in which the resource resides.
Type
Any of the following resource types:
Business service
MFL File
Proxy service
Proxy service provider
XML schema
Service Account
WS-Policy
WSDL
XQuery Transformation
XSL Transformation
JAR
Alert Destination
JNDI Provider
SMTP Server
Error Message
Displays an error message if one exists for this resource.
Click Import Another.
You can import another JAR file, or you can click View Changes under Change Center in the left navigation pane to view import details. If you click View Changes, see Viewing Configuration Changes.
Note:
The new resources are saved in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.
The Export Configuration Data page allows you to export objects. You must be outside a session to use this page.
Note:
AquaLogic Service Bus cannot export the users, groups, roles, or access control policies that you create in the Security Configuration module of the AquaLogic Service Bus Console. Neither can it export credential maps or other security-provider data that you create in the WebLogic Server Administration Console. Instead, use the WebLogic Server Administration Console to export this data. See Migrating Security Data in Securing WebLogic Server.
To Export Configuration Data
From the left navigation pane, select Export Resources from under System Administration.
The Export Configuration Data page displays the list of objects in your configuration. The name, type and references for each object are displayed.
Select the object you want to export:
Select the checkbox associated with the object.
Expand the folder for the selected object. The name, type, and references for each object contained in the selected object are displayed. Each object is selected.
Uncheck the objects that you do not want to export.
Check or uncheck the Include Dependencies option. This option allows you to export any other resources that reference this resource.
Click Export to create a configuration JAR file and export it.
If your export includes a service account or a proxy service provider, the Export Configuration Data - Security Settings page is displayed.
For each service account, AquaLogic Service Bus exports the user name and password or the local-user to remote-user map (depending on which data was stored in the service account). For each proxy service provider, AquaLogic Service Bus exports the alias to key-pair binding from the PKI credential mapping provider; it does not export private keys, certificates, or other data from the key stores. Key store data must be exported using tools that the key store vendor provides.
If you want AquaLogic Service Bus to encrypt the user name and password data that is in the service account, proxy service provider, UDDI registry, JNDI provider, or SMTP provider resources before exporting it the to JAR file, do the following:
Select the Protect Sensitive Data check box.
Enter and confirm a password.
Caution:
When you or someone else attempts to import this JAR, AquaLogic Service Bus will not import the resources with encrypted user name and password data unless you specify this password. You can import all of the other non-encrypted resources in the JAR without specifying the password.
Click Finish Export button.
When you click Export or Finish Export, the Processing Configuration Data popup window is displayed. Wait until this window closes before you do anything else on the console. The window is closed automatically when the File Download dialog box is displayed.
In the File Download dialog box, click Open to open the exported JAR file or click Save to save the JAR file to your desktop.
Note:
You can only export a configuration JAR file outside of a session. Therefore, you can only export changes that have been previously activated.
Enabling Run Time Tracing Status For Proxy Services
The Runtime Tracing Status page allows you to enable the run time tracing status for proxy services. This causes tracing information to be logged automatically for the proxy services you select, which can help you to diagnose and troubleshoot problems in the Message Flow.
You can enable tracing for a single proxy service or for multiple proxy services. Once you enable tracing, the system logs various details culled from the Message Flow Context and the Message Context. These details include: stage name; pipeline or route node name; and the current message context.
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session for making changes to the current configuration. To learn more, see Using the Change Center.
From the left navigation pane, select Tracing Configuration from under System Administration. The Runtime Tracing Status page is displayed.
To enable run time tracing status for a specific proxy service, select the checkbox associated with the proxy service.
Displaying Run Time Tracing Status For Proxy Services
The Runtime Tracing Status page allows you to view the run time tracing status of proxy services. To learn more about run time tracing, and enabling run time tracing for a proxy service, see Enabling Run Time Tracing Status For Proxy Services.
To Display Run Time Tracing Status For a Proxy Service
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session for making changes to the current configuration. To learn more, see Using the Change Center.
From the left navigation pane, select Tracing Configuration from under System Administration. The Runtime Tracing Status page is displayed. This page displays the following information.
Table 24-5 Run Time Tracing Information for Proxy Service
Property
Description
Name
The name of the proxy service. The name is a link to the View Proxy Service Details page. To learn more, see Viewing and Changing Proxy Services.
Path
The path of the proxy service. The path is the project name and the name of the folder in which the proxy service resides. It is a link to the Project Details or Folder Details page. To learn more, see Viewing Project Details or Viewing Folder Details.
To locate a specific proxy service, do one of the following:
Filter by proxy service name. In the Name and Path fields, enter the name and path of the search target, then click Search. The services matching the search criteria are displayed.
Resort the list. Ascending and descending arrow buttons indicate sortable columns—in this case, the Name and Path columns. Click the button to change the sort order.
Scroll through the pages. Use the controls in the lower right corner. 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.
The UDDI Configuration page allows you to configure a UDDI registry and to make it available in AquaLogic Service Bus. After the registry is configured, you can then publish AquaLogic Service Bus proxy services to it or import business services from the registry to be used in an AquaLogic Service Bus proxy service. You must be in an active session to configure the registry.
You can search for a specific registry that you have previously configured. The search feature allows you to use wild cards to search for all registry entries satisfying the specified pattern. UDDI has two wild cards: use `*' for multiple characters and `?' for single characters. The search returns all records that satisfy any of the search criteria property values.
UDDI Registry Configuration Settings
Every registry has a set of properties that must be configured. When configuring a UDDI registry, the following properties are mandatory.
Table 24-6 UDDI Registry Configuration Settings
Name
This is the name of the registry. The name is assigned to a registry when it is first created.You can not edit the name of the registry after the entry is saved.
Description
This is a description of the registry.
Inquiry URL
This is the URL to the Inquiry API endpoint. It allows you to locate and import a service.
Publish URL
This is the URL to the Publish API endpoint. It allows you to publish services.
Security URL
This is the URL to the Security API endpoint.This URL is used to get an authentication token so that you can publish to the registry.
Subscription
This is the URL to the Subscription API endpoint. This URL is used to subscribe for changes from the registry create a subscription with the registry to listen to changes to services that are imported.
Username
This is required for user authentication.
Password (Confirm Password)
This is required for user authentication.
Load tModels into registry
Select this option to load the tModels into the selected registry. This option only has to be selected once per registry.
Searching for a UDDI Registry
To Search for a UDDI Registry
From the left navigation pane, select UDDI Registries from under System Administration. The page with UDDI Default Configuration and UDDI Registries sections are displayed.
In the UDDI Registries section, enter the name of the registry you want to find in the field, or enter wild card characters (use * and ? as wildcard) to perform a more general search.
Click Search to search for the specific entry.
Note:
Click View All to view all registries that are configured to work with AquaLogic Service Bus.
Adding a UDDI Registry
You must be in an active session to add a registry. Details about the selected registries are added to the UDDI Registries section. See Table 24-6 for a description of the properties that must be set when adding a registry.
To Add a UDDI Registry
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session for making changes to the current configuration. To learn more, see Using the Change Center.
From the left navigation pane, select UDDI Registries from under System Administration. The page containing the UDDI Default Configuration and the UDDI Registries sections are displayed.
In the UDDI Registries section, click Add registry.
The UDDI Configuration page changes to display the configuration properties that define the registry. The properties are described in Table 24-6.
To configure the registry, complete the following steps:
In the Name field, enter a name for the registry. This is a required field.
In the Inquiry URL field, enter an inquiry URL in the format: http://host:port/APPLICATION_SERVER_CONTEXT/uddi/inquiry This is a required field.
In the Publish URL field, enter a publish URL in the format http://host:port/APPLICATION_SERVER_CONTEXT/uddi/publishing
In the Security URL field, enter a security URL in the format http://host:port/APPLICATION_SERVER_CONTEXT/uddi/security
In the Subscription URL field, enter a subscription URL in http://host:port/APPLICATION_SERVER_CONTEXT/uddi/subscription
Note:
By default the value for APPLICATION_SERVER_CONTEXT field in the installer is registry.
In the Username field enter the user name to log into the registry console.
In the Password /(Confirm Password) field enter the password to log into the registry console.
Select the Load tModel into registry checkbox to publish the AquaLogic Service Bus tModels to this registry.
Note:
This field is only required when publishing proxy services to this registry.
Click Validate to validate the URLs you have provided.
Click Save to configure the registry with the settings provided.
Activate the session.
Making Configuration Changes to an Existing UDDI Registry
To Edit the UDDI Registry Details
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session for making changes to the current configuration. To learn more, see Using the Change Center.
From the left navigation pane, select UDDI Registries from under System Administration. The page containing the UDDI Default Configuration and the UDDI Registries sections are displayed.
In the UDDI Registries section, from the list of available registries, select the Registry name. You can also search for a specific registry using the Search option. Click on the name of the registry you want to edit. The System/UDDI/registry page is displayed.
In the System/UDDI/registry click Edit.
The UDDI Configuration-Edit Registry page displays the configuration properties that define the registry. The properties are described in Table 24-6.
Edit the registry configuration parameters. You cannot edit the name of the registry.
Click Save to save the configuration changes or cancel to dismiss the changes.
You must set up a default registry to use Auto-Publish.
To Set up a Default Registry
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session for making changes to the current configuration. To learn more, see Using the Change Center.
From the left navigation pane, select UDDI Registries from under System Administration. The page containing the UDDI Default Configuration and the UDDI Registries sections are displayed.
In the UDDI Default Configuration section click the Select Default.The SelectDefaultRegistry page is displayed.
In the DefaultRegistryName list select the name of the registry you want to set as default.
To set the default business entities choose an entity from the BusinessEntities list.
Click the MakeDefault button.
Note:
To change the default registry, click ClearSelection and repeat the above steps.
Importing a Business Service From a UDDI Registry
You can import the following business service types from a UDDI registry into AquaLogic Service Bus:
WSDL services over HTTP transport.
AquaLogic Service Bus proxy services that are published to a UDDI registry. This feature is primarily used in multi-domain AquaLogic Service Bus deployments where proxy services from one domain need to discover and route to proxy services in another domain.
If you only have one registry configured, AquaLogic Service Bus automatically connects to that registry and retrieves all the business entities and populates the search form. If you have more than one registry configured, the import wizard prompts you to first select the registry from which you want to import services.
The inquiry URL is used on import to locate a specific service as a registry has several different types of services.
To Import a Business Service
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session for making changes to the current configuration. To learn more, see Using the Change Center. You can only import when you are in a session.
From the left navigation pane, select Import From UDDI from under System Administration. The Import UDDI page is displayed.
In the Import Registry Name drop down, select the name of the registry from which you want to import the service, then click Next. The Import UDDI page allows you to search for specific business services and import them. You can search for a service by business entity, by pattern, or by using a combination of both.
Note:
When a single registry is configured in AquaLogic Service Bus, then the initial registry selection page is not displayed as this is the default registry. The initial page is only displayed when two or more registries are defined.
Select the business entity name (for example, document Services) from the Entity Name drop-down menu to search by business entity.
Enter the pattern (for example: a%) you want to search for in the Service Name field.
A list of business services matching the entered search criteria is displayed. Select the service(s) that you want to import, then click Next.
Note:
If you are unable to find a desired service, it may be because you do not belong to the security group with permissions to view its records.
Select the binding templates from which you want to create business services, then click Next. If a selected service has multiple binding templates, then each of these binding templates results in a business service. In this case you will be prompted to further narrow your selection among the binding templates you want to import.
On the Import UDDI: Select Import Location page select a project from the Project list-box, select a folder where you want to import your services and associated resources, then click Next.
The Import UDDI: Review and Import Services page displays a list of all of the resources (business services, MFLs, schemas, WSDLs, and so on) that will be created in the system. A warning message is displayed for any resource that cannot be imported. By default, all the items in the list are marked for import.
Uncheck the checkbox next to a specific resource if you already have the resource in your system and want to manually resolve the dependencies.
You can resolve dependencies from the View Conflicts page in the Change Center after the import process is complete. For more information on viewing and resolving conflicts, seeViewing and Resolving Conflicts.
Click Import to start the import process. A pop-up is displayed indicating the progress of the import. When the import is complete, the Import Summary page displays the result of the import. A success message is displayed at the top of the page if the import was successful. If one or more resources could not be imported, an error message is displayed.
Go to the Status column for the resource to view the cause of the error.
To view and resolve additional conflicts, click View Conflicts.
You can use the Auto-Import Status to synchronize the changes with the registry. Any changes to service in the registry is automatically notified in the AquaLogic Service Bus Console. You can synchronize the service in the AquaLogic Service Bus Console with the corresponding service in the UDDI registry.
To Perform Auto-Import
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session for making changes to the current configuration. To learn more, see Using the Change Center.
From the left navigation pane, select Auto-Import Status. The Auto-Import Status page is displayed.
In the Auto-Import Status page, select the type of service you want to display from the View drop down list. Click the check boxes against the proxy services in the list displayed to select proxy services you need to synchronize with the corresponding services in the registry.
Click Synchronize.
In the next page click Finish.The files are synchronized.
Detaching a Service
To prevent the automatic notification to the AquaLogic Service Bus Console about the changes in the UDDI registry, you can detach the services.
You can detach the services in one of the following ways:
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session for making changes to the current configuration. To learn more, see Using the Change Center.
From the left navigation pane, select the Project Explorer. Go the required project folder.
Click on the business service, which has to be updated from the UFUDDI registry.Click the Edit button, which is at the bottom of the View a Business Service page.
Enable the Detach from Registry. That business service will be detached from the corresponding service in the UDDI registry
Detach a Service From the Auto-Import Status Page
In the Auto-Import Status page, select the type of service you want to display from the View drop down list.Click the check boxes against the business services in the list displayed to select business services you need to detach from the corresponding services in the UDDI registry.
Click Detach.
Publishing a Proxy Service to a UDDI Registry
You can publish your service to a registry and make it available for other organizations to discover and use. All proxy services developed in AquaLogic Service Bus can be published to a UDDI registry. You can select the business entity under which you want to publish your service and you can publish a number of services at a time.
Before you can publish to a registry, you must have an account with that registry. AquaLogic Service Bus supports interoperability with v3-compliant UDDI registries. The configuration described in this section assumes you are using BEA AquaLogic Service Registry.
For information about setting up a user account in AquaLogic Service Registry, see the AquaLogic Service Registry User's Guide at the BEA AquaLogic Service Registry product documentation site.
Note:
Unpublishing a service from a registry is done from the AquaLogic Service Registry installation.
To Publish a Proxy Service to a UDDI Registry:
From the left navigation pane, select Publish to UDDI from under System Administration. The Publish to UDDI page is displayed.
Note:
You can only publish when you are not in a session. Exit your session to access the registries list. All the registries to which you have access are displayed in the drop down list of selected registries.
From Publish Registry Name, select the name of the registry to which you want to publish, then click Next.
Note:
When a single registry is configured in BEA AquaLogic Service Bus, then the initial registry selection page is not displayed as this is the default registry. The initial page is only displayed when two or more registries are defined.
The Publish to UDDI: Select individual Services and Publish page is displayed, showing a list of AquaLogic Service Bus proxy services and their locations in the project folder. Starting with the topmost project level folder, the details for name, type, and description are shown for all services.
Select the service(s) that you want to publish Expand the Project folder to see the proxy services defined. By default the folder and it's contents are marked for publishing. You can select individual items to publish.
In the Publish Services to Business Entity drop down list select the business entity to which you want to add the service in the registry. This is the business entity under which the service will be classified in the registry.
Select Publish to publish the services. A confirmation message is displayed indicating that the service was published successfully.
Click Publish Another to return to the Publish to UDDI: select registry page.
You can use the Auto-publish functionality to automatically publish the proxy services to a registry. To use Auto-Publish, enable Auto-Publish in the Edit a Proxy Service —General Configuration. For information on editing proxy services, seeViewing and Changing Proxy Services, and for information on editing proxy services, see Viewing and Changing Business Services.
Note:
You should set the default registry before configuring any service for Auto-Publish. For more information on how to set a default registry, seeSetting Up a Default UDDI Registry
To Configure a Service to Auto-Publish to a Registry
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session for making changes to the current configuration. To learn more, see Using the Change Center.
From the left navigation pane, select the Project Explorer. Go the required project folder.
Click the name of the proxy service you want to edit. The View a Proxy Service page is displayed. Click Edit.
Select Publish to Registry. Click Save. Activate the session. The service is configured to be published to the default registry.
Note:
When you have published a service successfully to a registry, the option to select the service for auto publishing to a registry is no longer available.
If the service is not published successfully it can be re-published.To re-publish a service Select the service on the Auto-Publish Status page. Click Publish.
If the Auto-Publish option is enabled, the proxy services are published as soon as they are created or edited, and the session is activated. You can use the Auto-Publish option with all Proxy services, except those using Local Transport.
Overview of JNDI Providers
The Summary ofJNDI Providers page allows you to configure a JNDI Provider resource and make it available in AquaLogic Service Bus as a system resource. You should be working in an active session to configure a JNDI Provider resource.
You can search for a JNDI Provider resource that you configured previously. The search feature allows you to use wild cards to search for all JNDI Provider resource entries satisfying a specified pattern. You can use either the * wildcard for multiple characters or the ? wildcard for a single character. The search returns all records that satisfy any of the search criteria property values.
Listing and Locating JNDI Providers
The Summary of JNDI Providers page allows you to view a list of JNDI Providers. To learn more about JNDI Providers, see Overview of JNDI Providers.
To List and Locate JNDI Providers
From the left navigation pane, select JNDI Providers from under System Administration. The Summary of JNDI Providers page is displayed This shows the following information for each JNDI Provider.
To locate a specific JNDI Provider, do one of the following:
Enter the name and/or URL of the JNDI provider you want to find in the Name field, and click Search to search for a specific entry. The JNDI Providers matching the search criteria are displayed.
Note:
You can enter wild card characters (? for a single character; * for multiple characters) to perform a more general search.
Sort the list. Ascending and descending arrow buttons indicate columns by which you may sort this table-in this case, the Name and URL columns. Click the arrow button in the relevant column to change the sort order.
Scroll through the pages. 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.
Note:
After a search operation, click View All to view all the JNDI Provider resources that are configured to work with AquaLogic Service Bus.
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session. To learn more, see Using the Change Center.
From the left navigation pane, select JNDI Providers in System Administration. The Summary of JNDI Providers page is displayed.
Click Add. The Add New JNDI Provider page is displayed.
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.
In the Provider URL field, enter the URL for the JNDI provider in the format: http://host:port. This is a required field.
In case of clusters, the JNDI provider URL should be configured with comma-separated list of managed servers, in the format: http://<hostname>:<ms1port>, <hostname>:<ms2port>.
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.
Note:
These fields are optional, and required only if the JNDI tree is secured.
Click Save.
Note:
The new resources are saved in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate in Change Center. The session ends and the configuration is deployed. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.
Viewing and Changing Details of a JNDI Provider
The View JNDI Provider Details page allows you to view the details of a JNDI Provider. This page also allows you to Reset the JNDI provider cache, and to test the connection to the JNDI provider. To learn more about JNDI providers, see Overview of JNDI Providers.
Click the JNDI provider's name. The System/JNDI Provider/<ProviderName> page (where ProviderName is the name of the provider you selected) is displayed. This page displays the properties for a JNDI provider, as shown in the following table.
Table 24-8 Details of JNDI Provider Properties
Property
Description
Resource Name
The name assigned to this JNDI Provider.
Last Modified By
The name of the AquaLogic Service Bus user who last 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.
References
The number of objects that this JNDI Provider references. If such references exist, click the link to view a list of the references. To learn more, see Viewing References.
Referenced By
The number of objects that reference this JNDI Provider. If such references exist, click the link to view a list of the objects. To learn more, see Viewing References.
Provider URL
The URL for the JNDI Provider.
User Name
The user name used to access a secure JNDI Provider.
Password (and Confirm Password)
The password used to access a secure JNDI Provider.
Description
The description of this JNDI Provider.
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session. To learn more, see Using the Change Center.
Click Edit. The Edit JNDI Provider - ProviderName page (where ProviderName is the name of the provider you selected) is displayed.
Note:
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.
Note:
If the JNDI Provider was configured with a username 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 username and password, then the User Name field will be editable, and you can enter a new user name.
Click Save.
Note:
The configuration changes are saved in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.
To Test the Connection to a JNDI Provider
Note:
You can test a JNDI Connection both, inside or outside of a session.
A connection to the JNDI provider will be established using the Provider URL configured for this JNDI Provider resource. If there is a problem with the connection to the JNDI Provider, an error message indicating the error encountered will be displayed. Make the necessary correction to the URI and test again.
To Reset a JNDI Provider
Note:
You can reset the cache for a JNDI Provider only outside of an AquaLogic Service Bus session.
If you have not already done so, from the left navigation pane, in the Change Center, click Create to create a new session. To learn more, see Using the Change Center.
From the left navigation pane, select JNDI Providers in System Administration. The Summary of JNDI Providers page is displayed.
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 Listing and Locating JNDI Providers).
In the Options field of the JNDI Provider you want to delete, click the Delete Icon.
Note:
If this JNDI Provider is referenced by other ALSB resources, you will not be able to delete this JNDI provider. A Delete icon with a red X is displayed when the resource cannot be deleted.You can undo the deletion of this resource. To learn more, see Undoing a Task.
The JNDI Provider resource is deleted in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.
The Summary of SMTP Servers page allows you to 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. SMTP Server resources are used while configuring Alert Destination resources and E-mail transport based Business Services. To learn more, see Overview of Alert Destinations, and E-mail Transport Configuration Information
You can also designate one of the configured SMTP servers as the default server for the domain.
Listing and Locating SMTP Servers
The Summary of SMTP Servers page allows you to view a list of SMTP Servers. To learn more, see Overview of SMTP Servers.
To List and Locate SMTP Servers
From the left navigation pane, select SMTP Servers from under System Administration. The Summary of SMTP Servers page is displayed. This shows the following information for each SMTP Server. For a more detailed description of the properties, see the following table.
Click the Delete icon to delete a specific SMTP server. To learn more, see Deleting an SMTP Server
To locate a specific SMTP Server, do the following:
Sort the list. Ascending and descending arrows indicate columns by which you can sort the list-in this case, the Name and URL columns. Click the arrow in the relevant column to change the sort order.
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session. To learn more, see Using the Change Center.
From the left navigation pane, select SMTP Servers from under System Administration. The Summary of SMTP Servers page is displayed
Click Add. The Add New SMTP Server page is displayed.
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. 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.
Note:
These fields are optional, and required only if the SMTP server is secured.
Click Save.
Note:
The new SMTP Server resources are saved in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session. To learn more, see Using the Change Center.
From the left navigation pane, select SMTP Servers from under System Administration. The Summary of SMTP Servers page is displayed
Under Default SMTP Server, click Select Default. The Select Default SMTP Server page is displayed.
In the Default SMTP Server drop-down list, select the required 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.
Note:
The Default SMTP Server is saved in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.
Click the SMTP Server name. The SMTP Server Details page is displayed. This page displays the following information.
Table 24-10 SMTP Server Configuration Details
Property
Description
Resource Name
The name assigned to this SMTP Server.
Last Modified By
The name of the AquaLogic Service Bus user who made the last configuration change to this SMTP Server resource.
Last Modified On
The date and time on which the last configuration change was made.
References
The number of objects that this SMTP Server references.If such references exist, click the link to view a list of the references. To learn more, see Viewing References.
Referenced By
The number of objects that reference this SMTP Server. If such references exist, click the link to view a list of the objects. To learn more, see Viewing References.
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
Description
The description of this SMTP Server, if provided.
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session. To learn more, see Using the Change Center.
Click Edit. The Edit SMTP Server - ServerName page (where ServerName is the name of the SMTP server you selected) is displayed.
Note:
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 Username and Password fields.
Click Save.
The configuration changes are saved in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session. To learn more, see Using the Change Center.
Note:
You cannot delete an SMTP server resource that is referenced by other AquaLogic Service Bus resources. A Delete icon with a red X is displayed when the resource cannot be deleted.
From the left navigation pane, select SMTP Servers from under System Administration. The Summary of SMTP Servers page is displayed. In the Summary of SMTP Servers page, select an SMTP Server. (See Listing and Locating SMTP Servers).
In the Options field of the SMTP Server resource you want to delete, click the Delete icon.
The SMTP Server resource is removed from the list.
Note:
You cannot delete a resource if it is referenced by other resources in AquaLogic Service Bus. Instead of the Delete icon, a Delete icon with a red X is displayed for these resources.
Note:
If necessary, you can undo the deletion of this resource. To learn more, see Undoing a Task.
The SMTP Server resource is deleted in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.
