Skip to content

Commit

Permalink
Merge pull request #161 from NetAppDocs/223-vcp51-release-element125
Browse files Browse the repository at this point in the history 
Management services 2.23 and VCP 5.1
  • Loading branch information
@netapp-pcarriga
netapp-pcarriga committed Mar 27, 2023
2 parents eb59fde + cff8d32 commit 6431e4c
Show file tree
Hide file tree
Showing 8 changed files with 61 additions and 215 deletions.
3 changes: 2 additions & 1 deletion concepts/concept_rn_relatedrn_element.adoc
View file
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,8 @@ NOTE: You will be prompted to log in using your NetApp Support credentials.
* https://kb.netapp.com/Advice_and_Troubleshooting/Data_Storage_Software/Management_services_for_Element_Software_and_NetApp_HCI/Management_Services_Release_Notes[Management Services Release Notes^]

== NetApp Element Plug-in for vCenter Server
* https://library.netapp.com/ecm/ecm_download_file/ECMLP2884992[vCenter Plug-in 5.0 Release Notes^] _NEW_
* https://library.netapp.com/ecm/ecm_download_file/ECMLP2885734[vCenter Plug-in 5.1 Release Notes^] _NEW_
* https://library.netapp.com/ecm/ecm_download_file/ECMLP2884992[vCenter Plug-in 5.0 Release Notes^]
* https://library.netapp.com/ecm/ecm_download_file/ECMLP2884458[vCenter Plug-in 4.10 Release Notes^]
* https://library.netapp.com/ecm/ecm_download_file/ECMLP2881904[vCenter Plug-in 4.9 Release Notes^]
* https://library.netapp.com/ecm/ecm_download_file/ECMLP2879296[vCenter Plug-in 4.8 Release Notes^]
Expand Down
34 changes: 2 additions & 32 deletions storage/reference_prereq_network_port_requirements.adoc
View file
Original file line number Diff line number Diff line change
Expand Up @@ -14,21 +14,6 @@ You might need to allow the following TCP ports through your datacenter's edge f

All ports are TCP unless stated otherwise, and should permit bi-directional communications between the NetApp Support Server, management node, and nodes running Element software.

[NOTE]
======================
The NetApp Hybrid Cloud Control web UI and API download software packages from the NetApp online software repository. Because of this, some URLs or IP addresses might resolve to other URLs or IP addresses based on the content delivery network. If possible, you should work with a network engineer to add these URLs or IP addresses to the firewall rules, using the following general steps:
.Steps
. Use the Wget or cURL utilities to access a URL (support-sg-nawest.netapp.com, for example).
. Check for connectivity as shown in the following example:
+
image::network_ports.PNG[Check port connectivity]
. Receive a failure to access the URL (different from support-sg-nawest.netapp.com).
. Edit the firewall rules to allow the new URL.
. Repeat the above steps until the access attempt succeeds.
======================

TIP: Enable ICMP between the management node, nodes running Element software, and cluster MVIP.

The following abbreviations are used in the table:
Expand Down Expand Up @@ -108,23 +93,6 @@ UI and API access to storage node and Element software upgrades
a|
Management node
a|
New release notification:

* `https://support.netapp.com/aods/`

Software download:

* `https://support-sg-emea.netapp.com`
* `https://support-sg-naeast.netapp.com`
* `https://support-sg-nawest.netapp.com`

a|
443
a|
Management node service upgrades
a|
Management node
a|
monitoring.solidfire.com
a|
443
Expand Down Expand Up @@ -463,4 +431,6 @@ vCenter Plug-in registration. The port can be closed after registration is compl
== For more information
* https://www.netapp.com/data-storage/solidfire/documentation[SolidFire and Element Resources page^]
* https://docs.netapp.com/us-en/vcp/index.html[NetApp Element Plug-in for vCenter Server^]

// 2023 FEB 23, DOC-4667
// 2022 DEC 14, DOC-4644
66 changes: 11 additions & 55 deletions upgrade/task_hcc_update_management_services.adoc
View file
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ Beginning with the Element 11.3 management node release, the management node des

