Technical Blog Post
Abstract
Step by step guideline how to upgrade from ISBI 5.2.4.1 to ISBI 5.2.6.2 on RHEL 5 using update.sh script
Body
To install or upgrade to ISBI 5.2.6.x you have to use the IBM Installation Manager (IIM) that is provided with the download media.
There is a script provided to ease the upgrade process on Linux including automatic installation of IIM (see step 7.).
Please check also this blog entry: "Things to take into account when planning the upgrade from ISBI 5.2.4.1 to ISBI 5.2.6.2 on RHEL 5" (/support/pages/node/1121439).
Please note space requirements during installation:
- up to 12GB free temp file space for extraction in <tmp>
- up to 350MB free file space in user home dir for installation manager install in ~/IBM/InstallationManager
- up to 15GB free file space in <existing-isbi-install>
In addition to the changes in <existing-isbi-install>, IIM will per default install files to following targets:
- IIM bin: ~/IBM/InstallationManager
- IIM reg: ~/etc/.ibm/registry/InstallationManager.dat
- IIM shared: /opt/IBM/IBMIMShared
- IIM data: ~/var/IBM/InstallationManager
Please act exactly on the following steps to upgrade from ISBI 5.2.4.1 to ISBI 5.2.6.2 on RHEL 5 using update.sh script:
1a. download ISBI 5.2.6.2 from IBM Fix Central (http://www.ibm.com/support/fixcentral/swg/quickorder?product=ibm/Other+software/Sterling+B2B+Integrator&release=5.2.4.1&platform=Linux&function=fixId&fixids=5.2.6.2-OtherSoftware-B2Bi-All&includeRequisites=1&includeSupersedes=0&downloadMethod=http&source=fc):
- Media_IM_5020602.zip -> <downloaded>/Media_IM_5020602.zip
- SDK_5020602.zip -> <downloaded>/SDK_5020602.zip
1b. download current unrestricted SDK JCE policy files if needed from IBM JCE website https://www-01.ibm.com/marketing/iwm/iwm/web/preLogin.do?source=jcesdk (choose "Files for [...], Java 7 SR4, and all later releases") -> <downloaded>/unrestrictedpolicyfiles.zip
2. extract the following files to a temporary location accessible from the target ISBI system
- <downloaded>/Media_IM_5020602.zip -> <tmp>/Media_IM_5020602
- <downloaded>/SDK_5020602.zip -> <tmp>/SDK_5020602
3. stop all ISBI nodes and perform a full backup of the ISBI database as well as a full backup of the ISBI installation directory, including all sub-directories
4. upgrade operating system to supported RHEL 6 or RHEL 7 (see http://www-969.ibm.com/software/reports/compatibility/clarity-reports/report/html/softwareReqsForProduct?deliverableId=3F8014F0EC0F11E38B73BF6573FF9933&osPlatforms=Linux&duComponentIds=S001|S007|S008&mandatoryCapIds=9|13|25|26)
5. verify (change) in <existing-isbi-install>/properties/sandbox.cfg:
- JCE_DIST_FILE points to <downloaded>/unrestrictedpolicyfiles.zip
- all paramter values that are files or paths are pointing to an existing file or path (if needed LICENSE_FILE_* can be changed to point to the files in <existing-isbi-install>/properties/licensefiles)
6. upgrade JDK for ISBI
- extract <tmp>/SDK_5020602/ibm-java-sdk-7.0-9.30-linux-x86_64.tgz -> <tmp>/SDK_5020602/ibm-java-x86_64-70 (ensure that this dir directly contains a number of subfolders like bin, jre, lib, ...)
- switch to <ISBI-install-dir>/bin, and
- call (as <isbi-user>): ./upgradeJDK.sh <tmp>/SDK_5020602/ibm-java-x86_64-70
7. upgrade ISBI using update.sh (you can choose any <ProfileName> unique on the same machine; this is used for next update to allow IIM to identify this ISBI installation)
- open command prompt on <tmp>/Media_IM_5020602/UpdateScript
- call (as <isbi-user>, ensure write permissions to <tmp>/Media_IM_5020602 and its subfolders): ./update.sh <existing-isbi-install> <ProfileName> -acceptLicenses
(Usage: $0 full_path_to_b2bi b2bi_offering_profile_name LICENSE_INPUT [system_passphrase])
8. check <existing-isbi-install>/logs/InstallService.log for exceptions or errors
9. start ISBI
UID
ibm11121433