Start of change

Software requirements

The software required by IBM® i Migrate While Active when using assisted save and restore is detailed in this section.

IBM i options and products

The following software products and options are used by the migration process. They must be installed before migration begins.

Attention: The source node needs a 5770DBM Option 2 license. The GUI node and target node 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 22 Object Connect Required
5770SS1 Option 26 Db2® Symmetric Multiprocessing Required
5770SS1 Option 30 Qshell Required
5770SS1 Option 33 Portable Application Solutions Environment (PASE) Required
5770SS1 Option 41 High Availability Switchable Resources Required
5770SS1 Option 48 Db2 Data Mirroring 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 Start of changeRequiredEnd of change
5770JV1 *BASE IBM Developer Kit for Java™ Required
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.
5733SC1 *BASE IBM Portable Utilities for i Required
5733SC1 Option 1 OpenSSH, OpenSSL, zlib Required
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
Table 3. Target 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
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/or update the ibmi-repos package.
Table 4. 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
rsync -
Start of change
Table 5. NFS server open source packages
Package Minimum Version Required
rsync -
End of change

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 6. Source node PTF groups
PTF Group Name PTF Group Number Minimum Level Required Recommended Level
IBM i Cumulative PTF package SF99760 - Latest
Db2 Mirror PTF Group SF99961 Start of change2End of change Latest
Db2 for IBM i PTF Group SF99960 1 Latest
Table 7. GUI node PTF groups
PTF Group Name PTF Group Number Minimum Level Required Recommended Level
Db2 Mirror PTF Group SF99961 Start of change2End of change Latest
IBM HTTP Server for i PTF Group SF99962 - Latest
Java PTF Group SF99965 - 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 and Db2 for IBM i PTF group typically ship new levels 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, visit 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.

Start of change

Target node PTFs

The following individual PTFs must be installed on the target node before beginning the migration process.
Table 8. Required target node PTFs
Product PTF Number
5770SS1 SJ07609
End of change
End of change