Using the AquaLogic Service Bus Console

System Administration

This section includes the following topics:

Overview of System Administration

The following table lists the pages you can access from the System Administration module. The tasks and help topics associated with each are provided.

Page	Associated Tasks	Help Topics
Global Settings	Enable or disable global monitoring of all services	Enabling Monitoring
	Reset statistics for all services	Resetting Statistics for All Services
	Set the polling interval refresh rate for the Dashboard page	Setting the Dashboard Polling Interval Refresh Rate
Import Configuration Data	Import configuration data	Importing Configuration Data
Export Configuration Data	Export configuration data	Exporting Configuration Data
Runtime Tracing Status	Display runtime tracing status of proxy services	Displaying Runtime Tracing Status of Proxy Services
	Enable runtime tracing status of proxy services	Enabling Runtime Tracing Status of Proxy Services
UDDI Configuration	Configure a UDDI registry	Configuring a UDDI Registry
Import UDDI	Import a business service	Importing a Business Service from a UDDI Registry
Publish to UDDI	Publish a proxy service	Publishing a Proxy Service to a UDDI Registry

Enabling Monitoring

The Global Settings page enables you to turn on and off global monitoring of business and proxy services at the domain level. You can enable or disable monitoring for all services only when you are in a session.

To Enable Global Monitoring of 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 to run time. 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 starts to collect monitoring statistics immediately. 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 BEA 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.

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

Resetting Statistics for All Services

The Global Settings page enables 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.

Importing Configuration Data

The Import Configuration Data page enables 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, credentials, 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.

To Import Configuration Data

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:

Property	Description
Name	The name of the project.
Type	The resource type, which is Project.
References	The number of project references, if any exist.

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:

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.
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
References	The number of resource references, if any exist. Click the link to view the references. To learn more, see Viewing References.

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.

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

References

The number of resource references, if any exist. Click the link to view the references. To learn more, see Viewing References.

Uncheck the objects that you do not want to import.

Do one of the following:

To import the configuration JAR file, click Import. The Processing Configuration Data popup window is displayed. You should wait until this window closes before you do anything else on the console. The window is closed automatically when the system has finished importing the objects. The Import Configuration Data page is displayed, which includes a message that you have successfully deployed the data.
To disregard changes, click Cancel.

Review the Import Summary. The following information is displayed:

Property	Description
Status	Whether or not the resource was imported successfully.
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
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 to run time. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.

Exporting Configuration Data

The Export Configuration Data page enables you to export objects. You must be outside a session to use this page.

Note: You cannot export users, groups, roles, credentials, certificates or access control policies when you export a configuration, as these objects are created through WebLogic Server. You must create these objects again when you import the exported configuration into a new AquaLogic Service Bus domain.

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 enables you to export any other resources that reference this resource.

Click Export to create a configuration JAR file and export it. When you click Export, the Processing Configuration Data popup window is displayed. You should 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.

Displaying Runtime Tracing Status of Proxy Services

The Runtime Tracing Status page enables you to view the runtime tracing status of proxy services. To learn more about runtime tracing, and enabling runtime tracing for a proxy service, see Enabling Runtime Tracing Status of Proxy Services.

To Display Runtime Tracing Status of a Proxy Service

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:

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.

Note: Click View All to display all proxy services.

Enabling Runtime Tracing Status of Proxy Services

The Runtime Tracing Status page allows you to enable the runtime tracing status of 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.

This page also enables you to view the list of proxy services. To learn more, see Displaying Runtime Tracing Status of Proxy Services.

To Enable Runtime Tracing of a Proxy Service

From the left navigation pane, select Tracing Configuration from under System Administration. The Runtime Tracing Status page is displayed.

To enable runtime tracing status for a specific proxy service, select the checkbox associated with the proxy service.

To update the page, click Save changes.

Configuring a UDDI Registry

The UDDI Configuration page enables you to configure a UDDI registry and to make it available in AquaLogic Service Bus. Once 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 associate a single service account with a registry entry.

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 Configuration Settings

The following table describes the configuration properties for a UDDI registry. Every registry has a set of properties that must be configured. When configuring a UDDI registry, the following are required:

When importing from a registry, the Name and the Inquiry URL are required fields.

When publishing to a registry, the Name, Inquiry URL, Publish URL, Security URL, and Service Account are required input fields. The Service account is required to permit access to the registry when publishing a service.

