Migrating PEM SaaS to PEM Software Enterprise

Use the following guide when migrating your PEM deployment from Local Cloud to PEM Software for Enterprise.
Important: Ensure there is less activity on IBM PEM, before you upgrade to IBM PEM Software for Enterprise, ensure there is less activity on IBM PEM.

Migration prerequisites

Back up your IBM PEM database, setup.cfg, and the MountFiles directory.

Ensure the PEM database schema version of your IBM PEM Local Cloud environment is lesser or equal to the version of IBM PEM Software you want to migrate to.
Refer to the table for the PEM Local Cloud version that can be migrated to PEM Software:
IBM PEM Local Cloud Version IBM PEM Software Version
23.2.1 6.2.2.1 or higher
23.1.1 6.2.2 or higher

To migrate, complete the following steps:

  1. Download the tar files. For more information, see Downloading PEM Essentials from Passport Advantage.
  2. Back up your IBM PEM database, setup.cfg, and the MountFiles directory.
  3. Configure files in a new MountFiles directory for IBM PEM Software.
  4. Refer the existing MountFiles directory of PEM Local Cloud environment, as reference:
    1. Copy database drivers to dbdrivers directory.
    2. Copy keystore files to resources/security/ directory.

    3. Copy the System passphrase in passphrase.txt. For more information, see Configuring the properties of Setup.cfg file.

  5. Stop and remove the IBM PEM containers that are running. (PEM Portal, PEM Partner Repository, PEM Partner Provisioner, PEM API Gateway, Agent, or Purge tool.
  6. Run migrator and create new container from the new docker image.
  7. Monitor the log files for any issues. If the new image has any issue, stop the migration process and rollback the IBM PEM database, PEM docker containers, MountFiles and Setup.cfg to their previous state.
  8. Deploy the required containers. For more information, see PEM Portal, PEM Partner Repository, PEM Partner Provisioner, PEM API Gateway, and Agent.