Updating appliances - User Guide - Micetro - 26.1.0

Micetro Admin Guide
ft:locale
en-US
Product name
Micetro
Version
26.1.0

If any MDDS appliances have pending updates, they are displayed on the Appliance updates grid, along with their details and statuses.

There are three types of appliance updates:

  1. Full: Full updates are the most extensive and involve replacing the entire appliance, typically with the release of a new major version. These updates are versioned and are around 700MB in size.
  2. Minor: Minor updates consist of version upgrades, such as 9.4.1, and typically include minor improvements or enhancements. You can always update directly to the latest minor version within a major version. For example, the 9.4.2 update includes all changes made in 9.4.1, you can update directly from 9.4.0 to 9.4.2. However, customers with appliance versions older than 9.4 need to first install the 9.4.0 full upgrade before deploying 9.4.1 or 9.4.2. These updates are around 2–300MB in size.
  3. Patch: Patch updates are minor adjustments to individual components, such as BIND or ISC DHCP. They address specific issues or vulnerabilities.

Appliance update status

The update process involves downloading and deploying updates reflected in the Status column of the Appliance updates grid. There are ten different statuses:

  • Available: Updates are ready for application but have not been downloaded yet.
  • Downloading: This is a temporary state indicating that the patch or upgrade is currently being downloaded.
  • Partial: Updates have been downloaded but not applied to every applicable appliance in the system.
  • Downloaded: Similar to Partial, but updates have not been applied to any appliance in the system.
  • Decompressing: Updates have been downloaded. The archive is being decompressed and verified.
  • Pending: Updates have been downloaded, and are pending manual initiation of the deployment on some of the applicable appliances.
  • Preparing: Micetro is uploading the update package to the appliance. This is the first step after you initiate the deployment of an update package.
  • Deploying: Updates have been downloaded and execution of updating the appliance is in-progress.
  • Waiting: Updates have been completed and Micetro is waiting for the appliance to restart. Or failover in an xHA cluster has been initiated and has not yet been completed.
  • Deployed: Updates have been applied and fully deployed.
Note: It's recommended to update individual appliances one at a time to avoid simultaneous downtime for all appliances.

When downloading and deploying an appliance update, a tooltip in the relevant dialog displays details about the status.



How to update appliances

To update an appliance in Micetro, you can either download and apply the update directly through the Web Application or download the update package manually and then apply it through the Web Application. It’s also possible to update MDDS manually by following the instructions in the BlueCat Address Manager Administration Guide.

To update an appliance:
  1. On the Admin page, select the Configuration tab.
  2. In the left sidebar, select Appliance updates under Micetro version.
  3. Select the relevant update.
  4. Use the Row ... menu to select Download.
    The option to Download an appliance update on the Row ... menu.
  5. Once the download is complete, the update Status becomes Pending. Initiate the update process by selecting Deploy on the Row … menu.

Updating an xHA cluster:

Micetro updates an xHA cluster to a new version seamlessly and automatically completes the following steps:

  • The passive node is upgraded to the new version first.
  • When the nodes are synchronized, manual failover is initiated so that the upgraded node becomes the active node.
  • The previously active node, now passive, is upgraded to the new version.

To manually prepare an update:

  1. Navigate to the appliance update index and grab the filename for the update, such as "filename": "bdds-25.1.2.zip".
  2. Download the update file (.zip) with that filename from the update server and upload it to the Micetro Central server.
  3. Unzip the file and extract its contents, which include the manifest file, into a folder in one of the following locations:
    • Windows: C:\ProgramData\Men and Mice\Central\update\appliance
    • Linux: /var/mmsuite/mmcentral/update/appliance
    Note: We recommend naming the folder based on the update version, for example, C:\ProgramData\Men and Mice\Central\update\appliance\25.1.2 or /var/mmsuite/mmcentral/update/appliance/25.1.2.
  4. In the Web Application, navigate to Admin > Configuration and select Appliance updates in the left sidebar.
  5. Select the update in the data grid and use the Row ... menu to select Deploy.
Note: The update you downloaded should be listed in the data grid and available for deployment as long as there is an MDDS appliance with a version to which the update applies.