WebSphere Enterprise Service Bus, Version 6.2.0 Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


WBIProfileUpgrade script

Use the WBIProfileUpgrade script to update application and configuration settings in a WebSphere® ESB profile when you are migrating clusters and in some other special situations.

Purpose

WBIProfileUpgrade is an Apache™ Ant script that updates support applications supplied with WebSphere ESB and configuration settings in a WebSphere ESB profile. It is normally invoked automatically by the migration wizard or the WBIPostUpgrade command. However, when you migrate a cluster you will need to invoke WBIProfileUpgrade manually after the migration wizard or the WBIPostUpgrade command has been run on the cluster members. In addition, you might need to invoke WBIProfileUpgrade when manually migrating internal support applications or in some situations in which an error has occurred during migration.

Syntax

The syntax is as follows:

For i5/OS operating system
profile_root/bin/ws_ant -f install_root/util/WBIProfileUpgrade.ant 
    -DmigrationDir=backupDirectory [-Dcluster=clustername ]
For Linux operating systemFor UNIX operating system
profile_root/bin/ws_ant.sh -f install_root/util/WBIProfileUpgrade.ant 
    -DmigrationDir=backupDirectory [-Dcluster=clustername ]
For Windows operating system
profile_root\bin\ws_ant.bat -f install_root\util\WBIProfileUpgrade.ant
    -DmigrationDir=backupDirectory [-Dcluster=clusterName ]

Parameters

profile_root
The directory in which the profile being migrated resides. The ws_ant command resides in the bin subdirectory of this profile directory.
install_root
The directory in which WebSphere ESB is installed.
backupDirectory
This is a required parameter. The backupDirectory specifies the name of the directory in which the migration-specific backup directory created by the WBIPreUpgrade command resides.

Enter the directory path for the folder to be used as backup directory for the deployment manager profile.

clusterName
This specifies the name of the cluster that needs to be migrated.

Logging

The WBIProfileUpgrade script creates a log when it runs that is written to the backupDirectory/logs/WBIProfileUpgrade.ant-profilename.time_stamp.log file, where backupDirectory is the value specified for the backupDirectory parameter. You can view the WBIProfileUpgrade.ant-profilename.time_stamp.log file with a text editor

Examples

Note: The following examples are each single command lines but are shown on multiple lines for readability purposes only.
For i5/OS operating system
/QIBM/UserData/WebSphere/ProcServer/profiles/Dmgr/bin>ws_ant 
-f /QIBM/ProdData/WebSphere/ProcServer/util/WBIProfileUpgrade.ant 
-DmigrationDir=/tmp/migrationBackup -Dcluster=clusterA 
For Linux operating systemFor UNIX operating system
/opt/IBM/Server1/profiles/DMgr/bin>ws_ant.sh –f 
../../../util/WBIProfileUpgrade.ant –DmigrationDir=/tmp/migrationBackup 
-Dcluster=clusterA
For Windows operating system
C:\IBM\Server1\profiles\DMgr\bin>ws_ant.bat –f
..\..\..\util\WBIProfileUpgrade.ant –DmigrationDir=c:\\temp\migrationBackup
-Dcluster=clusterA

reference Reference topic

Terms of use | Feedback


Timestamp icon Last updated: 21 June 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/rmig_vtv_wbiprofile_ant.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
This information center is powered by Eclipse technology (http://www.eclipse.org).