IBM WebSphere Application Server v8.5.5 Product Migration Steps

Answer

The following document provides a basic example of the steps required to migrate from IBM WebSphere Application Server V6.1,V7.0, or v8.0 to V8.5.5.

NOTE: This document assumes the WebSphere Application Server product migration is occurring within the same IBM i OS VRM. If you are upgrading your IBM i OS VRM as well, IBM recommends you migrate your WebSphere Application Server product BEFORE the IBM i OS upgrade if possible. Refer to the IBM i OS Memo To Users for special considerations related to the IBM WebSphere Application Server product when upgrading your IBM i OS.

IBM i 7.4 Memo To Users
IBM i 7.3 Memo To Users
IBM i 7.2 Memo To Users
IBM i 7.1 Memo To Users

NOTE: This document provides information for migrating a stand-alone application server only. For detailed information on how to migrate a Network Deployment Deployment Manager and Federated Nodes, please refer to the URL, https://www.ibm.com/docs/en/was-nd/8.5.5?topic=mp-migrating-version-85-websphere-application-server-network-deployment-cell.

Steps to migrate your IBM WebSphere Application Server v6.1, v7.0, or v8.0 product and profiles to IBM WebSphere Application Server v8.5.5.

Some of the information in the following steps was taken from the IBM WebSphere Application Server v8.5.5 Docs.

1) Download the IBM i WebSphere Application Server V8.5.5 installation media.

• Information on how to download the various WebSphere Application Server v8.5.5 editions for the IBM i OS can be found here:
  
  Express edition:
  Download Web Enablement for IBM i
  NOTE: Once the archive .zip file of the ISO image is downloaded from IBM Entitled Systems Support (ESS), you will need to transfer the .zip file to an IFS directory on your IBM i server before installation.
  
  Base/Network Deployment (ND) editions:
  How to download WebSphere Application Server V8.5.5 from Passport Advantage Online
  NOTE: After downloading the .zip files from Passport Advantage, you will need to transfer and restore all of the .zip files to the same IFS directory on your IBM i server before installation.

2) Install the IBM WebSphere Application Server V8.5.5 product on your IBM i OS.

• How To Install the IBM WebSphere Application Server v8.0 and Later Product Using the IBM Web Administration for i Console
  
  NOTE: Ensure the IBM WebSphere Application Server v8.5.5 product and latest WebSphere Application Server fix pack are installed successfully prior to moving on to step 3.

3) Identify the Default Profile Location for the WebSphere Application Server installation you are migrating FROM.

• a) Execute the following commands to display the default profile location for the WebSphere Application Server installation you are migrating FROM.
  
  STRQSH
  /QIBM/WAS/bin/queryWASinstalls
  
  b) The queryWASinstalls command will display all of the currently installed WebSphere Application Server versions and editions on your IBM i server. Identify the WebSphere Application Server version and edition you are migrating FROM.
  
  Example:
  WebSphere Edition:      EXPRESS                                        
  Version:                7.0.0.37                                        
  Installation Location:  /QIBM/ProdData/WebSphere/AppServer/V7/Express  
  Installation Library:   QWAS7A                                        
  Default Profile Location: /QIBM/UserData/WebSphere/AppServer/V7/Express
  
  c) Identify and record the "Default Profile Location". This value will be referred to as $SOURCE_DEFAULT_PROFILE_LOCATION in the next step.
  
  Example: Default Profile Location: /QIBM/UserData/WebSphere/AppServer/V7/Express
  /QIBM/UserData/WebSphere/AppServer/V7/Express = $SOURCE_DEFAULT_PROFILE_LOCATION

4) Identify the Installation Location for the WebSphere Application Server installation you are migrating TO.

• a) Execute the following commands to display the installation location for the WebSphere Application Server installation you are migrating TO.
  
  STRQSH
  /QIBM/WAS/bin/queryWASinstalls
  
  b) The queryWASinstalls command will display all of the currently installed WebSphere Application Server versions and editions on your IBM i server. Identify the WebSphere Application Server version and edition you are migrating TO. This will be your WebSphere Application Server v8.5.5 installation.
  
  Example:
  WebSphere Edition:      EXPRESS                                        
  Version:                8.5.5.7                                        
  Installation Location:  /QIBM/ProdData/WebSphere/AppServer/V85/Express  
  Installation Library:   QWAS85A                                        
  Default Profile Location: /QIBM/UserData/WebSphere/AppServer/V85/Express
  
  c) Identify and record the "Installation Location". This value will be referred to as $TARGET_INSTALL_LOCATION in the next step.
  
  Example: Installation Location:  /QIBM/ProdData/WebSphere/AppServer/V85/Express  
  /QIBM/ProdData/WebSphere/AppServer/V85/Express = $TARGET_INSTALL_LOCATION

