Skip navigation.

Using the AquaLogic Service Bus Console

  Previous Next vertical dots separating previous/next from contents/index/pdf Contents View as PDF   Get Adobe Reader

Using the Change Center

This section includes the following topics:

 


Overview of the Change Center

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.

Page

Associated Tasks

Help Topics

View Configuration Changes

Inside session: View the configuration changes you have made during the current session.

Outside session: View configuration changes that are caused by previous session activations.

Viewing Configuration Changes


Inside session: Undo a change you have made during the current session.

Outside session: Undo an activation of a session

Undoing a Task

View All Sessions

Inside and outside session: View all existing sessions within the AquaLogic Service Bus Console.

Viewing All Sessions

Activate Session

Inside session only: Activate the session

Activating a Session

Find and Replace

Inside session: Find and replace environment values

Outside session: Find environment values (Replace is disabled)

Finding and Replacing Environment Values

View Conflicts

Inside session only: View and resolve all conflicts between changes in the current session and those made by all other sessions within the AquaLogic Service Bus Console. A conflict occurs if a resource modified in the current session has already been modified and activated by another session. Two changes to the same resource by two sessions do not cause a conflict until one of the sessions is activated.

This page also displays semantic errors for resources in the session.

Viewing and Resolving Conflicts

Task Details

Inside session: View details of a specific change you made in the current session

Outside session: View details of specific changes made by a previous session activation

Viewing Task Details


 

Related Topics

Using the Change Center

 


Using the Change Center

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.

To Use the Change Center

  1. From the left navigation pane, select Change Center.
  2. Click Create to begin a session. The name of the session is displayed in the left navigation pane under Change Center.
  3. 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.

  4. Make the appropriate changes on the relevant page of the console.
  5. Click Save on each page where you make a change. All the changes you have made so far in the current session are saved.
  6. 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.

  7. When you have finished making changes, click Activate in the Change Center. Continue in Activating a Session.

About Exiting a Session

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.

Related Topics

Overview of the Change Center

Viewing Configuration Changes

Undoing a Task

Viewing Task Details

Viewing All Sessions

Finding and Replacing Environment Values

Viewing and Resolving Conflicts

 


Activating a Session

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.

To Activate a Session

  1. Click Activate in the Change Center. The Activate Session page is displayed, which displays the session name, user name, and a Description field.
  2. Enter a description in the Description field. This description is displayed in the Description column when you click View Changes under Change Center to display configuration changes caused by session activations.
  3. To activate the session, click Activate. The session ends and the configuration is deployed to run time.

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.

Related Topics

Viewing Configuration Changes

Undoing a Task

Viewing Task Details

Viewing All Sessions

Finding and Replacing Environment Values

Viewing and Resolving Conflicts

 


Viewing Configuration Changes

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.

To View Configuration Changes in a Session

  1. 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.
  2. Make at least one change to the configuration.
  3. From the left navigation pane, click View Changes from under Change Center. The View Configuration Changes page displays the following information for each change you have made to the configuration during the current session:
  4. Property

    Description

    Task

    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.

    Description

    An additional description of the session that was activated, if a description was entered when the session was activated using the Activate Session page.

    Execution Time

    The date and time that the task was executed

    User

    The name of the user who implemented the change

    Task Status

    The status of the task:

    Completed—the task was completed

    Undone—the task was undone

    Undo Completed—the undo was completed

    Undone By

    The name of the user who undid the task. This field remains blank if the task has not been undone.

    Options

    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.


     

To View Configuration Changes Caused by Session Activations

  1. Make sure you are not in a session.
  2. From the left navigation pane, click View Changes from under Change Center. The View Configuration Changes page displays the following information for each session you have previously activated:
  3. Property

    Description

    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.

    Description

    An additional description of the session that was activated, if a description was entered when the session was activated using the Activate Session page.

    Execution Time

    The date and time that the session was activated

    User

    The name of the user who activated the session

    Task Status

    The status of the session:

    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.

    Undone By

    The name of the user who undid this task. This field remains blank if the session activation has not been undone.

    Options

    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.


     

Related Topics

Overview of the Change Center

Activating a Session

Viewing All Sessions

Finding and Replacing Environment Values

Viewing and Resolving Conflicts

 


Undoing a Task

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.

