Start of change

Software requirements

Edit online

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

IBM i options and products

Install the following software products and options before using storage migration.

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 34 Digital Certificate Manager Optional. Required to use Encrypted RDMA adapters.
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 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 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.
5733SC1 *BASE IBM Portable Utilities for i Optional. Required on the managing node for IBM Storage FlashSystem cloning.
5733SC1 Option 1 OpenSSH, OpenSSL, zlib Optional. Required on the managing node for IBM Storage FlashSystem cloning.
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.9
python3.13 -

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 SF99760 - Latest
Db2 Mirror PTF Group SF99961 3 Latest
Db2 for IBM i PTF Group SF99960 1 Latest
Table 5. GUI node PTF groups
PTF Group Name PTF Group Number Minimum Level Required Recommended Level
Db2 Mirror PTF Group SF99961 3 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 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.

End of change