[NOTE]
====
* Management services 2.22.7 includes NetApp Element Plug-in for VMware vCenter Server 5.0 which contains the remote plug-in. If you use the Element plug-in, you should upgrade to version 5.0 to comply with the VMware directive that removes support for local plug-ins. https://kb.vmware.com/s/article/87880[Learn more^]. If you do not use the plug-in, this is an optional upgrade.
* 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. https://kb.vmware.com/s/article/87880[Learn more^].
* For the latest management services release notes describing major services, new features, bug fixes, and workarounds for each service bundle, see https://kb.netapp.com/Advice_and_Troubleshooting/Data_Storage_Software/Management_services_for_Element_Software_and_NetApp_HCI/Management_Services_Release_Notes[the management services release notes^]
====

Expand All @@ -39,16 +39,13 @@ 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*.
+
NOTE: When you accept the EULA, it is recorded for all future updates and the automatic download feature is enabled. You will receive updates on NetApp software updates and upgrades, which you can install at your discretion and convenience. You can disable the automatic download feature by disabling network connectivity to the NetApp online software repository.

.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 the management node API for dark sites>>

== Update management services using Hybrid Cloud Control

Expand Down Expand Up @@ -77,73 +74,28 @@ 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.
+
NOTE: If your installation cannot access the internet, only the current software version is shown. If your installation has external connectivity, but cannot access the NetApp online repository, check your link:../mnode/task_mnode_configure_proxy_server.html[proxy configuration].

. 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:
.. Follow the instructions on the page to download and save a management services upgrade package to your computer.
.. Select *Browse* to locate the package you saved and upload it.
. Follow the instructions on the page to download and save a management services upgrade package to your computer.
. 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 update management services using the REST API UI from the management node.
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 are running management node 11.3 or later.
* 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:
.. Power off the management node VM.
.. Change the RAM of the management node VM from 12GB to 24GB RAM.
.. 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 https://kb.netapp.com/Advice_and_Troubleshooting/Data_Storage_Software/Management_services_for_Element_Software_and_NetApp_HCI/Management_Services_Release_Notes[Management Services Release Notes^].

.Steps
. Open the REST API UI on the management node: `https://<ManagementNodeIP>/mnode`
. Select *Authorize* and complete the following:
.. Enter the cluster user name and password.
.. Enter the client ID as `mnode-client` if the value is not already populated.
.. Select *Authorize* to begin a session.
.. Close the window.
. (Optional) Confirm available versions of management node services: `GET /services/versions`
. (Optional) Get detailed information about the latest version: `GET /services/versions/latest`
. (Optional) Get detailed information about a specific version: `GET /services/versions/{version}/info`
. Perform one of the following management services update options:
.. Run this command to update to the most recent version of management node services: `PUT /services/update/latest`
.. Run this command to update to a specific version of management node services: `PUT /services/update/{version}`
. Run `GET/services/update/status` to monitor the status of the update.
+
A successful update returns a result similar to the following example:
+
----
{
"current_version": "2.10.29",
"details": "Updated to version 2.14.60",
"status": "success"
}
----

== Update management services using the management node API for dark sites

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:
.. Power off the management node VM.
.. Change the RAM of the management node VM from 12GB to 24GB RAM.
.. Power on the management node VM.
* Your cluster version is running NetApp Element software 11.3 or later.
* You have downloaded the service bundle update from the https://mysupport.netapp.com/site/products/all/details/mgmtservices/downloads-tab[NetApp Support Site^] to a device that can be used in the dark site.
NOTE: For a list of available services for each service bundle version, see the https://kb.netapp.com/Advice_and_Troubleshooting/Data_Storage_Software/Management_services_for_Element_Software_and_NetApp_HCI/Management_Services_Release_Notes[Management Services Release Notes^].

.Steps
. Open the REST API UI on the management node: `https://<ManagementNodeIP>/mnode`
Expand Down Expand Up @@ -171,3 +123,7 @@ A successful update returns a result similar to the following example:

