You can upgrade Sterling B2B Integrator in a non-cluster or cluster
environment with the IBM® Installation Manager in a graphical
user interface (GUI) mode.
Important: This procedure is applicable only if you are upgrading from v5.2.6.x and are
upgrading to the same directory as the previous version.
Consider the following points when you install
Sterling B2B Integrator in a cluster environment:
- You can install and upgrade through the user interface or silent installation mode (response
files). Console mode installation and upgrade is not supported.
- Sterling B2B Integrator JAR file is
included in the repository. Therefore it is not required to manually select the JAR file when
installing or upgrading.
- You must use correct version of the IIM to install or upgrade Sterling B2B Integrator. For more information, see
The IBM Installation Manager (IIM).
InstallService
is disabled, and cannot be used to install Sterling B2B Integrator.
-
If you are using the Windows operating system, close all open programs and all command prompt
windows.
-
Start the Installation Manager.
Table 1. Starting the IBM Installation Manager
Condition |
Action |
If you do not have the Installation Manager installed and are using the Installation Manager
agent provided with V6.0. |
Go to the IM_<operating_system> directory and run the following command.
- For Windows: userinst.exe
- For Unix/Linux: ./userinst
|
If you have a 64-bit Installation Manager installed. |
Go to the IM_<operating_system> directory and run the following command.
- For Windows: userinst.exe
- For Unix/Linux: ./userinst
|
If you have Installation Manager installed on a platform that has only one download available
for Installation Manager. For example, AIX, zLinux. |
Go to the IM_<operating_system> directory and run the following command.
- For Windows: userinst.exe
- For Unix/Linux: ./userinst
|
If you have 32-bit Installation Manager installed on a Linux or Windows system. |
- For Windows: Go to <installation directory>\Installation Manager\eclipse
and type IBMIM.exe.
- For Unix/Linux: Go to <installation directory>/Installation
Manager/eclipse and type ./IBMIM
|
-
If IM_<operating_system> and b2birepo directories
are not in the same directory or if you already have Installation Manager installed, then you must
add the Sterling B2B Integrator repository
files to the Installation Manager repository. For more information about adding repository files,
see Repository preferences.
- Optional:
It is suggested to record a response file. The response file can be used to install Sterling B2B Integrator after applying database
schema manually or install second and subsequent nodes in a cluster. For more information, see Installing or updating with a response file.
-
On the Installation Manager home page, click Update.
Note: If you get a message saying that there no packages to update or Installation Manager could not
connect to the repositories, go back to step 3 and add the Sterling B2B Integrator repository files to the
Installation Manager repository.
-
On the Update Packages screen, IBM Sterling B2B
Integrator is selected and the Installation Directory is
displayed. Click Next.
-
Select the updates that you want to install and click Next.
- Review the license agreement and select the option I accept the terms in the license agreement.
If you do not accept the agreement, the installation process does
not continue.
-
Select the required features to be installed.
The available options are:
- IBM Sterling B2B Integrator
- IBM Sterling File Gateway
- FIPS Module
- AS2 Edition Module
- Financial Services Module
- EBICS Banking Server Module
- B2B Advanced Communications Integration Module
Important:
- Sterling B2B Integrator is selected by default. Select only the licenses
and features that were defined by your IBM contract. If you are unsure which to select, the
installation can proceed without a selection and complete successfully. Startup and operation of the
software, however, requires one of the licenses to be selected. For more information, see License modifications..
- Features that are not part of your current Sterling B2B Integrator installation are disabled
and you cannot select them when upgrading or applying a fix pack. Similarly, you cannot deselect
features that are already part of your setup when you upgrade. To include features or exclude
features from your Sterling B2B Integrator
setup, you must first upgrade to the current version, and then install them separately. For more
information, see License modifications.
- If the fix pack or upgrade includes updates to features that are part of your current Sterling B2B Integrator installation, the features
are upgraded regardless of whether you select the them or not.
- If your current installation includes Sterling File Gateway, then Sterling File Gateway is also updated when you
upgrade Sterling B2B Integrator.
- If Sterling File Gateway was not
installed, it is not installed when upgrading Sterling B2B Integrator, even if you select the Sterling File Gateway option. In this case, to
install Sterling File Gateway when upgrading,
you must do one of the following tasks:
- When upgrading Sterling B2B Integrator, if
you are installing Sterling B2B Integrator to a
fresh directory, and pointing to the previous database, then you can install Sterling File Gateway.
- Install Sterling File Gateway after you
install Sterling B2B Integrator by following
the instructions in License modifications.
- When upgrading Sterling B2B Integrator,
select B2B Advanced Communications Integration Module to upgrade Sterling B2B Integrator bridge. Sterling B2B Integrator bridge is required for
communication between Sterling B2B Integrator
and B2B Advanced Communications. If you
are installing Global Mailbox and Sterling B2B Integrator, then B2B
Advanced Communications Integration Module (Sterling B2B Integrator bridge) is installed by
default, because Global Mailbox uses the
storage module of B2B Advanced Communications. However, you
must configure the adapter containers and adapters for Sterling B2B Integrator bridge after
upgrading.
- Type the path to your JDK directory and click Next.
- Type the path to the JCE policy file and click Next.
- Enter the system passphrase information and click Next:
- Type a passphrase.
- Confirm the passphrase.
-
Review the Upgrade package summary information. Click Update to
upgrade.
The Installation Progress screen indicates which component of the installation is in process.
A status bar below the Repository Information heading displays the
progress of the component installation. When the installation completes, a large green circle with a
check mark displays with the message The packages are installed. A link is provided
to view the installation log file.
-
After upgrade is completed, click Finish.
The Installation Manager closes and you are returned to your desktop.
Check the
InstallSI.log file to verify that all of the components were installed
properly.
-
If you are installing on Windows 2008, see Configure the Sterling B2B Integrator Desktop Icon for Windows Server 2008.
-
If you are using the AIX® operating system and are using
IPv6:
- Open the /<install_dir>/install/properties directory.
- Add the following value to the sandbox.config file:
IPV4STACK=false
- Open the /<install_dir>/install/bin directory.
- Enter the ./setupfiles.sh command.
-
In a clustered environment, to install each additional node, open the Installation Manager
folder and start a new upgrade.
Note: For node 2 and higher, follow the same steps as you did for node 1 until you get to the step
with the This installation is for a cluster node 2 or higher check box.
Select that box.
-
In a clustered environment, if you have installed multiple nodes on the same server or used
different base ports for node 2 onward, you must complete the following steps:
Note: When you upgrade Sterling B2B Integrator
to the same directory as the previous installation, the cluster configuration is maintained after
the upgrade is completed.
Step |
Action |
1 |
Open the following directory for node 1:
- For Windows: \<install_dir>\properties
- For Unix/Linux: /<install_dir>/properties
|
2 |
In the noapp.properies_platform_ifcresources_ext file,
record the value for multicastBasePort. |
3 |
In thejgroup_cluster.properties file, record the values
for the mcast_port parameters of the property_string and
lock.protocolStack properties. |
4 |
For each subsequent node, complete the remaining steps. |
5 |
Open the following directory for each node (node 2 and higher):
- For Windows: \<install_dir>\properties
- For Unix/Linux: /<install_dir>/properties
|
6 |
In the noapp.properies_platform_ifcresources_ext.in file,
update the value of the multicastBasePort property to match the value for node
1. For example, replace the string &MULTICAST_NODE_PORT1 with the port number
45460
- (before)
multicastBasePort=&MULTICAST_NODE_PORT1;
- (after)
multicastBasePort=45460;
|
7 |
In the jgroups_cluster.properties.in file, update all
occurrences of mcast_port to match the values for node 1. |
8 |
After you updated the attributes for all of the nodes, enter the following
command for node 2 and higher:
- For Windows:
\<install_dir>\bin\setupfiles.cmd
- For Unix/Linux:
/<install_dir>/bin/setupfiles.sh
|
In case of a 525 upgrade to 6.0, where SFG is pre-installed in 525, the license flag for SFG -
license.accept.enable.sfg - will have to be set to true post upgrade
-
If you have upgraded from Sterling B2B Integrator v5.2.5 and Sterling File Gateway was part of your previous
setup, set the
license.accept.enable.sfg
to true in the
customer_overrides.properties file.
-
Determine whether you need to apply a fix pack or interim fix to the installation.