Updating the Default Layout installation by applying a bootstrap package


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

  1. Follow the directions for distributing the bootstrap package via the launch page.
  2. Outages now begin for this MVMMExtensible 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.
    It is not necessary to stop the technologies with embedded extensions when updating the bootstrap package.
  4. Stop the MVMMConfiguration Agent if installed. See Basic-command-parameters-to-control-the-MVMM-Configuration-Agent.
  5. Stop the MVMMExtensible Agent. See Basic command parameters for controlling the MVMM Extensible Agent.
  6. If you have start up scripts, ensure none activate the MVMMExtensible Agent, MVMMConfiguration 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 MVMMConfiguration Agent. A full back up allows you to refer to those files as needed. Otherwise, back up any files that have been changed.
  8. Remove the bmmtm_agent directory.
  9. Remove the jre directory, if present.
  10. Unzip the bootstrap package.
  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. On Windows platforms, whenever a new bootstrap package is installed or updated after application of a Fix Pack, you may need to update the Microsoft runtime libraries. You can execute the installer if the runtime libraries are already installed. BMC recommends you execute both vcredist_x64 and vcredist_x86, although the 32-bit libraries installed by vcredist_x86 are only required by BTM extensions.
  13. Start the MVMMExtensible Agent. See Basic command parameters for controlling the MVMM Extensible Agent.
  14. Start the MVMMConfiguration Agent if installed. See Basic-command-parameters-to-control-the-MVMM-Configuration-Agent.
  15. Start any stand-alone extensions.
  16. The outage has now ended for this agent.
  17. If you are using startup scripts, you can now allow them to activate.
  18. Retain the backup of the installation until the updated installation has been verified to be working.

 

If you cannot use the bootstrap/default layout, please contact BMC Support.

The footprint of the default layout is much larger than in previous versions (largely due to the mandatory JREs included).

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*