Using the AquaLogic Service Bus Console
This section includes the following topics:
The following table lists the pages you can access from the Change Center module. The tasks and help topics associated with each are provided.
Note: Most of the Change Center pages display different information based on whether you are in a session (that is, you have clicked Create or Edit in the Change Center) or outside a session. For example, in a session, the View Configuration Changes page lists all the changes you have made in that session; outside a session, the page lists all session activations.
The Change Center module is the starting point for using the AquaLogic Service Bus Console to make changes to your configuration. To make any changes using the console, you must use the Change Center to start a session.
Starting the session enables you to make changes using the AquaLogic Service Bus Console. For example, you can create a resource, edit a resource, delete a resource, or import a configuration.
Note: From the left navigation pane, click Discard at any time during the session to delete the changes you have made so far in the current session. The session also ends.
From the left navigation pane, click Exit under Change Center at any time to exit the session. However, the session does not end. You can click Edit from the left navigation pane to return to the session and continue making changes. This behavior also applies if you click Logout to log out of the Console or close your browser. The session and all changes that you have made in the session are persisted even if you log out of the console or the server is restarted.
Finding and Replacing Environment Values
Viewing and Resolving Conflicts
The Activate Session page enables you to activate sessions. The page is displayed when you click Activate in the Change Center. To learn more, see Using the Change Center.
Note: Creating a session, and discarding a session proceed regardless of other activity in the system. However, if another session is in the process of being activated, the Session Activation page displays an error indicating the user that has the pending Weblogic Server changes.
Finding and Replacing Environment Values
Viewing and Resolving Conflicts
The View Configuration Changes page displays different information based on whether you are in a session (that is, you have clicked Create or Edit in the Change Center) or outside a session. When you are in a session, the page displays a list of configuration changes that you have made during the current session. To learn more, see To View Configuration Changes in a Session. When you are outside a session, the page displays a list of configuration changes that were caused by previous session activations. To learn more, see To View Configuration Changes Caused by Session Activations.
A description of the task that was implemented. The task is a link to the Task Details page. To learn more, see Viewing Task Details. |
|
An additional description of the session that was activated, if a description was entered when the session was activated using the Activate Session page. |
|
The name of the user who undid the task. This field remains blank if the task has not been undone. |
|
Click the Undo icon to reverse the execution of the task. When you are working in a session, you can undo tasks in any order. As a result of undoing a task, the object of the task reverts to the state it was in before the task in question was performed. Note however, that any tasks that were performed on the same object after the task that you undo are also undone. To learn more, see Undoing a Task. |
A description of the session that was activated. The task is a link to the Task Details page, which displays the operations that were performed in the session. To learn more, see Viewing Task Details. |
|
An additional description of the session that was activated, if a description was entered when the session was activated using the Activate Session page. |
|
Activated—the session was activated. Undone—the session was undone and all the operations performed in the session were lost. Undo Activated—the undo was activated In Progress— displayed if a session activation is in progress, as session activations can take a long time. Failed —displayed if a session activation fails. AquaLogic Service Bus tracks session activation failures but not failures due to individual updates inside a session. |
|
The name of the user who undid this task. This field remains blank if the session activation has not been undone. |
|
Click the Undo icon to reverse the session activation and the operations performed in that session. You can undo session activations in any order. Click the Undo into Session icon to create a new session pre-populated with the tasks needed to undo the changes activated in the session. To learn more, see Undoing a Task. |
Finding and Replacing Environment Values
Viewing and Resolving Conflicts
The View Configuration Changes page allows you to undo tasks that you have performed in your AquaLogic Service Bus configuration during your current session, and allows you to undo session activations outside of a session. To learn more about this page, see Viewing Configuration Changes.
You can undo tasks in any order (provided that individual undo actions result in valid data). The undo operation sets the value of a resource to the value it had before the change to that resource.
In the case that the task that is being undone was one that created an object, there is no previous state to which an object can be returned—in other words, no object existed before this task was performed. Effectively, the undo operation deletes the new object from the session. In this case, errors occur for the objects that reference the one being deleted. You can view such errors on the View Conflicts page in the Change Center.
When you are not working in a session, you can access the View Configuration Changes page to see the sessions that were previously activated. You can undo these sessions. The system does not allow you to undo a session that was previously activated if an error in the run time configuration would result from the undo action. For example, if you attempt to undo a session activation that results in the removal of an object that is being referenced by another object, that undo action is disallowed.
Note: It is possible to undo an undo action. In the Options column of the Undo of [task], click the Undo icon.
Finding and Replacing Environment Values
Viewing and Resolving Conflicts
The Task Details page allows you to view details of a specific change you made in the current session if you are in the session, and view details of specific changes you made in sessions that have been activated if you are outside a session.
The name and path of the resource. The path is the project name and the name of the folder in which the resource resides. |
Finding and Replacing Environment Values
The View All Sessions page allows you to view all existing sessions within the AquaLogic Service Bus Console. You can view these sessions if you are currently in a session or outside a session.
Note: You can only view all sessions if you are using the Administrator role.
The date and time a change was last made during the session. |
|
The number of objects that have been changed during the session. |
Note: The same user logged in with multiple browsers is not supported. It causes unpredictable behavior in the console.
Finding and Replacing Environment Values
Viewing and Resolving Conflicts
The Find and Replace page allows you to search for environment values that differ between different domains. Environment values (or environment dependent attributes) are certain predefined fields in the configuration data whose values are very likely to change when you move your configuration from one domain to another (for example, from test to production). There are two types of environment values in this release, which are found in the business service and proxy service definitions: URIs, and File/Directory names. The only difference between an environment value and a non-environment value is that you can change environment values in a wholesale manner using the Find and Replace page.
Note: You may need to modify many other objects when you move your configuration between domains. You must use the individual edit pages to change those values.
This page behaves differently based on whether or not you are in a session. If you are in a session, you can find and replace environment values; however, if you are outside a session, you can find environment values only; Replace All is disabled.
Note: Select the Options checkbox if you want to locate only items changed in your current session, and select the environment value type for which you want to search—URIs, IMAP Move Folders, Mail Server Hosts, or File Paths.
A list of relevant values is displayed, which includes the Owner, Type, and the Environment Value columns.
Viewing and Resolving Conflicts
The View Conflicts page allows you to view diagnostic messages about errors in your configuration, and to view and resolve conflicts between changes made in your session and other activated sessions.
Three categories of information can be displayed:
In the case where there are Concurrent WebLogic Server updates, the name of the user making those updates is displayed. These updates may either be the deployment of the changes made by another session activation, or another user is making WebLogic Server changes explcitly.
In the case that there are diagnostic messages for the objects in your session, the following information is displayed:
The resource to which the diagnostic message refers. The name is a link to that resource. |
|
A description of the conflict. To resolve the conflict, see Resolve Conflicts. |
In the case that the object to which you make changes in a session has changed in the run time since you began the Edit of the current session, the following information is displayed:
To resolve a conflict, use the information provided in the Messages column (as described in Table 2-1) to understand the problem, and then edit the object that is causing the conflict to fix the problem.
For the scenario in which you have a concurrent update conflict—that is, a conflict that occurs if a resource is modified in the current session that has already been modified and activated by another session (as described in Table 2-2), you can resolve the conflict in one of two ways:
When you attempt to activate a session with a JMS endpoint URI on another server (a single server other than the one on which you are working, or a managed server in a cluster), ensure that the destination server is available.
AquaLogic Service Bus does not allow registration of proxy services with JMS transport if the JMS endpoint URL specifies a destination that is unreachable. In other words, for JMS services, AquaLogic Service Bus checks if the specified connection factory exists; if it does not, a session activation error occurs.