Determine which Control-M/Agents use SSL/TLS communication with Control-M/Server:
- Open the Control-M Configuration Manager (CCM)
- If the SSL column is not currently showing, right click on any column header and select "Column chooser"
- From the Column chooser dialog, drag the "SSL" column into the columns view.
- Select each Control-M/Server in the tree on the left to view the Control-M/Agents in the middle pane
- In the "Type" column header, set the filter to "Control-M Agent"
- Sort by the SSL column and any Agents with SSL set to "Enabled" will need to be handled below
- To create a file with this list of Agents, select the dropdown on the top left next to Home, then select Exports List
Primary Solution:
- Upgrade to a fully supported version of Control-M/Agent (if not on a supported version).
Recommend the latest major version and Fix Pack available - As the Agent user, run the following command on each Unix/Linux Agent with SSL/TLS enabled:
$CONTROLM/toolbox/permission_check.sh - If the check finds any problems, run the command:
$CONTROLM/toolbox/permission_check.sh --force
Alternate Solution when unable to upgrade yet:
- For all Unix/Linux Agents with SSL/TLS enabled, determine the communication mode (Persistent vs Transient).
Run the following command as the Agent user:
ag_diag_comm | grep "Server-Agent Connection mode" - Determine which OS users need access to SSL/TLS files, based on the Agent mode returned from the previous step.
- Transient:
The Agent user needs access, and additionally users who run Agent utilities also need some access. - Transient (by Java):
Only the Agent user needs access to SSL/TLS files. - Persistent:
Only the Agent user needs access to SSL/TLS files.
- Update file authorizations.
Please consult your Unix/Linux System Administrator for assistance to verify and change permissions as needed.
- $CONTROLM/data/SSL/cert
- Read/Write permissions are required by the Agent user to the files in this folder.
- Read permissions are required by any additional users which use Agent utilities to the files in this folder.
- $CONTRLOM/data/PASSWRDS.dat
- Read/Write permissions are required to change the passwords in the local Agent password repository with the ctmpwd utility.
- Read permissions are required to access the passwords in the local Agent password repository (for example, when the user starts up the Agent on UNIX/Linux with the start-ag command).
- $CONTROLM/data/keys/local.key
- Read/Write permissions are required to change the key with the ctmagcpk utility.
- Read permissions are required to change passwords in the local Agent password repository with the ctmpwd utility.
- Read permissions are required to execute Agent utilities in Helix Control-M.
- Read permissions are required to execute the ctmgetccp utility.
- $CONTROLM/data/keys/ctm_key.txt
- Read permissions are required for an Agent user only.
- $CONTROLM/data/JAVACONF.dat
- Read permissions are required for an Agent user only.