> Upgrade Guide > In-Place Upgrade

Upgrade Guide

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

In-Place Upgrade

This section provides a detailed description of how to do an in-place upgrade of an AquaLogic Service Bus 2.1 domain to 2.5. AquaLogic Service Bus 2.5 runs on WebLogic Server 9.2.

A wizard is available to help with the upgrade process. Be aware, however, that there are manual steps that also must be performed.

 

Step 1: Backup the Existing 2.1 Domain

Manually back up the existing 2.1 domain (make a copy of it), including any parts of the domain specific to individual servers within the domain.

Note: Most of the domain directory contains information pertinent to all servers in the domain. However, in a domain, under the servers subdirectory, there is a subdirectory for each server in the domain—typically AdminServer and the subdirectory names of any managed servers. In those subdirectories there is information pertinent only to those servers. For example, the log files for individual servers are stored in those subdirectories.

 

Step 2: Export the 2.1 Configuration

To export the 2.1 configuration:

  1. Open the AquaLogic Service Bus 2.1 console, and from the navigation pane on the left select System Administration. Then select Export Resources under System Administration.
    2. Note: You only need to export (select) those resources that you want to retain after the upgrade.
  2. Click Export under Export Configuration Data, then save the configuration JAR file (default is sbconfig.jar) to a location of your choice.

For more information about exporting configurations, see "Exporting Configuration Data" in System Administration in Using the AquaLogic Service Bus Console.

Note: You can also use the deployment MBean (DeploymentMBean) to export configuration data. For information about using DeploymentMBean, see Using the AquaLogic Service Bus Deployment API in the AquaLogic Service Bus Deployment Guide and the AquaLogic Service Bus Javadoc.

 

Step 3: Delete the Configuration from the 2.1 Domain

To delete the configuration from the AquaLogic Service Bus 2.1 domain:

  1. Create an AquaLogic Service Bus session. For information about doing so, see Using the Change Center in Using the AquaLogic Service Bus Console.
  2. Select all of the general and global resources for the session and delete them.
    3. Note: The existence of dependencies may require you to delete resources in a particular order, or it may require you to delete projects rather than resources.
  3. Activate the session.

 

Step 4: Shut Down the 2.1 Domain

To shut down the AquaLogic Service Bus2.1 domain:

  1. Exit the AquaLogic Service Bus Console (logout).
  2. Shut down WebLogic Server.

 

Step 5: Run the AquaLogic Service Bus Upgrade Wizard

Run the AquaLogic Service Bus upgrade wizard to upgrade the AquaLogic Service Bus 2.1 domain.

  1. Start the AquaLogic Service Bus Wizard in one of the following ways:
    • From the Windows Start menu, select
      StartArrow symbolAll ProgramsArrow symbolBEA ProductsArrow symbolToolsArrow symbolService Bus Domain Upgrade.
    • From the command line on Windows, cd to BEA_HOME\weblogic92\common\bin\, type upgrade-alsb.cmd, and press Enter.
    • From the command line on Unix/Linux, cd to BEA_HOME/weblogic92/common/bin/, type upgrade-alsb.sh, and press Enter.

      • BEA_HOME represents the directory in which you installed AquaLogic Service Bus.

  2. The Welcome screen is displayed. It lists the prerequisites for upgrading your AquaLogic Service Bus 2.1 domain. Please read it and make sure you have met these prerequisites. Then click Next. The Select a Domain to Upgrade screen is displayed.
  3. From the tree view, select the domain you want to upgrade and click Next.
    4. Note: If the domain is not valid, the following message is displayed:
    Unable to read domain configuration! This is not recognized as a valid domain directory.

    If you select a domain that has already been upgraded, the following message is displayed:
    The selected domain directory is already an AquaLogic Service Bus 2.5 domain; no upgrade is needed.
  4. Select from the following options:
    • Back up the current domain (recommended)
    • Add log files to backup zip
    • Do not set backwards compatibility flags
  5. Click Next to proceed with the upgrade.

As the upgrade progresses, messages are displayed that provide information about the changes being made by the wizard. When the upgrade process is complete, a summary is displayed.

 

Step 6: Start the 2.5 Domain

Start the newly upgraded AquaLogic Service Bus 2.5 domain. On Windows, you can select

StartArrow symbolAll ProgramsArrow symbolBEA ProductsArrow symbolUser ProjectsArrow symboldomain_nameArrow symbolStart Server for AquaLogic Server Bus Domain.

where, domain_name represents the name you gave the domain when you created it.

For more information, see Starting and Stopping Servers: Quick Reference in BEA WebLogic Server 9.2 Documentation.

Note: Because the AquaLogic Service Bus 2.1 configuration was deleted in Step 3, only the default AquaLogic Service Bus 2.5 configuration exists in the domain at this stage.

 

Step 7: Import the 2.1 Configuration and Activate the Session

  1. Start the AquaLogic Service Bus Console if it is not already running.
  2. Select System AdministrationArrow symbolImport Resources.
    3. Note: You must now be working in a session.
  3. Browse to locate the configuration JAR that you exported in Step 2.
  4. Select it and click Next, then Import.
  5. If there are any validation errors, fix them now.
  6. See Upgrade Considerations.
  7. In the Change Center, click Activate.

This completes the upgrade of your domain to AquaLogic Service Bus 2.5.

For a complete description on how to use the AquaLogic Service Bus Console, see Using the AquaLogic Service Bus Console. For additional resources, see BEA AquaLogic Service Bus 2.5 documentation.


  Back to Top       Previous  Next