Reconfiguring HCL UnO agent

After configuring the agent initially, you can change the properties of the agent by reconfiguring. You can change all the properties of the agent, except the agentName.

Overview

You can update the properties of the agent by using the configure command. It is recommended not to use any other method, such as manually editing the agent.properties file. When values are altered directly in the configuration file, there is a risk of introducing errors or inconsistencies that could compromise the functionality of the agent. To mitigate these risks and ensure reliable operation of the agent, it is advisable to use the configure command to update the values in the file. This offers a more controlled and systematic approach to update the values and ensures the changes are applied correctly.

Reconfiguring the agent downloads the certificates again from the agent manager, so make sure that you add the --apiKey parameter with the configure command. If you configured the agent in a folder other than the default, you must also provide the value for --dataDir option.

configure.ps1 [--apiKey= value] [--dataDir= value]
./configure.sh [--apiKey= value] [--dataDir= value]

All the updated values are applied on the next instance of the agent start. If the agent is running while reconfiguring, then stop the agent and start it again to run with updated parameters. For available parameters in the agent.properties file, see Mandatory and optional parameters.