kate-agent does not respond after upgrade

Product:
Planning Analytics version 2.1.14
Microsoft Windows 2022 server

Issue:
After upgrade from previous version of TM1, you do not get the PAA_Agent to work. It does not respond on port 9012.

In power shell you test with:   tnc  servername.domain.com  -port  9012

Suggested solution:

The path to the bin folder have changed for TM1, to D:\Program Files\ibm\tm1_64\bin64

Therefor when you have updated the PAA Agent, run the following scripts from a Command Prompt.
<install_dir>\paa_agent\bin\PAAAgentSetJavaHome.bat

This should update the server.env file with the correct path to the JAVA JRE

The configuration is done in the  D:\Program Files\ibm\tm1_64\paa_agent\wlp\usr\servers\kate-agent\bootstrap.properties file.

This file need to be updated manually every time you upgrade, as it is overwritten with default values.

If you have more TM1 tools installed on the server, it can point to the other folder and still work.

Then after that file is updated, you can start the PAA_Agent service.

 

If above does not work;

You may need to uninstall PAL totally and start over.
Stop all TM1 services.

To remove the TM1 Admin Server service, run the tm1admsd.exe -remove command.
To remove the Planning Analytics Administration agent service, run the <install_dir>\paa\bin\PAAAgentDelete.bat script.

Run Uninstall_IBM_Planning_Analytics.exe in the <install_dir>\uninstall directory.

Ensure that the PAA Agent is uninstalled from the Windows service list.

Then run the installation again of TM1/PAL from analytics-installer-4.0.27-win.exe

Create the ADMIN service again.

Update the bootstrap.properties file with SMTP information

Run the bat files;

<install_dir>\paa_agent\bin\PAAAgentSetJavaHome.bat

<install_dir>\paa_agent\bin\PAAAgentRegister.bat

Start and test again.

 

More Information:

https://www.ibm.com/docs/en/planning-analytics/2.1.0?topic=itscpa2l-registering-running-planning-analytics-administration-agent-as-windows-service

https://www.ibm.com/docs/en/planning-analytics/2.1.0?topic=upal2-upgrading-planning-analytics-workspace-local-from-version-20-21 

https://www.ibm.com/docs/en/planning-analytics/2.1.0?topic=later-uninstalling-data-tier-components