5) Identify the WebSphere Application Server profiles you want to migrate.

• a) Execute the following CL command to display the profiles for your source WebSphere Application Server version and release.
  
  WRKLNK '$SOURCE_DEFAULT_PROFILE_LOCATION/profiles/*'
  where $SOURCE_DEFAULT_PROFILE_LOCATION is the value identified in step 3.
  
  Example: WRKLNK '/QIBM/UserData/WebSphere/AppServer/V7/Express/profiles/*'
  
  There will be a directory listed for each profile that currently exists in your source WebSphere Application Server installation.
  
  
  
  b) Pick the WebSphere Application Server profile name you want to migrate.
  I will refer to this profile name as $SOURCE_PROFILE.
  
  Example: $SOURCE_PROFILE = jared70ex

6) Identify the source WebSphere Application Server profile's node and server names.

• a) Execute the following commands to identify the source WebSphere Application Server profile's node and server names.
  
  STRQSH
  cd $SOURCE_DEFAULT_PROFILE_LOCATION/profiles/$SOURCE_PROFILE/bin
  ./dspwasinst
  
  Example:
  STRQSH
  cd /QIBM/UserData/WebSphere/AppServer/V7/Express/profiles/jared70ex/bin
  ./dspwasinst
  
  b) Page up and locate the values next to the following attributes in the dspwasinst command output.
  
  Node:
  Information for server:
  
  Example:
  Node: AS400_JARED70EX
  Information for server: jared70ex
  
  I will refer to the value of the "Node:" attribute as $NODE and the value of the "Information for server:" attribute as $SERVER.

7) Create a new IBM WebSphere Application Server v8.5.5 profile using the same profile, node, and server names as the previous WebSphere Application Server profile.

• a) Execute the following commands to create a new profile using the same profile, node, and server names as the WebSphere Application Server profile you are migrating FROM.
  
  NOTE: The WebSphere Application Server profile, server, and node names must remain the same values as the original profile for the migration process to complete successfully.
  
  STRQSH
  cd $TARGET_INSTALL_LOCATION/bin
  ./manageprofiles -create -profileName $SOURCE_PROFILE -serverName $SERVER -nodeName $NODE -startingPort <port>
  
  where $TARGET_INSTALL_LOCATION is the value determined in step 4 above.
  $SOURCE_PROFILE = the previous WebSphere Application Server profile name identified in step 5b.
  $SERVER = the previous WebSphere Application Server profile's server name identified in step 6.
  $NODE = the previous WebSphere Application Server profile's node name identified in step 6.
  <port> = any port you want to use.
  
  Example:
  STRQSH
  cd /QIBM/ProdData/WebSphere/AppServer/V85/Express/bin
  ./manageprofiles -create -profileName jared70ex -serverName jared70ex -nodeName AS400_JARED70EX -startingPort 10000

8) Back up the source WebSphere Application Server profile using the WASPreUpgrade command.

