[AIX HP-UX Linux Solaris Windows]

Migrating from an operating system that is no longer supported

Use the migration tools to migrate an earlier WebSphere Application Server Version 5.x or 6.0.x release that is running on an operating system that Version 6.1 does not support.

Before you begin

See Overview of migration, coexistence, and interoperability and Premigration considerations.

For help in troubleshooting problems when migrating, see Troubleshooting migration.

Tip: Before migrating from WebSphere Application Server Version 5.x or 6.0.x, use the backupConfig command or your own preferred backup utility to back up your existing configuration if you want to be able to restore it to its previous state after migration. Make sure that you note the exact name and location of this backed-up configuration.

Procedure

  1. Obtain the WebSphere® Application Server Version 6.1 utilities disk.

    This disk contains the migration/bin directory. This directory contains a special environment that you can use to run the WASPreUpgrade command without installing Version 6.1.

  2. Save the current configuration using the WASPreUpgrade script from the migration/bin directory of the WebSphere Application Server Version 6.1 utilities disk.

    Read WASPreUpgrade command for more information.

    Save the configuration in the migration_specific_backup directory.

    If the WASPreUpgrade command fails because the Java Development Kit (JDK) on the Version 6.1 utilities disk is not supported on the operating system that you are attempting to migrate, perform the following actions:
    1. Create a migration directory on your local system.
    2. Install an IBM certified JDK that is at the highest level that will run on your operating system.
      The JDK directory should be in the same directory as the migration directory that you created on your local system in the last step, or you should have a working symlink that allows Java to be invoked from that path.
      <directory>
        - migration directory
        - JDK/jre.pak/repository/package.java.jre/java/jre/bin/java
      
    3. Copy the WASPreUpgrade.bat (or WASPreUpgrade.sh) and the setupCmdLine.bat (or setupCmdLine.sh) files from the migration/bin directory of the WebSphere Application Server Version 6.1 utilities disk to the migration directory that you created on your local system.
    4. Edit the setupCmdLine.bat or setupCmdLine.sh file in your new migration directory.
      • Change WAS_HOME to point to the fully qualified path to the migration directory that you created
      • Change JAVA_HOME to point to the fully qualified path to your IBM Developer Kit or Java directory.
    5. Ensure that the executable bit is on for the setupCmdLine.sh and WASPreUpgrade.sh files in the migration directory that you created.
    6. Run the command from the migration directory that you created.
      Identify the backup directory and the location of the configuration files.
      migration_directory\WASPreUpgrade migration_specific_backup_directory file_path\WebSphere\AppServer node_name
      
  3. Shut down the WebSphere Application Server Version 5.x or 6.0.x release by stopping all server nodes in the configuration.
  4. Tar or zip the backup directory, and FTP it to another system.
  5. Install the new operating system, keeping the same host name.

    If possible, keep the system name and passwords the same as on the old system. Place any database files related to applications that you are migrating in the same path as on the previous system. In general, try to keep paths the same. If you do change paths and names, refer to Migrating to a Version 6.1 standalone application server on a remote machine. Make any changes before running the WASPostUpgrade command as described in a later step.

  6. FTP the backup directory from the other system, and unzip it.
  7. Install WebSphere Application Server Version Version 6.1.
  8. Use the Profile Management tool or the manageprofiles command to create a WebSphere Application Server Version Version 6.1 profile.
  9. Run the WASPostUpgrade command from the Version 6.1 app_server_root/bin directory.
    Specify the backup directory that you unzipped in step 6. See WASPostUpgrade command for the proper command syntax.
    app_server_root\bin\WASPostUpgrade WAS_HOME\migration
    



In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 31, 2013 2:56:59 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-nd-dist&topic=tmig_nsos
File name: tmig_nsos.html