IBM Support

IBM WebSphere Application Server v8.5.5 Product Migration Steps

Question & Answer


Question

How do I migrate the IBM WebSphere Application Server product and profiles to v8.5.5 when migrating WAS versions?

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 WAS 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 WAS 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 standalone 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/support/knowledgecenter/SSAW57_8.5.5/com.ibm.websphere.migration.nd.iseries.doc/ae/tmig_is_to70nd.html.

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

Some of the information in the following steps was taken from the IBM WAS v8.5.5 Knowledge Center.

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


  • Information on how to download the various WAS v8.5.5 editions for the IBM i OS can be found here:

    Express edition:
    Download Web Enablement for IBM i
    NOTE: Once the zipped 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 prior to 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 prior to installation.


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


3) Identify the Default Profile Location for the WAS installation you are migrating FROM.


  • a) Execute the following commands to display the default profile location for the WAS installation you are migrating FROM.

    STRQSH
    /QIBM/WAS/bin/queryWASinstalls

    b) The queryWASinstalls command will display all of the currently installed WAS versions and editions on your IBM i server. Identify the WAS 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 WAS installation you are migrating TO.


  • a) Execute the following commands to display the installation location for the WAS installation you are migrating TO.

    STRQSH
    /QIBM/WAS/bin/queryWASinstalls

    b) The queryWASinstalls command will display all of the currently installed WAS versions and editions on your IBM i server. Identify the WAS version and edition you are migrating TO. This will be your WAS 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 WAS profiles you wish to migrate.


  • a) Execute the following CL command to display the profiles for your source WAS 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 WAS installation.



    b) Pick the WAS profile name you wish to migrate.
    I will refer to this profile name as $SOURCE_PROFILE.

    Example: $SOURCE_PROFILE = jared70ex


6) Identify the source WAS profile's node and server names.


  • a) Execute the following commands to identify the source WAS 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 WAS v8.5.5 profile using the same profile, node, and server names as the previous WAS profile.


  • a) Execute the following commands to create a new profile using the same profile, node, and server names as the WAS profile you are migrating FROM.

    NOTE: The WAS 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 WAS profile name identified in step 5b.
    $SERVER = the previous WAS profile's server name identified in step 6.
    $NODE = the previous WAS profile's node name identified in step 6.
    <port> = any port you wish 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 WAS profile using the WASPreUpgrade command.

  • The WASPreUpgrade command creates a backup of the source WAS profile's pertinent configuration information. The contents of the backup are specific to the source WAS 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 WAS profile data.

    MKDIR '/tmp/$SERVER'
    where $SERVER is the value determined in step 6.

    b) Execute the WASPreUpgrade command to back up the source WAS 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 WAS profile's server name identified in step 6.
    $SOURCE_DEFAULT_PROFILE_LOCATION = the previous WAS default profile location identified in step 3.
    $SOURCE_PROFILE = the previous WAS 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 WAS profile configuration to the new WAS 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 WAS 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 WAS profile's server name identified in step 6.
    $SOURCE_PROFILE = the previous WAS 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 WAS 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 WAS v8.5.5 application server.


  • NOTE: Since the source and target WAS 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 WAS 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 WAS profile you migrated FROM, you will need to associate the IBM HTTP Server with the new WASv8.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 on Manage -> HTTP Servers

    e) Select your IBM HTTP Server from the drop-down list.

    f) Click on the "WebSphere Application Server" link just above the "Tools" section in the left-hand, vertical menu bar.

    g) Select the radio button next to "Disable Servlets and JSPs (Java Server Pages)" and click the "OK" button to remove the old association.

    h) Select the radio button next to the new WAS v8.5.5 installation.

    i) Select your new WAS 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 for the changes to take affect.


13) Repeat steps 3-12 for additional WAS profile migrations.

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

OPTIONAL:

15) Uninstall/delete old WAS installations previous to WAS v8.5.5.


  • NOTE: The steps below will completely uninstall/delete the WAS V6.0, v6.1, V7.0, and/or V8.0 WebSphere Application Server product versions from your IBM i server!! If you do not wish to uninstall/delete these products, DO NOT PROCEED!!!

    WAS v6.0, v6.1, and v7.0
    a) Execute the following commands to clean up your old WAS 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 WAS v8.5.5 installation.

    c) The IBM WAS product is now completely deleted from your server.

    WAS v8.0
    Click on the link below and proceed to follow the instructions provided to uninstall/delete your WAS 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

[{"Line of Business":{"code":"LOB08","label":"Cognitive Systems"},"Business Unit":{"code":"BU054","label":"Systems w/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000CJGAA2","label":"WebSphere Application Server->Migration"}],"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Version(s)"}]

Document Information

Modified date:
04 March 2021

UID

nas8N1020832