* https://www.netapp.com/data-storage/solidfire/documentation[SolidFire and Element Resources page^]
* https://docs.netapp.com/us-en/vcp/index.html[NetApp Element Plug-in for vCenter Server^]

// 2022 FEB 03, DOC-4651
// 10 MAR 2023, DOC-4652
// 2023 FEB 23, DOC-4667
4 changes: 2 additions & 2 deletions upgrade/task_hcc_upgrade_element_prechecks.adoc
View file
Original file line number Diff line number Diff line change
Expand Up @@ -33,8 +33,6 @@ 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*.
+
NOTE: When you accept the EULA, it is recorded for all future updates and the automatic download feature is enabled. You will receive updates on NetApp software updates and upgrades, which you can install at your discretion and convenience. You can disable the automatic download feature by disabling network connectivity to the NetApp online software repository.

.Health check options

Expand Down Expand Up @@ -200,3 +198,5 @@ Storage health checks make the following checks per cluster.

* https://www.netapp.com/data-storage/solidfire/documentation[SolidFire and Element Resources page^]
* https://docs.netapp.com/us-en/vcp/index.html[NetApp Element Plug-in for vCenter Server^]

// 2023 FEB 23, DOC-4667
68 changes: 12 additions & 56 deletions upgrade/task_hcc_upgrade_element_software.adoc
View file
Original file line number Diff line number Diff line change
Expand Up @@ -43,8 +43,6 @@ 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*.
+
NOTE: When you accept the EULA, it is recorded for all future updates and the automatic download feature is enabled. You will receive updates on NetApp software updates and upgrades, which you can install at your discretion and convenience. You can disable the automatic download feature by disabling network connectivity to the NetApp online software repository.

.Upgrade options

Expand All @@ -59,9 +57,6 @@ IMPORTANT: If you are upgrading an H610S series node to Element 12.5 or later an

Using the NetApp Hybrid Cloud Control UI, you can upgrade a storage cluster.

.What you'll need
* If your management node is not connected to the internet, you have downloaded the https://mysupport.netapp.com/site/products/all/details/element-software/downloads-tab[Element software upgrade package (.tar.gz) for SolidFire storage clusters^].

CAUTION: For potential issues while upgrading storage clusters using NetApp Hybrid Cloud Control and their workarounds, see this https://kb.netapp.com/Advice_and_Troubleshooting/Hybrid_Cloud_Infrastructure/NetApp_HCI/Potential_issues_and_workarounds_when_running_storage_upgrades_using_NetApp_Hybrid_Cloud_Control[KB article^].

.Steps
Expand All @@ -83,26 +78,21 @@ The *Storage* tab lists the storage clusters that are part of your installation.
|Option
|Steps

|Your management node has external connectivity.
a|
. Select the drop-down arrow next to the cluster you are upgrading, and select from the upgrade versions available under the *Element* tab.
. Select *Begin Upgrade*.

TIP: The *Upgrade Status* changes during the upgrade to reflect the status of the process. It also changes in response to actions you take, such as pausing the upgrade, or if the upgrade returns an error. See <<Upgrade status changes>>.

NOTE: While the upgrade is in progress, you can leave the page and come back to it later to continue monitoring the progress. The page does not dynamically update status and current version if the cluster row is collapsed. The cluster row must be expanded to update the table or you can refresh the page.

You can download logs after the upgrade is complete.

|Your management node is within a dark site without external connectivity.
|All clusters running Element 11.8 and later
a|
. Select *Browse* to upload the upgrade package that you downloaded.
. Wait for the upload to complete. A progress bar shows the status of the upload.

+
CAUTION: The file upload will be lost if you navigate away from the browser window.

+
An on-screen message is displayed after the file is successfully uploaded and validated. Validation might take several minutes. If you navigate away from the browser window at this stage, the file upload is preserved.