Table 22-1 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.
Inquiry URL	This is the URL to the inquiring API endpoint. It enables you to locate and import a service.
Publish URL	This is the URL to the publication API endpoint. It enables you to publish services.
Security URL	This URL is used to get an authentication token so that you can publish to the registry.
Service Account	A service account allows you to configure a user name and password to provide authentication when publishing services or when importing services from a UDDI registry.The password is passed to the security URL to obtain an authentication token when publishing or importing services.
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 Registry

From the left navigation pane, select UDDI Configuration from under System Administration. The UDDI Configuration page is displayed.

Enter the name of the registry you want to find in the text box, or enter wild card characters (use * and ? as wildcards) 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 Configuration page. See Table 22-1 for a description of the properties that must be set when adding a registry.

To Add a Registry

From the left navigation pane, select UDDI Configuration from under System Administration. The UDDI Configuration page is displayed.

On the UDDI Configuration page, click Add registry.

The UDDI Configuration page changes to display the configuration properties that define the registry. The properties are described in Table 22-1.

Do the following:

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/uddi/inquiry.
This is a required field.

In the Publish URL field, enter a publish URL in the format http://host:port/uddi/publishing.

In the Security URL field, enter a security URL in the format http://host:port/uddi/security.

Enter the name of a service account or browse to the service account you wish to associate with the registry. To associate a service account with a registry see Selecting a Service Account.

Note: You must always add a service account if you specify a security URL.

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 Save to configure the registry with the settings provided.

Making Configuration Changes to an Existing Registry

To Edit the Registry Details

From the left navigation pane, select UDDI Configuration from under System Administration. The UDDI Configuration page is displayed.

On the UDDI Configuration page, from the list of available registries, select the Registry name. You can also search for a specific registry using the Search option.

The UDDI Configuration page changes to display the configuration properties that define the registry. The properties are described in Table 22-1

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.

Selecting a Service Account

When publishing services to a UDDI registry you must be authenticated and have a valid user name and password to gain access to the registry. The user name and password is implemented in AquaLogic Service Bus as a service account resource (using credentials).

To create a service account in AquaLogic Service Bus, see Overview of Service Accounts.

To learn more about adding a service account, see Adding a Service Account.

To associate credentials with the service account, see Adding a Credential.

To Select a Service Account for the Registry

When adding or updating a registry entry in the UDDI configuration page, click Browse to launch the Select Service Account page.

To locate a specific service account do one of the following

Click Search to filter by service account name.
In the Name and Path fields, enter the name and path of the search target, then click Search. The path is the project name and the name of the folder in which the service account resides. The service accounts matching the search criteria are displayed.
Click View all to display all service accounts

The service accounts found resulting form your search are listed on the Select ServiceAccount page.

Click Submit when you have made your selection.

Importing a Business Service from a UDDI Registry

You can import the following business services 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.

If a user needs authentication, then you need a user name/password to access the AquaLogic Service Registry. If you do not have one assigned to you, contact your Systems Administrator.

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

Click Create to start your session.
You can only import when you are in a session.

From the left navigation pane, select Import 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 (e.g. 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.

To import more services, click Import Another.

To make changes to your selections, click Back.

System Administration

Overview of System Administration

Enabling Monitoring

To Enable Global Monitoring of Services

To Disable Global Monitoring of Services

Related Topics

Resetting Statistics for All Services

To Reset Statistics for All Services

Related Topics

Importing Configuration Data

To Import Configuration Data

Related Topics

Exporting Configuration Data

To Export Configuration Data

Related Topics

Displaying Runtime Tracing Status of Proxy Services

To Display Runtime Tracing Status of a Proxy Service

Related Topics

Enabling Runtime Tracing Status of Proxy Services

To Enable Runtime Tracing of a Proxy Service

Related Topics

Setting the Dashboard Polling Interval Refresh Rate

To Set the Dashboard Polling Interval Refresh Rate

Related Topics

Configuring a UDDI Registry

UDDI Configuration Settings

Searching for a UDDI Registry

To Search for a Registry

Adding a UDDI Registry

Making Configuration Changes to an Existing Registry

Selecting a Service Account

Related Topics

Importing a Business Service from a UDDI Registry

To Import a Business Service

Related Topics

Publishing a Proxy Service to a UDDI Registry

To Publish a Proxy Service to a UDDI Registry:

Related Topics