Start of change

Software requirements

Edit online

The software required by IBM® i Migrate While Active when using partition mirroring is detailed in this section.

IBM i options and products

Install the following software products and options before using partition mirroring.

Attention: Only the source node requires a 5770DBM Option 2 license; the GUI and copy nodes do not.
Table 1. Source node products and options
Product and Option Description Notes
5770SS1 Option 1 Extended Base Support Required
5770SS1 Option 3 Extended Base Directory Support Required
5770SS1 Option 12 Host Servers Required
5770SS1 Option 30 Qshell Required
5770SS1 Option 33 Portable Application Solutions Environment (PASE) Required
5770DBM *BASE IBM Db2® Mirror for i Required
5770DBM Option 2 IBM i Migrate While Active Required. May appear as Reserved - Option 2 or Migration Feature in some interfaces.
5770DG1 *BASE IBM HTTP Server for i Optional. Required to run the Db2 Mirror GUI on the source node.
5770JV1 *BASE IBM Developer Kit for Java™ Optional. Required to run the Db2 Mirror GUI on the source node.
5770JV1 Option 16, 17, 19, or 20 Java SE 8, 11, or 17 Optional. Any supported version of Java must be installed to run the Db2 Mirror GUI on the source node.
5770TC1 *BASE IBM TCP/IP Connectivity for i Required
Table 2. GUI node products and options
Product and Option Description Notes
5770SS1 Option 1 Extended Base Support Required
5770SS1 Option 3 Extended Base Directory Support Required
5770SS1 Option 12 Host Servers Required
5770SS1 Option 30 Qshell Required
5770SS1 Option 33 Portable Application Solutions Environment (PASE) Required
5770DBM *BASE IBM Db2 Mirror for i Required
5770DG1 *BASE IBM HTTP Server for i Required
5770JV1 *BASE IBM Developer Kit for Java Required
5770JV1 Option 16, 17, 19, or 20 Java SE 8, 11, or 17 Any supported version of Java must be installed to run the Db2 Mirror GUI.
5770TC1 *BASE IBM TCP/IP Connectivity for i Required

Open-source packages

Install the following packages on the source node. Instructions for installing the open source environment for IBM i can be found here: https://ibmi-oss-docs.readthedocs.io/en/latest/yum/README.html.
Tip: If you are having trouble finding the package version listed below, first install and update the ibmi-repos package.
Table 3. Source node open source packages
Package Minimum Version Required
cloud-init 1.5.1
python39 3.9.10
python39-ibm_db 2.0.5.12

PTF groups

Before beginning the migration process, it is best to prepare your environment by installing the latest level of PTF groups. The latest level of PTF groups can be found here: IBM i Group PTFs with latest level.

Table 4. Source node PTF groups
PTF Group Name PTF Group Number Minimum Level Required Recommended Level
IBM i Cumulative PTF package SF99750 - Latest
Db2 Mirror PTF Group SF99951 10 Latest
Table 5. GUI node PTF groups
PTF Group Name PTF Group Number Minimum Level Required Recommended Level
Db2 Mirror PTF Group SF99951 10 Latest
IBM HTTP Server for i PTF Group SF99952 - Latest
Java PTF Group SF99955 - Latest

To understand whether the latest level of these PTF groups are applied, use the following query: 

WITH ILEVEL (IVERSION, IRELEASE) AS (
    SELECT OS_VERSION, OS_RELEASE
      FROM SYSIBMADM.ENV_SYS_INFO
  )
  SELECT P.*
    FROM ILEVEL, SYSTOOLS.GROUP_PTF_CURRENCY P
    WHERE PTF_GROUP_RELEASE = 'R' CONCAT IVERSION CONCAT IRELEASE CONCAT '0'
    ORDER BY PTF_GROUP_LEVEL_AVAILABLE - PTF_GROUP_LEVEL_INSTALLED DESC;

Individual PTFs

The Db2 Mirror PTF group is typically refreshed several times a year. As noted earlier, the best practice for Migrate While Active users is to have the most recently released PTF group levels installed on the source node before using Migrate While Active. Prior to the next PTF group levels being released, see the following web page for a list of the latest individual PTFs that have not yet been included in a PTF group: IBM i Migrate While Active - PTF Information.

Copy node software requirements

The source and copy node must be installed with matching levels of Licensed Internal Code (LIC) before beginning the migration process. For complete details about the software requirements for the copy node, see the following web page: IBM i Migrate While Active - Copy node software and storage requirements for partition mirroring.

End of change