. Select *Begin Upgrade*.
+
TIP: The *Upgrade Status* changes during the upgrade to reflect the status of the process. It also changes in response to actions you take, such as pausing the upgrade, or if the upgrade returns an error. See <<Upgrade status changes>>.
+
NOTE: While the upgrade is in progress, you can leave the page and come back to it later to continue monitoring the progress. The page does not dynamically update status and current version if the cluster row is collapsed. The cluster row must be expanded to update the table or you can refresh the page.
+
You can download logs after the upgrade is complete.
|You are upgrading an H610S cluster running Element version earlier than 11.8.
a|
. Select the drop-down arrow next to the cluster you are upgrading, and select from the upgrade versions available.
Expand Down Expand Up @@ -140,9 +130,6 @@ Here are the different states that the *Upgrade Status* column in the UI shows b
|Error
|An error has occurred during the upgrade. You can download the error log and send it to NetApp Support. After you resolve the error, you can return to the page, and select *Resume*. When you resume the upgrade, the progress bar goes backwards for a few minutes while the system runs the health check and checks the current state of the upgrade.

|Unable to Detect
|NetApp Hybrid Cloud Control shows this status instead of *Versions Available* when it does not have external connectivity to reach the online software repository. If you have external connectivity but still see this message, check your link:../mnode/task_mnode_configure_proxy_server.html[proxy configuration].

|Complete with Follow-up
|Only for H610S nodes upgrading from Element version earlier than 11.8. After phase 1 of the upgrade process is complete, this state prompts you to perform additional upgrade steps (see the https://kb.netapp.com/Advice_and_Troubleshooting/Hybrid_Cloud_Infrastructure/H_Series/NetApp_H610S_storage_node_power_off_and_on_procedure[KB article^]). After you complete phase 2 and acknowledge that you have completed it, the status changes to *Up to Date*.
|===
Expand All @@ -152,38 +139,6 @@ Here are the different states that the *Upgrade Status* column in the UI shows b
You can use APIs to upgrade storage nodes in a cluster to the latest Element software version. You can use an automation tool of your choice to run the APIs. The API workflow documented here uses the REST API UI available on the management node as an example.

.Steps
. Do one of the following depending on your connection:
+
[%header,cols=2*]
|===
|Option
|Steps

|Your management node has external connectivity.
a|
. Verify the repository connection:
.. Open the management node REST API UI on the management node:
+
----
https://<ManagementNodeIP>/package-repository/1/
----
.. Select *Authorize* and complete the following:
... Enter the cluster user name and password.
... Enter the client ID as `mnode-client`.
... Select *Authorize* to begin a session.
... Close the authorization window.
.. From the REST API UI, select *GET ​/packages​/remote-repository​/connection*.
.. Select *Try it out*.
.. Select *Execute*.
.. If code 200 is returned, go to the next step. If there is no connection to the remote repository, establish the connection or use the dark site option.
. Find the upgrade package ID:
.. From the REST API UI, select *GET /packages*.
.. Select *Try it out*.
.. Select *Execute*.
.. From the response, copy and save the package ID for use in a later step.

|Your management node is within a dark site without external connectivity.
a|
. Download the storage upgrade package to a device that is accessible to the management node.
+
Go to the Element software https://mysupport.netapp.com/site/products/all/details/element-software/downloads-tab[downloads page^] and download the latest storage node image.
Expand All @@ -210,7 +165,6 @@ https://<ManagementNodeIP>/package-repository/1/
.. Select *Execute* to initiate the status request.
+
The response indicates `state` as `SUCCESS` when complete.
|===
. Locate the storage cluster ID:
.. Open the management node REST API UI on the management node:
+
Expand Down Expand Up @@ -388,3 +342,5 @@ CAUTION: Aborting the cluster upgrade while a node is being updated might result

* https://www.netapp.com/data-storage/solidfire/documentation[SolidFire and Element Resources page^]
* https://docs.netapp.com/us-en/vcp/index.html[NetApp Element Plug-in for vCenter Server^]

// 2023 FEB 23, DOC-4667

0 comments on commit 6431e4c

Please sign in to comment.