Collecting Agent Information
A CTE Agent provides the agentinfo
utility to collect system and CTE configuration data. The agentinfo
utility takes a configuration snapshot of the system that you can send to Thales Customer Support to debug an issue.
The latest information about individual CTE Agents can also be collected and downloaded on the CipherTrust Manager GUI. The collected information about all the CTE Agents is stored in a dedicated volume on the CipherTrust Manager. An option is provided to clean the Agent information about all the CTE Agents from the volume.
Collecting the CTE Agent Information
To collect the latest CTE Agent information:
Open the Transparent Encryption application.
Click Clients > Clients.
Under Client Name, click the desired client.
Alternatively, click the expand icon () to the left of the desired client in the clients list.
Next to the Agent Information label, click Collect. A request is sent to the CTE Agent to send the latest Agent information to the CipherTrust Manager. On a Windows client, it may take some time to fetch the latest Agent information from the CTE Agent.
The Collect link is displayed until the latest Agent information is received and available for download. As soon as the information is available, the Collect link is replaced with the Recollect and Download links.
Recollecting the CTE Agent Information
After you have fetched the CTE Agent information from the CTE client, a CTE Client Administrator might make some confirmation changes. To get the updated CTE Agent configuration on the CipherTrust Manager, use the Recollect option.
To recollect the updated CTE Agent information:
Open the Transparent Encryption application.
Click Clients > Clients.
Under Client Name, click the desired client.
Alternatively, click the expand icon () to the left of the desired client in the clients list.
Next to the Agent Information label, click Recollect. A request is sent to the CTE Agent to send the updated Agent information to the CipherTrust Manager.
The Recollect and Download links are replaced with Collect until the latest Agent information is available for download. As soon as the information is available, the Collect link is replaced with the Recollect and Download links.
Downloading the CTE Agent Information
After you have fetched the Agent information from a CTE client, you can download this information from the CipherTrust Manager GUI. The information is downloaded in a tar file.
After the download, the Agent information is removed from the CipherTrust Manager.
In a CipherTrust Manager cluster, the information will be downloaded from the node where the Agent information is requested.
To download the CTE Agent information:
Open the Transparent Encryption application.
Click Clients > Clients.
Under Client Name, click the desired client.
Alternatively, click the expand icon () to the left of the desired client in the clients list.
Next to the Agent Information label, click Download.
The CTE Agent information currently available on the CipherTrust Manager is downloaded in a tar file, and removed from the CipherTrust Manager. The Recollect and Download links are again replaced with Collect.
Cleaning the CTE Agent Information Volume
When you fetch the CTE Agent information from a CTE Agent, this information is stored in a file in a dedicated volume on the CipherTrust Manager. This volume contains information about all the CTE Agents from which you have collected the information.
The CipherTrust Manager provides an option to clean the Agent information volume any time to remove all the files containing the Agent information from the CipherTrust Manager. Also, when the volume is 80% full, you are prompted to clean it while collecting the latest Agent information from clients.
Clean the Volume Any Time
To clean the volume containing the CTE Agent information:
Log on to the CipherTrust Manager GUI.
Navigate to Admin Settings > Properties.
Under CTE AGENT INFORMATION VOLUME, click Remove Agent Information. A warning message is displayed.
Warning
The Agent information currently available on the CipherTrust Manager will be removed. You will have to regenerate the Agent information.
Select Yes, clean up the entire volume containing the Agent information.
Click Clean.
Clean the Volume When 80% Full
When the volume containing the Agent information is 80% full, a warning message is displayed while collecting the Agent information from a client. You need to clean the volume to collect the latest information.
To clean the volume, click Clear Volume. All the files containing the Agent information are removed from the volume. You can now retry collecting the latest Agent information.