Skip to main content
A newer release of this product is available.

Update management services

Contributors netapp-pcarriga netapp-dbagwell
PDFs

You can update your management services to the latest bundle version after you have installed management node 11.3 or later.

Beginning with the Element 11.3 management node release, the management node design has been changed based on a new modular architecture that provides individual services. These modular services provide central and extended management functionality for NetApp HCI systems. Management services include system telemetry, logging, and update services, the QoSSIOC service for Element Plug-in for vCenter Server, NetApp Hybrid Cloud Control, and more.

About this task

  • You must upgrade to the latest management services bundle before upgrading your Element software.

Note

  • Management services 2.22.7 includes Element Plug-in for vCenter Server 5.0 which contains the remote plug-in. If you use the Element plug-in, you should upgrade to management services 2.22.7 or later to comply with the VMware directive that removes support for local plug-ins. Learn more.

  • For the latest management services release notes describing major services, new features, bug fixes, and workarounds for each service bundle, see the management services release notes
What you'll need

Beginning with management services 2.20.69, you must accept and save the End User License Agreement (EULA) before using the NetApp Hybrid Cloud Control UI or API to upgrade management services:

  1. Open the IP address of the management node in a web browser:

    https://<ManagementNodeIP>

  2. Log in to NetApp Hybrid Cloud Control by providing the storage cluster administrator credentials.

  3. Select Upgrade near the top right of the interface.

  4. The EULA pops up. Scroll down, select I accept for current and all future updates, and select Save.

Update options

You can update management services using the NetApp Hybrid Cloud Control UI or the management node REST API:

Update management services using Hybrid Cloud Control

You can update your NetApp management services using NetApp Hybrid Cloud Control.

Management service bundles provide enhanced functionality and fixes to your installation outside of major releases.

Before you begin

  • You are running management node 11.3 or later.

  • If you are updating management services to version 2.16 or later and you are running a management node 11.3 to 11.8, you will need to increase your management node VM's RAM prior to updating management services:

    1. Power off the management node VM.

    2. Change the RAM of the management node VM from 12GB to 24GB RAM.

    3. Power on the management node VM.

  • Your cluster version is running NetApp Element software 11.3 or later.

  • You have upgraded your management services to at least version 2.1.326. NetApp Hybrid Cloud Control upgrades are not available in earlier service bundles.

Note For a list of available services for each service bundle version, see the Management Services Release Notes.
Steps

  1. Open the IP address of the management node in a web browser:

    https://<ManagementNodeIP>

  2. Log in to NetApp Hybrid Cloud Control by providing the storage cluster administrator credentials.

  3. Select Upgrade near the top right of the interface.

  4. On the Upgrades page, select the Management Services tab.

  5. Follow the instructions on the page to download and save a management services upgrade package to your computer.

  6. Select Browse to locate the package you saved and upload it.

    After you upload the package, the upgrade starts automatically.

    After the upgrade begins, you can see the upgrade status on this page. During the upgrade, you might lose connection with NetApp Hybrid Cloud Control and have to log back in to see the results of the upgrade.

Update management services using the management node API

Users should ideally perform management services updates from NetApp Hybrid Cloud Control. You can however manually upload, extract, and deploy a service bundle update for management services to the management node using the REST API. You can run each command from the REST API UI for the management node.

Before you begin

  • You have deployed a NetApp Element software management node 11.3 or later.

  • If you are updating management services to version 2.16 or later and you are running a management node 11.3 to 11.8, you will need to increase your management node VM's RAM prior to updating management services:

    1. Power off the management node VM.

    2. Change the RAM of the management node VM from 12GB to 24GB RAM.

    3. Power on the management node VM.

  • Your cluster version is running NetApp Element software 11.3 or later.

  • You have upgraded your management services to at least version 2.1.326. NetApp Hybrid Cloud Control upgrades are not available in earlier service bundles.

    Note For a list of available services for each service bundle version, see the Management Services Release Notes.
Steps

  1. Open the REST API UI on the management node: https://<ManagementNodeIP>/mnode

  2. Select Authorize and complete the following:

    1. Enter the cluster user name and password.

    2. Enter the client ID as mnode-client if the value is not already populated.

    3. Select Authorize to begin a session.

    4. Close the window.

  3. Upload and extract the service bundle on the management node using this command: PUT /services/upload

  4. Deploy the management services on the management node: PUT /services/deploy

  5. Monitor the status of the update: GET /services/update/status

    A successful update returns a result similar to the following example:

    {
"current_version": "2.10.29",
"details": "Updated to version 2.17.52",
"status": "success"
}

Find more information