Agent will not load after upgrade

Products

• Workload Automation Agent

Issue/Introduction

After upgrading agents from version 11.4 to 12.1.01, they will not load on two Windows servers.

Environment

Workload Automation Agent

Cause

The agent's defaultlog_agent.log indicate an issue with the `cryptkey.txt` file:

```

10/01/2025 09:30:03.297-0400 3 main.MainThread.CybTcpipControllerPlugin.initialize[:275] - Receiver/Transmitter initializing...
10/01/2025 09:30:03.297-0400 1 main.MainThread.CybTcpipControllerPlugin.initialize[:314] - cybermation.library.security.aa: Unable to read raw key material
                                                                                               at cybermation.library.security.s.a(s.java:453)
                                                                                               at cybermation.commplugins.tcpip.protocol.CybAgentKeyObtainer.initialize(CybAgentKeyObtainer.java:70)
                                                                                               at cybermation.commplugins.tcpip.CybTcpipControllerPlugin.initialize(CybTcpipControllerPlugin.java:277)
                                                                                               at cybermation.agent.controller.CybControllerPluginManager.a(CybControllerPluginManager.java:463)
                                                                                               at cybermation.agent.controller.CybControllerPluginManager.a(CybControllerPluginManager.java:501)
                                                                                               at cybermation.agent.controller.CybControllerPluginManager.initialize(CybControllerPluginManager.java:425)
                                                                                               at cybermation.agent.CybAgentDriver.runApplication(CybAgentDriver.java:301)
                                                                                               at cybermation.agent.CybAgentDriver.main(CybAgentDriver.java:510)
                                                                                           Caused by: java.nio.file.NoSuchFileException: D:\Program Files\CA\WA Agent\cryptkey.txt

```

Resolution

Recreate the `cryptkey.txt` using the keygen utility in the agent installation directory by following these steps:

1. Change to the Agent installation directory.
2. Enter the `keygen` command to generate a new `crypkey.txt` file.
   • Usage: `keygen 0xkey cipher`.
   • For example
   • (Windows): `keygen.bat 0x01234567890123456789012345678901 AES`
   • (Unix/Linux): `./keygen 0x01234567890123456789012345678901 AES`
   • * Notes: The encryption key should be prefixed with `0x`.
3. Restart the agent.

Another option is to copy the `cryptkey.txt` file from a working Windows agent if the encryption key is the same across agents.

Additional Information

Set the Encryption on the Agent Using the Keygen Utility