• The WASPreUpgrade command creates a backup of the source WebSphere Application Server profile's pertinent configuration information. The contents of the backup are specific to the source WebSphere Application Server profile's version and configuration setup.
  Syntax for the WASPreUpgrade command:
  WASPreUpgrade backupDirectory currentWebSphereDirectory
  [-traceString trace_spec]
  [-traceFile file_name]
  [-machineChange true | false]
  [-oldProfile old_profile_name]
  [-workspaceRoot user_workspace_folder]
  
  Additional information on the WASPreUpgrade command and its usage can be obtained here.
  
  a) Create an IFS directory to store the WebSphere Application Server profile data.
  
  MKDIR '/tmp/$SERVER'
  where $SERVER is the value determined in step 6.
  
  b) Execute the WASPreUpgrade command to back up the source WebSphere Application Server profile.
  
  STRQSH
  cd $TARGET_INSTALL_LOCATION/bin
  ./WASPreUpgrade /tmp/$SERVER $SOURCE_DEFAULT_PROFILE_LOCATION/profiles/$SOURCE_PROFILE
  
  where
  $TARGET_INSTALL_LOCATION = is the value determined in step 4 above.
  $SERVER = the previous WebSphere Application Server profile's server name identified in step 6.
  $SOURCE_DEFAULT_PROFILE_LOCATION = the previous WebSphere Application Server default profile location identified in step 3.
  $SOURCE_PROFILE = the previous WebSphere Application Server profile name identified in step 5b.
  
  Example:
  STRQSH
  cd /QIBM/ProdData/WebSphere/AppServer/V85/Express/bin
  ./WASPreUpgrade /tmp/jared70ex /QIBM/UserData/WebSphere/AppServer/V7/Express/profiles/jared70ex
  
  Example Output from the WASPreUpgrade command:
  
  IBM WebSphere Application Server, Release 8.5
  Product Upgrade PreUpgrade tool, Version 1.0
  Copyright IBM Corp., 1997-2010
  
  <----This messaging is normal and can be ignored---->
  MIGR0300I: The migration function is starting to save the existing Application Server environment.
  The file handle limit is set below the optimum limit of 10,000. If you do not change the file handle limit to 10,000 or above, th
  en the migration might fail.
  MIGR0302I: The existing files are being saved.
  <--------------------------------------------------------------------->
  
  MIGR0210I: The migration function is creating a directory destination directory - /tmp/jared70ex/websphere_backup/properties/fsdb
  .
  MIGR0211I: The migration function is copying a directory /tmp/jared70ex/websphere_backup/properties/fsdb.
  MIGR0210I: The migration function is creating a directory destination directory - /tmp/jared70ex/websphere_backup/properties/fsdb
  /_was_profile_default.
  MIGR0211I: The migration function is copying a directory /tmp/jared70ex/websphere_backup/properties/fsdb/_was_profile_default.
  MIGR0303I: The existing Application Server environment is saved.
  MIGR0420I: The first step of migration completed successfully.
  $
  
  Once the backup process has completed successfully, you can move onto the next step.

9) Restore the original WebSphere Application Server profile configuration to the new WebSphere Application Server v8.5.5 profile.

• The WASPostUpgrade command migrates the backup created by the WASPreUpgrade command to the new WebSphere
  Application Server V8.5.5 profile environment.
  Syntax for the WASPostUpgrade command:
  WASPostUpgrade backupDirectory
  [-profileName profile_name]
  [-oldProfile profile_name]
  [-backupConfig true | false]
  [-username username]
  [-password password]
  [-traceString trace_spec [-traceFile file_name]]
  [-portBlock port_starting_number]
  [-replacePorts true | false]
  [-includeApps true | false | script]
  [-scriptCompatibility true | false]
  [ [-appInstallDirectory user_specified_directory] |
  [-keepAppDirectory true | false]]
  [-keepDmgrEnabled true | false]
  
  Additional information on the WASPostUpgrade command and its usage can be obtained here.
  
  a) Execute the following commands to begin the migration of the profile data to the new WebSphere Application Server v8.5.5 profile.
  
  STRQSH
  cd $TARGET_INSTALL_LOCATION/bin
  ./WASPostUpgrade /tmp/$SERVER -profileName $SOURCE_PROFILE
  
  where
  $TARGET_INSTALL_LOCATION = is the value determined in step 4 above.
  $SERVER = the previous WebSphere Application Server profile's server name identified in step 6.
  $SOURCE_PROFILE = the previous WebSphere Application Server profile name identified in step 5b.
  
  Example:
  STRQSH
  cd /QIBM/ProdData/WebSphere/AppServer/V85/Express/bin
  ./WASPostUpgrade /tmp/jared70ex -profileName jared70ex
  
  Example output:
  IBM WebSphere Application Server, Release 8.5
  Product Upgrade PostUpgrade tool, Version 1.0
  Copyright IBM Corp., 1997-2010
  
  MIGR0304I: The previous WebSphere environment is being merged into this profile.
  The file handle limit is set below the optimum limit of 10,000. If you do not change the file handle limit to 10,000 or above, th
  en the migration might fail.
  MIGR0459I: Application Server configuration files are being migration.
  MIGR0367I: Backing up the current Application Server environment.
  .....
  <----Several messages will be logged here related to the migration of your application server environment.---->
  .....
  MIGR0307I: The restoration of the previous Application Server environment is complete.
  MIGR0271W: Migration completed successfully, with one or more warnings.
  $
  
  NOTE: If the WASPostUpgrade command fails with
  
     MIGR0515W: Cannot validate if the source hostname (old.host.name) has the same IP address as the target hostname
     (new.host.name). Hostname changes were made to one or more of the server's endpoints. You must validate these
     changes.
     java.lang.NullPointerException                            
     MIGR0286E: The migration failed to complete.
  
  Add the "old.host.name" to the Host Table Entry (CFGTCP option 10) of the IP address that already has the "new.host.name" and repeat this step again.

