Upgrading v5.2.6.x to the same directory with IIM in GUI mode

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.

Before you begin

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.
  • Complete the Prerequisites for upgrading Sterling B2B Integrator.
  • Complete the Upgrade checklist.
  • Ensure that you have the correct version of JDK. For more information, see Java Requirements and Upgrading your JDK.
  • If your current setup has adapter containers, you must install IBM MQ before you upgrade. You must also configure the Properties for messaging queues.
  • If you are using the Standards Processing Engine (SPE) application with Sterling B2B Integrator, you must install SPE before you install Sterling B2B Integrator.
  • If you are using the EBICS Banking Server application with Sterling B2B Integrator, the data encryption for storage within the installation location is not supported.
  • If you are upgrading to Sterling B2B Integrator from a previous version, you must manually install the EBICS client. For more information about installing the EBICS Client manually, see the EBICS Client User Guide.
  • Note: The clustered environment does not support AS2 Edition.

About this task

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.

Procedure

  1. If you are using the Windows operating system, close all open programs and all command prompt windows.
  2. 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 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 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
  3. 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.
  4. 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.
  5. 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.
  6. On the Update Packages screen, IBM Sterling B2B Integrator is selected and the Installation Directory is displayed. Click Next.
  7. Select the updates that you want to install and click Next.
  8. 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.

  9. 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.
  10. Type the path to your JDK directory and click Next.
  11. Type the path to the JCE policy file and click Next.
  12. Enter the system passphrase information and click Next:
    1. Type a passphrase.
    2. Confirm the passphrase.
  13. 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.

  14. 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.

  15. If you are installing on Windows 2008, see Configure the Sterling B2B Integrator Desktop Icon for Windows Server 2008.
  16. If you are using the AIX® operating system and are using IPv6:
    1. Open the /<install_dir>/install/properties directory.
    2. Add the following value to the sandbox.config file: IPV4STACK=false
    3. Open the /<install_dir>/install/bin directory.
    4. Enter the ./setupfiles.sh command.
  17. 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.
  18. 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

  19. 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.
  20. Determine whether you need to apply a Fix Pack to the installation.