SAP agent upgrade on Windows platforms: Creating backup of configuration file

Before you begin

Create a backup of the configuration file before you upgrade the SAP agent on Windows platform.

About this task

This task helps to create backup of the agent configuration file before you upgrade SAP agent on Windows platform.

Perform the following steps to save the configuration changes that are made to the environment file (KSAENV):

1. Create a backup copy of the KSAENV file containing the modified changes and store it locally in another folder. KSAENV file can be found in <install_dir>\tmaitm6_x64 directory, where <install_dir> is the agent installation directory such as C:\IBM\APM on Windows OS.
2. Perform the agent upgrade.
3. The KSAENV file is overwritten when the agent is upgraded to a new version, however the instance specific file , KSAENV_XXX remains intact after upgrade, where XXX is the instance name.
4. Set the required SAP Agent configuration parameters in the new KSAENV file by referring to the backup copy of KSAENV before agent upgrade. Then save and close the file.
5. For all existing agent instances, re-configure the agent instances and restart the agent instances to reflect the change.
6. If new agent instances are configured, start the agent instances.

Results

The updates in the KSAENV file are applied to all agent instances after the agent upgrade.