To Undo a Task in a Session

  1. Make sure you are in a session.
  2. From the left navigation pane, click View Changes from under Change Center. The View Configuration Changes page is displayed.
  3. In the Options column for a specific task, click the Undo icon.
  4. The task is undone.

To Undo a Session Activation

  1. Make sure you are outside a session.
  2. From the left navigation pane, click View Changes from under Change Center. The View Configuration Changes page is displayed.
  3. In the Options column for a specific task, click the Undo icon.
  4. The session activation is undone.

  5. In the Options column for a specific task, select the Undo into Session icon.
  6. A new session is created pre-populated with the tasks needed to undo the changes activated in the session.

Order of Undoing Tasks

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.

Related Topics

Overview of the Change Center

Using the Change Center

Activating a Session

Viewing All Sessions

Finding and Replacing Environment Values

Viewing and Resolving Conflicts

Viewing Task Details

 


Viewing Task Details

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.

To View Task Details

  1. On the View Configuration Changes page in the System Administration module, click the name of the task in the Task column. The Task Details page is displayed, which displays the following information for each task:
  2. Property

    Description

    Task

    The type of task you performed:

    • Create

    • Update

    • Delete

    Resource Type

    Any of these resource types:

    • Project

    • Folder

    • Business Service

    • Proxy Service

    • WSDL

    • XML Schema

    • WS-Policies

    • XQuery

    • XSLT

    • MFL file

    • Service Account

    • Service Provider

    Resource

    The name and path of the resource. The path is the project name and the name of the folder in which the resource resides.


     
  3. Click Back to return to the View Configuration Changes page.

Related Topics

Overview of the Change Center

Using the Change Center

Activating a Session

Viewing Configuration Changes

Viewing All Sessions

Finding and Replacing Environment Values

 


Viewing All Sessions

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.

To View All Sessions

  1. From the left navigation pane, click View All Sessions from under Change Center. The View All Sessions page displays the following information for each existing session:
  2. Property

    Description

    Session Name

    The name of the session. The name is a link to the session.

    User

    The name of the user who created the session.

    Creation Time

    The date and time the session was created.

    Last Modified

    The date and time a change was last made during the session.

    # of Objects Modified

    The number of objects that have been changed during the session.


     
  3. To switch to another session, click the link in the Session Name column for that session.

Note: The same user logged in with multiple browsers is not supported. It causes unpredictable behavior in the console.

Related Topics

Overview of the Change Center

Using the Change Center

Activating a Session

Viewing Configuration Changes

Finding and Replacing Environment Values

Viewing and Resolving Conflicts

 


Finding and Replacing Environment Values

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.

To Find and Replace Environment Values

  1. In the Find field, enter the environment value that you want to locate.
  2. To display a list of environment values in your configuration that contain the value you entered, click Find.
  3. 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.

  4. In the Replace field, enter the new environment value.
  5. To replace the original environment value with the new value, click Replace All.
  6. All occurrences of the environment value you entered in the Find field are replaced with the environment value you entered in the Replace field.

Related Topics

Overview of the Change Center

Using the Change Center

Activating a Session

Viewing Configuration Changes

Viewing All Sessions

Viewing Task Details

Viewing and Resolving Conflicts

 


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:

View Conflicts

  1. From the left navigation pane, click View Conflicts from under Change Center. The View Conflicts pagecan display one, two or all of the following sets of information depending on the nature of any conflicts.
  2. 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:

    Table 2-1 Diagnostic Messages

    Property

    Description

    Name

    The resource to which the diagnostic message refers. The name is a link to that resource.

    Resource Type

    The resource type

    Messages

    A description of the conflict. To resolve the conflict, see Resolve Conflicts.


     
  3. To display details of a specific conflict, click the link in the Name column for that conflict.
  4. 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:

    Table 2-2 Concurrent Updates

    Property

    Description

    Name

    The resource in conflict. The name is a link to that resource.

    Your Changes

    A description of the changes you made to this object in your session.

    Other's Changes

    A description of the changes another user made to this object in their session.

    Synchronize

    Click the Synchronize icon to return this object to the state in which it is saved in the run time.


     

Resolve Conflicts

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:

JMS Endpoint URIs Must be Available To Activate a Session

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.

Related Topics

Overview of the Change Center

Using the Change Center

Activating a Session

Viewing Configuration Changes

Viewing All Sessions

Viewing Task Details

Finding and Replacing Environment Values

 

Skip navigation bar  Back to Top Previous Next