agkeystore actions

The following table describes the actions in the agkeystore utility:

Action

Description

-agent

(Windows only) Specify the name of the agent whose Blowfish encryption of job owners credentials are being modified.

-key

Specify the type of encryption key. Enter the value BLOWFISH

-action

Specify the action that the utility must take on the agkeystore.kdb file. The valid values are:

add – creates a new Blowfish encryption key in the agkeystore.kdb file

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

apply – the updated Blowfish encryption key replaces the existing Blowfish encryption key in the agkeystore.kdb file

The Control-M/Agent must be restarted for this action to take effect.

restore – replaces the existing Blowfish encryption key in the agkeystore.kdb file with the Blowfish encryption key that is used by Control-M

The Control-M/Agent must be restarted for this action to take effect.

-input

Specify the full path to the file that contains the Blowfish encryption key.

The maximum length of the key is 32 characters (256 bits) long.

-replace

Replace a new Blowfish encryption key that was created but that has not yet been applied by completing the Apply new key procedure.

-replace is relevant only when -action add is specified and another Blowfish encryption key was added but has not yet been applied. In this case use -replace to overwrite the existing Blowfish encryption key entry with the new Blowfish key. The valid values are:

  • Y – replace existing new Blowfish encryption key if it exists
  • N – do not replace the Blowfish encryption key

Parent Topic

agkeystore