10) Once you receive the message "MIGR0271W: Migration completed successfully, with one or more warnings.", the migration of your WebSphere Application Server profile has completed successfully. Review the warning messages ending in a "W" for your awareness in case they need to be addressed.

11) You are now ready to start your new WebSphere Application Server​​​​​​​ v8.5.5 application server.

• NOTE: Since the source and target WebSphere Application Server profiles are configured to use the same ports, they cannot be started at the same time. If you don't want the target v8.5.5 profile to use the same ports, you will need to re-run the WASPostUpgrade command and include the "-replacePorts false" option on the command.
  
  STRQSH
  cd $TARGET_INSTALL_LOCATION/bin
  ./startServer -profileName $SOURCE_PROFILE
  
  where
  $TARGET_INSTALL_LOCATION = is the value determined in step 4 above.
  $SOURCE_PROFILE = the previous WebSphere Application Server profile name identified in step 5b.
  
  Example:
  STRQSH
  cd /QIBM/ProdData/WebSphere/AppServer/V85/Express/bin
  ./startServer -profileName jared70ex
  
  Once you have confirmed your application server starts successfully, the application server profile migration process is complete.

12) NOTE: If you had an IBM HTTP Server associated with your source WebSphere Application Server profile you migrated FROM, you will need to associate the IBM HTTP Server with the new WebSphere Application Server​​​​​​​ v8.5.5 profile you just migrated TO.

• a) Ensure the ADMIN server is started.
  STRTCPSVR *ADMIN
  
  b) Access the ADMIN Server using the following URL.
  http://<server>:2001/HTTPAdmin
  
  c) Log in with an IBM i user profile with *ALLOBJ and *IOSYSCFG special authorities.
  
  d) Click Manage -> HTTP Servers
  
  e) Select your IBM HTTP Server from the drop-down list.
  
  f) Click the "WebSphere Application Server" link just above the "Tools" section in the left, vertical menu bar.
  
  g) Select the radio button next to "Disable Servlets and JSPs (JavaServer Pages)" and click the "OK" button to remove the old association.
  
  h) Select the radio button next to the new WebSphere Application Server v8.5.5 installation.
  
  i) Select your new WebSphere Application Server v8.5.5 profile from the list.
  
  j) Specify "All applications" next to the "Indicate which installed applications should be mapped to the selected Web Server".
  
  k) Set the additional options as you require.
  
  l) Click the "OK" button to complete the new association process.
  
  m) Restart the HTTP Server and WebSphere Application Server instance for the changes to take affect.

13) Repeat steps 3-12 for additional WebSphere Application Server profile migrations.

14) You have now completed the WebSphere Application Server​​​​​​​ product and profile migration process and are ready to use your application environment.

OPTIONAL:

15) Uninstall/delete old WebSphere Application Server installations previous to WebSphere Application Server v8.5.5.

• NOTE: The steps below will completely uninstall/delete the WebSphere Application Server V6.0, v6.1, V7.0, or V8.0 WebSphere Application Server product versions from your IBM i server!! If you do not want to uninstall/delete these products, DO NOT PROCEED!!!
  
  WebSphere Application Server​​​​​​​ v6.0, v6.1, and v7.0
  a) Execute the following commands to clean up your old WebSphere Application Server installations.
  
  STRQSH
  rm -r /QIBM/ProdData/WebSphere/AppServer/<version>
  rm -r /QIBM/UserData/WebSphere/AppServer/<version>
  
  where <version> = V6,V61, or V7
  
  b) Execute the following command to display all libraries matching the pattern QWAS*.
  WRKOBJ OBJ(QWAS*) OBJTYPE(*LIB)
  Delete all of the libraries returned matching the QWAS* pattern, except the QWAS85* libraries.
  IMPORTANT!!!! - DO NOT delete the QWAS85* libraries as this will corrupt your IBM WebSphere Application Server v8.5.5 installation.
  
  c) The IBM WebSphere Application Server product is now completely deleted from your server.
  
  WebSphere Application Server​​​​​​​ v8.0
  Click the link below and proceed to follow the instructions provided to uninstall/delete your WebSphere Application Server v8.0 product installation.
  How To Uninstall IBM WebSphere Application Server v8.0 and Later and the Installation Manager Products on the IBM i OS