WebSphere Application Server - Express, Version 6.0.x     Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Migrating V5.x Express to V6 Express

You can migrate the configuration from V5.x WebSphere Application Server - Express to WebSphere Application Server - Express, V6.

Before you begin

This topic describes how to use the V6 WebSphere Application Server migration tools to migrate your applications and configuration from V5 WebSphere Application Server - Express to V6 WebSphere Application Server - Express.

Steps for this task

  1. Use the V6 Migration wizard to transfer configuration settings from V5 Express to V6 Express.
    1. Start the First steps console at the end of installation, or by issuing the following command from the firststeps directory:
      • [Linux]./install_root/firststeps/firststeps.sh
      • [Windows]install_root\firststeps\irststeps.bat
    2. Start the Migration wizard from the First steps console.

    The Migration wizard uses the WASPreUpgrade command line tool and the WASPostUpgrade command line tool to migrate the data and applications from V5 to V6.

    This step transfers configuration information for the V5 Express server resources, security, variables, and virtual hosts to the V6 Express product. All stored information is in XML files in the install_root/profiles/profile_name/config/cells directory of each product. For a full description of each XML file, see the Configuration documents and Configuration document descriptions topics in the information center.

    The WASPreUpgrade command line tool saves selected files from the /bin directory to a backup directory you specify on a wizard panel. Migration saves files from the following directories to the backup directory:
    • classes (This directory is not saved for iSeries platforms.)
    • config
    • installableApps
    • installedApps (or an alternate directory specified by the user)
    • properties (A subset of files in this directory is saved for iSeries platforms.)

    Later, the Migration wizard uses the WASPostUpgrade migration tool to restore the environment in the backup directory into the V6 Express installation.

  2. Resolve port differences.

    The Migration wizard displays a list of ports for Express. If the same port is used for more than one purpose, the migration tools log a message that states you must manually resolve the port conflict.

    Two groups of port differences can remain within port assignments in the virtual hosts file, at the cell level:
    • HTTP transport chains
      WebSphere Application Server and Express use different HTTP transport ports by default. To maintain port assignments used by Express when migrating to the base WebSphere Application Server product, add the Express port values at the server level:
      1. In the WebSphere Application Server administrative console, click the plus sign ("+") next to Servers
      2. Click Application Servers.
      3. Click the server on which you plan to install your applications.
      4. Click Web Container settings.
      5. Click Web container transport chains.
      6. Use Studio Site Developer to find the original V5 Express remote server HTTP transport ports:
        1. Display the Server Configuration view.
        2. Double-click the Express remote server that you are migrating.
        3. Click Ports.
        4. View ports defined under Server Settings.
      7. Click New in the V6 WebSphere Application Server administrative console to create additional entries needed to define a port.
    • Advanced ports

      There are a number of special purpose ports defined for Express. These ports are described in the Migrating and coexisting topic. Use non-conflicting values to continue to run both V5 Express and V6 Express on the same system (coexistence), or if WebSphere Application Server applications are dependent on the port values.

      Using V6 Express port values might require you to change applications. Change any references to port values that are changing. To identify Express applications that require port changes, modify the port configuration on the V5 Express installation to use V6 port values. Test the applications that you intend to migrate to identify port references that are in error.

      1. In the WebSphere Application Server administrative console, click the plus sign ("+") next to Servers.
      2. Click Application Servers to get a list of servers.
      3. Click the server on which you intend to install the applications.
      4. Click Ports.
      5. Use Studio Site Developer to find the original V5 Express remote server port assignments:
        1. Display the Server Configuration view.
        2. Double click the Express remote server that you are migrating.
        3. Click Ports.
        4. View Advanced Ports defined under Server Settings.
  3. Verify migrated applications.
    To verify that applications are installed successfully:
    1. Click Enterprise Applications in the administrative console.
    2. Check your migrated applications.
    3. Click Start.
    Verify that your applications start successfully.

Result

You can successfully migrate configuration files and applications from V5 Express to V6 Express.

What to do next

Return to Migrating product configurations to continue.



Related tasks
Migrating product configurations

Task topic    

Terms of Use | Feedback

Last updated: Jun 8, 2005 12:45:23 PM EDT
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.express.doc/info/exp/ae/tins_migexpress.html

© Copyright IBM Corporation 2004, 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)