This article is about configuration migration, such as migrating deployment managers and federated nodes in a network deployment environment. The Application Migration Toolkit for WebSphere Application Server provides support for migrating applications from previous versions of WebSphere Application Server to the latest product version. For information about migrating applications, read more about the Application Migration Toolkit.
sptcfgReview the migration planning information. See Knowledge Collection: Migration planning for WebSphere® Application Server.
This information describes migrating cells to a different machine. For information on migrating cells on the same machine, see Migrating cells using the command line tools.
This task describes how to migrate each profile in a cell configuration from a previous version of WebSphere Application Server to WebSphere Application Server Version 8.5 hosted on a different machine. The cell configuration consists of a deployment manager with one or more nodes, a web server, and an application client. All ports are migrated forward into the new configuration. The source and target host machines do not need to run the same operating system.
If WebSphere Application Server Version 8.5 is not installed on the source host machine, you must generate a remote migration .jar file on the target host machine that matches the operating system of the source machine. The remote migration .jar file provides the source host with the Version 8.5 WASPreUpgrade tool, which you use to create the migration backup directory for the profile.
This procedure assumes that the previous configuration is running and that you are migrating all profiles to a different host machine.
previous_version_app_server_root\v70dmgr01\bin\
backupConfig.bat \mybackup_old_host\v70dmgr01backupBeforeV85migration.zip
-username myuser -password mypass -nostop
previous_version_app_server_root/v70dmgr01/bin/backupConfig.sh
/mybackup_old_host/v70dmgr01backupBeforeV85migration.zip -username
myuser -password mypass -nostop
/QIBM/UserData/WebSphere/AppServer/V70/ND/profiles/v70dmgr01/bin/backupConfig /
mybackup_old_host/v70dmgr01backupBeforeV85migration.zip -username
myuser -password mypass -nostop
previous_version_app_server_root\v70node01\bin\backupConfig.bat
\mybackup_old_host\v70node01backupBeforeV85migration.zip -username
myuser -password mypass -nostop
previous_version_app_server_root/v70node01
/bin/backupConfig.sh /mybackup_old_host/v70node01rbackupBeforeV85migration.zip
-username myuser -password mypass -nostop
/QIBM/UserData/WebSphere/AppServer/V70/ND/profiles/v70node01
/bin/backupConfig /mybackup_old_host/v70node01rbackupBeforeV85migration.zip
-username myuser -password mypass -nostop
version_8.5_install_root\bin\manageprofiles.bat -create
-profileName v70tov85dmgr01 -templatePath \opt\WebSphereV85\profileTemplates\
management -serverType DEPLOYMENT_MANAGER -nodeName currentDmgrNodeName
-cellName currentCellName -hostName mydmgrhost.company.com
version_8.5_install_root/bin/manageprofiles.sh -create
-profileName v70tov85dmgr01 -templatePath /opt/WebSphereV85/profileTemplates/
management -serverType DEPLOYMENT_MANAGER -nodeName currentDmgrNodeName
-cellName currentCellName -hostName mydmgrhost.company.com
/QIBM/ProdData/WebSphere/AppServer/V85/ND/bin/manageprofiles.sh -create
-profileName currentDmgrProfileName -templatePath /QIBM/ProdData/
WebSphere/AppServer/V85/ND/profileTemplates/management -serverType DEPLOYMENT_MANAGER
-nodeName currentDmgrNodeName -cellName currentCellName
-hostName mydmgrhost.company.com
<path to remote migration jar>\migration\bin\WASPreUpgrade.bat \mybackup_old_host\v70tov85dmgr01
\opt\WebSphereV70 -oldProfile 70dmgr01 -machineChange true
<path to remote migration jar>/migration/bin/WASPreUpgrade.sh /mybackup_old_host/v70tov85dmgr01
/opt/WebSphereV70 -oldProfile 70dmgr01 -machineChange true
/QIBM/ProdData/WebSphere/AppServer/V85/ND/bin/WASPreUpgrade /mybackup_old_host
/v70tov85dmgr01 /QIBM/UserData/WebSphere/AppServer/V85/ND/profiles/
myCurrentDmgrProfile -machineChange true
If you are migrating from Version 8.0 to Version 8.5 and your profile is a deployment manager, Version 8.0 profile is stopped when WASPreUpgrade runs. The deployment manager is only started before WASPreUpgrade completes if you provide -keepDmgrEnabled true on the command line or specify the corresponding option in the Migration wizard.
If there are errors, fix the errors and run the WASPreUpgrade command again. Check whether the warnings affect any other migration or runtime activities on Version 8.5.
If the command completed successfully, it is not necessary to check the logs for errors or warnings.
cd /mybackup_old_host
/opt/WebSphereV70/java/bin/jar -cf v70tov85dmgr01.jar v70tov85dmgr01/
mkdir /mybackup_new_host
cd /mybackup_new_host
/opt/WebSphereV85/java/bin/jar -xf v70tov85dmgr01.jar
where mybackup_new_host is the directory
to which you are migrating your files.version_8.5_install_root\bin\WASPostUpgrade.bat \
mybackup_new_host\v70tov85dmgr01 -profileName v70tov85dmgr01 -oldProfile
70dmgr01 -replacePorts TRUE -backupConfig TRUE -scriptCompatibility TRUE
-keepDmgrEnabled TRUE -username myuser -password mypass
version_8.5_install_root/bin/WASPostUpgrade.sh /
mybackup_new_host/v70tov85dmgr01 -profileName v70tov85dmgr01 -oldProfile
70dmgr01 -replacePorts TRUE -backupConfig TRUE -scriptCompatibility TRUE
-keepDmgrEnabled TRUE -username myuser -password mypass
/QIBM/ProdData/WebSphere/AppServer/V85/ND/bin/WASPostUpgrade /mybackup_new_host
/v70tov85dmgr01 -profileName myCurrentDmgrProfile -oldProfile myCurrentDmgrProfile
-replacePorts TRUE -backupConfig TRUE -scriptCompatibility TRUE
-username myuser -password mypass
If there are errors, fix the errors and run the WASPostUpgrade command again. Check whether the warnings affect any other migration or runtime activities on Version 8.5.
If the command completed successfully, it is not necessary to check the logs for errors or warnings.
version_8.5_profile_root\profiles\v70tov85dmgr01\
bin\backupConfig.bat \mybackup_new_host\v70tov85dmgr01backupMigratedDmgrOnly.zip
-username myuser -password mypass
version_8.5_profile_root/profiles/v70tov85dmgr01/bin/backupConfig.sh /
mybackup_new_host/v70tov85dmgr01backupMigratedDmgrOnly.zip -username
myuser -password mypass
/QIBM/UserData/WebSphere/AppServer/V85/ND/profiles/myCurrentDmgrProfile/bin/backupConfig.sh
/mybackup_new_host/v70tov85dmgr01backupMigratedDmgrOnly.zip -username
myuser -password mypass
For more information, see clientUpgrade command
.node_agent_install_root\bin\syncNode.bat myV85DmgrHost.mycompany.com 8879 -username myuser -password mypass
node_agent_install_root/bin/syncNode.sh myV85DmgrHost.mycompany.com 8879 -username myuser -password mypass
/QIBM/UserData/WebSphere/V5/bin/syncNode.sh myV85DmgrHost.mycompany.com 8879 -username myuser -password mypass
/opt/AppClientV85/bin/WASPreUpgrade.sh /mybackup_client/v70clientTov85 /opt/AppClientV70
/opt/AppClientV85/bin/WASPostUpgrade.sh /mybackup_client/v6clientToV85
version_8.5_install_root\bin\manageprofiles.bat
-create -profileName node1 -templatePath \opt\
WebSphereV85\profileTemplates\managed -nodeName currentNode1Name
-cellName currentCellName -hostName mynode1host.company.com
version_8.5_install_root/bin/manageprofiles.sh
-create -profileName node1 -templatePath
/opt/WebSphereV85/profileTemplates/managed -nodeName currentNode1Name
-cellName currentCellName -hostName mynode1host.company.com
/QIBM/ProdData/WebSphere/AppServer/V85/ND/bin/manageprofiles -create
-profileName currentNode1Name -templatePath /QIBM/ProdData
/WebSphere/AppServer/V85/ND/profileTemplates/managed -nodeName
currentNode1Name -cellName currentCellName -hostName mynode1host.company.com
<path to remote migration jar>\migration\bin\WASPreUpgrade.bat \mybackup_old_host\v70tov85node1
\opt\WebSphereV70 -oldProfile 70node1 -machineChange true
<path to remote migration jar>/migration/bin/WASPreUpgrade.sh /mybackup_old_host/v70tov85node1
/opt/WebSphereV70 -oldProfile 70node1 -machineChange true
/QIBM/ProdData/WebSphere/AppServer/V85/ND/bin/WASPreUpgrade /mybackup_old_host/
v70tov85node1 /QIBM/UserData/WebSphere/AppServer/V70/ND/profiles/
currentNode1Name -machineChange true
If the WASPreUpgrade command is successful, you do not need to check the log files for error or warning messages.
cd /mybackup_old_host
/opt/WebSphereV70/java/bin/jar -cf v70tov85node1.jar v70tov85node1/
/QIBM/ProdData/WebSphere/AppServer/V85/ND/bin/WASPreUpgrade /mybackup_old_host
/v70tov85node1 /QIBM/UserData/WebSphere/AppServer/V70/ND/profiles/currentNode1Name
mkdir /mybackup_new_host
cd /mybackup_new_host
/opt/WebSphereV85/java/bin/jar -xf v70tov85dmgr01.jar
where mybackup_new_host is the directory
from which the profile configuration files are migrated.version_8.5_install_root\bin\WASPostUpgrade.bat \
mybackup_new_host\v70tov85node1 -profileName v70tov85node1
-oldProfile 70node1 -replacePorts TRUE
-backupConfig TRUE -includeApps TRUE -scriptCompatibility
TRUE -username myuser -password mypass
version_8.5_install_root/bin/WASPostUpgrade.sh /
mybackup_new_host/v70tov85node1 -profileName v70tov85node1
-oldProfile 70node1 -replacePorts TRUE -backupConfig
TRUE -includeApps TRUE -scriptCompatibility TRUE
-username myuser -password mypass
/QIBM/ProdData/WebSphere/AppServer/V85/ND/bin/WASPostUpgrade /mybackup_new_host
/v70tov85node1 -profileName currentNode1Name -replacePorts TRUE
-backupConfig TRUE -includeApps TRUE -scriptCompatibility
TRUE -keepDmgrEnabled FALSE -username
myuser -password mypass
version_8.5_profile_root\v70tov85node1\bin\backupConfig.bat
\mybackup_new_host\v70tov85node1.zip -username myuser
-password mypass -nostop
version_8.5_profile_root/v70tov85node1/bin/backupConfig.sh
/mybackup_new_host/v70tov85node1.zip -username myuser
-password mypass -nostop
/QIBM/UserData/WebSphere/AppServer/V85/profiles/v70tov85node1/bin/backupConfig
/mybackup_new_host/v70tov85node1.zip -username myuser
-password mypass -nostop
version_8.5_profile_root\v70tov85dmgr01\bin\backupConfig.bat
\mybackup_new_host\v70tov85dmgr01backupMigratedDmgrPlusNodeX.zip
-username myuser -password mypass
version_8.5_profile_root/v70tov85dmgr01/bin/backupConfig.sh
/mybackup_new_host/v70tov85dmgr01backupMigratedDmgrPlusNodeX.zip
-username myuser -password mypass
/QIBM/UserData/WebSphere/AppServer/V85/profiles/currentDmgrName/bin/backupConfig.sh
/mybackup_new_host/v70tov85dmgr01backupMigratedDmgrPlusNodeX.zip
-username myuser -password mypass
You used the migration tools to migrate the cell configurations from a previous version of WebSphere Application Server to new host machines that run WebSphere Application Server Version 8.5.