Using the AquaLogic Service Bus Console

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

Using the Change Center

This section includes the following topics:

Overview of the Change Center

The Change Center allows for team collaboration when services and metadata are being configured in AquaLogic Service Bus. Each user works in a sandbox "session" until the user is ready to check in the working configuration to the core configuration of the bus. Change center provides multiple levels of undo, and visibility into conflicts, as multiple users work on the configuration.

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.

Table 2-1 Change Center Pages, Tasks, and Help Topics
Page
Associated Tasks
Help Topics
View Conflicts
Inside session only: This link displays the number of conflicts occurring in a session. 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.
View 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.
 
Inside session: Undo a change you have made during the current session.
Outside session: Undo an activation of a session
Find and Replace
Inside session: Find and replace environment values
Outside session: Find environment values (Replace is disabled)
View All Sessions
Inside and outside session: View all existing sessions within the AquaLogic Service Bus Console.
Activate Session
Inside session only: Activate the session
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

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

  3. Make the appropriate changes on the relevant page of the console.
  4. Click Save on each page where you make a change. All the changes you have made so far in the current session are saved.
  5. 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.
  6. 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 persist 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 allows 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 shows the session name, user name, and a Description field.
  2. If there are validation errors, an error message is displayed, indicating that your session has validation errors. View and fix configuration conflicts before you proceed to step 3. For information on fixing conflicts, see Viewing and Resolving Conflicts.
  3. Note: You will not be able to activate the session until you have viewed all conflicts. If new conflicts arise while you view the existing conflicts, before you activate, a message pops up informing you of the new conflicts.
  4. 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.
  5. To activate the session, click Submit. If no new conflicts have arisen in the interim, 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. Table 2-2 In-Session Configuration Changes
    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.
    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 will contain "None" 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. Table 2-3 Activated Configuration Changes
    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 will contain "None" 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.

 


Purging Session Activation History

In the View Configuration Changes page, you can purge sessions activated over a specific period, delimited by start and end dates. This action can only be performed out of session.

WARNING: Purging session activation history involves deleting data that enables multiple levels of undo. In other words, if you purge session activation history for a specific period, you will not be able to undo sessions activated during that period.
To Purge Session Activation History
  1. Ensure that you are not in an active session, and click View Changes. The View Configuration Changes page is displayed.
  2. In the View Configuration Changes page, click Purge By Date. The Purge Session Activation History by Date page is displayed.
  3. Enter the Start and End dates, in their respective fields, in the format: MM/DD/YYYY.

The session activation history for all sessions between the dates specified will be deleted from the AquaLogic Service Bus.

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. AquaLogic Service Bus allows you to undo multiple levels of session activation, constrained only by your system resources. To learn more about this page, see Viewing Configuration Changes.

Note: If you upgrade from AquaLogic Service Bus version 2.1 to version 2.5, you will not be able to undo sessions activated before the upgrade. Sessions activated after the upgrade will be available in the session activation history, for undo.
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.

Note: You can undo any change in the current session. However after that, if you change your mind, you can undo the undo, or if you again change your mind, you can undo the undo that undid a previous undo, and so on.
To Undo a Session That Was Activated Earlier
  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. Do one of the following:
    • In the Options column for a specific task, click the Undo icon. The session activation is undone.
    • OR

    • In the Options column for a specific task, select the Undo into Session icon. 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. AquaLogic Service Bus supports unlimited undo. This means you can undo the undo that undid a previous undo, and so on.

Undoing Into a Session

Note: If semantic errors result from undoing a session activation, you are prevented from doing the undo. However there is an alternative in this case. You can undo the session activation and have the changes put into a new session. You can then fix the semantic errors and activate the session. You can also use this capability of undoing into a session to explore the ramifications of a session activation undo. You can examine all the changes that result, and decide if you really want to do the undo. If you decide that you really want to, you can activate the session.

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 Change Center module, click the name of the task in the Task column. The Task Details page is displayed, which shows the following information for each task.
  2. Table 2-4 Task Details
    Property
    Description
    Task
    The type of task you performed:
    • Create
    • Update
    • Delete
    • Rename
    • Move
    Resource Type
    Any of these resource types:
    • Business Service
    • Proxy Service
    • WSDL
    • XML Schema
    • WS-Policies
    • XQuery
    • XSLT
    • MFL file
    • Service Account
    • Alert Rule
    • JNDI Provider
    • SMTP Server
    • Alert Destination
    • JAR
    • POJO
    • Proxy Service Provider
    • UDDI Registry
    Resource
    The name and path of the resource. The path is the name of the project and 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. Table 2-5 Session Details
    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 en masse, 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—URI, IMAP Move Folder, Mail Server Host, JNDI Provider URL, SMTP Server URL, UDDI Registry URL, or File Path.

    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. The view conflicts link also displays the number of live conflicts in the session.

View Conflicts

  1. From the left navigation pane, click View Conflicts from under Change Center. The View Conflicts page can display any or all of the following sets of information depending on the nature of any conflicts:
    • Concurrent Updates—warn you about incompatible changes with other activated sessions.
    • Diagnostic Messages—inform you of critical conflicts within your configuration.
    • Informational Messages - informs you of any non-critical conflicts within your configuration.
    • Table 2-6 Diagnostic Messages
      Property
      Description
      Name
      The resource to which the diagnostic message refers. The name is a link to that resource.
      Path
      The project and folder in which the resource resides.
      Resource Type
      The resource type
      Messages
      A description of the conflict. To resolve the conflict, see Resolve Conflicts.

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


  Back to Top       Previous  Next