Updating or upgrading the Flat Directory Layout installation

This section outlines the steps required to update the installation that is already using the Flat Directory Layout.

1. Follow the directions for distributing the bootstrap package via the launch page.
2. Outages now begin for this TMTM Extensible Agent.
3. Stop any stand-alone extensions. Even though some of the extensions are not updated from the bootstrap package they might be using the JRE. See Running performance and availability monitoring extensions and Running application transaction tracing (transaction monitoring) extensions.
   It is not necessary to stop the technologies with embedded extensions.
4. Stop the TMTM Configuration Agent if installed. See Basic command parameters to control the TMTM Configuration Agent.
5. Stop the TMTM Extensible Agent. See Basic command parameters for controlling the TMTM Extensible Agent.
6. If you have start up scripts, ensure none activate the TMTM Extensible Agent, TMTM Configuration Agent or extensions or technologies with embedded extensions during this upgrade.
7. If you have sufficient disk space it is recommended you back up the installation directory. The bootstrap distribution does not overlay the following files:
   • eaa.xml
   • eaapi.ini
   • checkpoint.bin
   • rtsp.xml
     
     However, if you have modified any other files, those are replaced and the changes need to be re-applied. For example, logging changes made to the TMTM Configuration Agent. A full back up allows you to refer to those files as needed. Otherwise, back up any files that have been changed.
8. Follow the directions for distributing the list of files for your platform.
9. Remove the bmmtm-agent directory (or the directory where it was installed) and re-install the TMTM Configuration Agent following the installation steps earlier in this section.
10. Remove the directory where agentpref was installed and re-install it following the installation steps earlier in this section.
11. Re-apply the edits to files. Note that files that are replaced are not guaranteed to have the same format as before. Consult BMC Support if you are unsure you should re-apply any changes.
12. Start the TMTM Extensible Agent. See Basic command parameters for controlling the TMTM Extensible Agent.
13. Start the TMTM Configuration Agent if installed. See Basic command parameters to control the TMTM Configuration Agent.
14. Start any stand-alone extensions.
15. The outage has now ended for this agent.
16. If you are using startup scripts, you can now allow them to activate.
17. Retain the backup of the installation until the updated installation has been verified to be working.