Installing the activation engine on IBM i

Before you capture a virtual server that runs IBM® i, you can order and install a program temporary fix (PTF) to get a basic activation engine that you can use with VMControl.

About this task

To install the activation engine on IBM i, complete the following steps:

Procedure

Order and install PTF SI50088. For instructions, see Using software fixes.
Enable the activation engine by running the following command on the virtual server:
```
CALL PGM(QSYS/QAENGCHG) PARM(*ENABLE)
```
Note: This command needs to be run with a user profile that has the following special authorities:
- *ALLOBJ
- *AUDIT
- *IOSYSCFG
- *JOBCTL
- *SAVSYS
- *SECADM
- *SERVICE
- *SPLCTL
Power® off the virtual server.

What to do next

After you order and install the activation engine, you can show the status of the activation engine or disable the activation engine.

To disable the activation engine, run the following command:

CALL PGM(QSYS/QAENGCHG) PARM(*DISABLE)

Note: To disable and eject the virtual optical volume that containing the open virtualization format (OVF) environment file, run the following command:

CALL PGM(QSYS/QAENGCHG) PARM(*DISABLEEJ)

This allows the virtual server to power on without executing the activation engine.

To display the status of the IBM i activation engine, run the following command:

CALL PGM(QSYS/QAENGDSP) 2. dspjoblog 3. F10

One of the following messages is displayed:

THE SYSTEM ACTIVATION ENGINE IS ENABLED
The activation engine runs the next time the virtual server is powered on and modifies the system configuration if the ovf-env.xml file is mounted.
THE SYSTEM ACTIVATION ENGINE IS DISABLED
The activation engine does not run the next time the virtual server is powered on.
THE SYSTEM ACTIVATION ENGINE COMPLETED
The activation engine configured the virtual server and does not run the next time the virtual server is powered on.