Oracle ZFS Storage Appliance: Perform Health Check Manually before Firmware Upgrade

Asset ID:	1-71-1904850.1
Update Date:	2017-10-05
Keywords:

Solution Type Technical Instruction Sure

Solution 1904850.1 : Oracle ZFS Storage Appliance: Perform Health Check Manually before Firmware Upgrade

Applies to:

Sun ZFS Storage 7120 - Version All Versions to All Versions [Release All Releases]
Sun Storage 7110 Unified Storage System - Version All Versions to All Versions [Release All Releases]
Sun Storage 7410 Unified Storage System - Version All Versions to All Versions [Release All Releases]
Sun Storage 7310 Unified Storage System - Version All Versions to All Versions [Release All Releases]
Sun Storage 7210 Unified Storage System - Version All Versions to All Versions [Release All Releases]
7000 Appliance OS (Fishworks)

Goal

On the ZFS Storage Appliance, a manual health check can be done prior to firmware upgrade.

Why to do a Manual Health check ?

Although the health check is also performed automatically during a firmware upgrade, health check is a quick way to check SIM or disk path issues - it is always a good idea to perform it in advance instead of finding issues during the actual upgrade procedure.

Solution

Please note that the health check can only be performed when a new appliance firmware is uploaded to the appliance while it is "waiting" to be upgraded.

Also note that health check cannot be performed by selecting current or previous appliance firmware versions.

Below is the simple example of a health check (CLI Method):

7420: maintenance system updates> ls
Updates:

UPDATE DATE STATUS
ak-nas@2011.04.24.4.2,1-1.28 2012-11-5 03:11:34 previous
ak-nas@2013.06.05.1.11,1-1.1 2014-5-6 20:15:58 current
ak-nas@2013.06.05.2.0,1-1.10 2014-6-12 14:17:54 waiting

7420: maintenance system updates> select ak-nas@2013.06.05.2.0,1-1.10 check
You have requested to run checks associated with waiting upgrade media. This
will execute the same set of checks as will be performed as part of any upgrade
attempt to this media, and will highlight conditions that would prevent
successful upgrade. No actual upgrade will be attempted, and the checks
performed are of static system state and non-invasive. Do you wish to continue?

Are you sure? (Y/N)
Healthcheck running ... /

Healthcheck completed. There are no issues at this time which would cause an upgrade to this media to be aborted.

Using BUI Health Check can be done as follows :

Go to Maintenance > System and select the new firmware which is waiting for be upgraded and select the Right Pointing Arrow button next to it :

Firmware1

Then select the "Check" button from the popup window as below :

Select Check button

Failed health check :

7420: maintenance system updates> select ak-nas@2013.06.05.2.0,1-1.10 check
You have requested to run checks associated with waiting upgrade media. This
will execute the same set of checks as will be performed as part of any upgrade
attempt to this media, and will highlight conditions that would prevent
successful upgrade. No actual upgrade will be attempted, and the checks
performed are of static system state and non-invasive. Do you wish to continue?

Are you sure? (Y/N)
Healthcheck running ... done
error: System is not in an upgradeable state: Healthcheck framework usage error
- healthcheck scripts exited abnormally. See alert log for more.

In case of a failed health report, you can find more details in "maintenance logs alerts show" from CLI.

A health check may fail because of multiple issues and looking at the alerts can help you to resolve the same.

In the case that issues cannot be resolved, you should open a Service Request and upload a new support bundle to get the issue analyzed further.

References

<NOTE:1401522.1> - Sun Storage 7000 Unified Storage System: Appliance Firmware Update Health checks
<NOTE:1542500.1> - Sun Storage 7000 Unified Storage System: Mismatched SIM Firmware (FW)

Attachments

This solution has no attachment