Add new key

Creates a new Blowfish encryption key in the agkeystore.kdb file.

After selecting the Add new key option, you are prompted to enter an input file name to the file that contains the key. Ensure that you specify the full path to this file.

If a new Blowfish key was added earlier but was not yet applied by completing the Apply new key procedure, you are prompted to either overwrite the earlier Blowfish key with a newer Blowfish key or leave the Blowfish key that was created earlier intact and not create a subsequent newer Blowfish key.

When Control-M/Agent is running on Windows computers and configured with LOGON_AS_USER logon option, a new PASSWRDS file containing all the job owners and their passwords encrypted with the new key is created. The original PASSWRDS file is not changed.

After adding a new key, only use ctmpwd to create and modify Control-M/Agent users and passwords when you have completed the Apply new key procedure.

Apply new key

The new key replaces the existing Blowfish encryption key in the agkeystore.kdb file used by Control-M/Agent and the PASSWRDS file is replaced with the new PASSWRDS file that is created in the Add new key option when Control-M/Agent is running on Windows computers and configured with LOGON_AS_USER logon option.

Immediately after applying the new key, restart Control-M/Agent for the new Blowfish encryption key to be used.

Restore default key

Replaces the existing Blowfish encryption key entry in the agkeystore.kdb file with the default Blowfish encryption key that is used by Control-M.

When Control-M/Agent is running on Windows computers and configured with LOGON_AS_USER logon option, the PASSWRDS file is saved with the job owners and their passwords encrypted with the default key.

Immediately after restoring the default key, restart Control-M/Agent for the new Blowfish encryption key to be used.