Update management services

02/27/2023 Contributors

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 and SolidFire all-flash storage 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.

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:

Open the IP address of the management node in a web browser:
```
https://<ManagementNodeIP>
```
Log in to NetApp Hybrid Cloud Control by providing the storage cluster administrator credentials.
Select Upgrade near the top right of the interface.
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 (Recommended method)
Update management services using the management node 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.

What you'll need

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.

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

Steps

Open the IP address of the management node in a web browser:
```
https://<ManagementNodeIP>
```
Log in to NetApp Hybrid Cloud Control by providing the storage cluster administrator credentials.
Select Upgrade near the top right of the interface.
On the Upgrades page, select the Management Services tab.

The Management Services tab shows the current and available versions of management services software.

If your installation cannot access the internet, only the current software version is shown.
If your installation can access the internet and if a management services upgrade is available, select Begin Upgrade.
If your installation cannot access the internet, do the following:
1. Follow the instructions on the page to download and save a management services upgrade package to your computer.
2. 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.

What you'll need

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.

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

Steps

Open the REST API UI on the management node: https://<ManagementNodeIP>/mnode
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.
Upload and extract the service bundle on the management node using this command: PUT /services/upload
Deploy the management services on the management node: PUT /services/deploy
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