Sun ZFS Storage 7420
 
Oracle ZFS Storage ZS3-2
 
Sun Storage 7110 Unified Storage System
 
Sun Storage 7210 Unified Storage System
 
Sun Storage 7410 Unified Storage System
 
Sun ZFS Storage 7120
 
Oracle ZFS Storage ZS3-4
 
Sun Storage 7310 Unified Storage System
 
Oracle ZFS Storage ZS4-4
 
Sun ZFS Storage 7320
 
Oracle ZFS Storage ZS3-BA
 

PLA-Support>Sun Systems>DISK>ZFS Storage>SN-DK: 7xxx NAS
 

In this Document

Goal

Array Appliance Kit Software upgrade

Solution

UPDATE THE APPLIANCE KIT SOFTWARE

References

Applies to:

Goal

Array Appliance Kit Software upgrade

Action Plan:

Follow the 6 steps below to update the Array Appliance Kit Software and Service Processor BIOS/ILOM firmware.

Solution

Location of the Appliance Kit software for download - please consult this document for the recommended 'minimum' versions:

Oracle ZFS Storage Appliance: Software Updates (Doc ID 2021771.1)

The  ak code release will be  compressed for download as a zip file.

Download and Unzip the patches to the Desktop you run the BUI from

 The *.zip file will expand into two files.

The release notes text file for review on the desktop , and the ak code release ending in .gz  for  download to the NAS Boxes.

After the file is  unzipped, change directory to the p#######_revision_Generic/All_Supported_Platforms (Do not unzip the gz file)

Go through the BUI and download and pre-stage the  .gz file  to each NAS to be upgraded

Example:

From the Web Browser https://[your_nas_hostname]:215/#maintenance/system 
click the '+' next to Available Updates
a pop-up windows will allow you to browse to the p########_2011##_Generic\All_Supported_Platforms\  directory and download  the gz file to the NAS.

NOTE:  A customer was attempting to upload a new Appliance Release version via the BUI and received the following error message ... "ak-nas-2011-04-24-9-3-1-1-52-nd.pkg.gz is an empty or otherwise invalid file" ... after restarting AKD (See DocID 1543359.1) the upload worked.

The  NAS will automatically decompress the .gz file as part of the download process. It will then be listed under the available updates.   

UPDATE THE APPLIANCE KIT SOFTWARE

1. Verify current version on the array.

To access the array Appliance Kit Software version information do the following:

Method 1 way of determining the Appliance Kit Software version.

Method 1 via CLI:

From the CLI prompt type in: configuration version show

You will get an output like this:

 
In this output, the Appliance Kit Software version is shown in the line labeled: Appliance Version

The BIOS version is shown on the line labeled: BIOS

The ILOM version is shown in the line labeled: Service Processor

Method 1 via BUI:

In the BUI window do a left click on the Sun Oracle logo in the upper left hand part of the window.

In the information window that comes up look for: example output

Method 2 way of determining the Appliance Kit Software version.

NOTE: Method 2 will only show the Appliance Kit Software version.  The ILOM/BIOS versions are not available through this method.

Method 2 via CLI:

From the CLI prompt type in: maintenance system updates show

You will get an output like this:

In this output the line under the UPDATE section that shows the "current" status is the currently running Appliance Kit Software version.

Method 2 via BUI:

In the BUI navigate to the Maintenance > System window.

In the Available Updates section of this window the currently running Appliance Kit Software version is shown with the status of "Current system software".

2. Check Appliance Kit Version

Refer to document:
For current Array Appliance Kit software versions Oracle ZFS Storage Appliance: Software Updates (Doc ID 2021771.1)

ILOM/BIOS versions Sun Storage 7000 Unified Storage System: How to check the SP BIOS revision level [Document 1174698.1].

3. Download Appliance Kit Software code version to your desktop then upload to the Array.

NOTE: The package to be downloaded should begin with an ak. and end with .pkg.gz.
It is not necessary to ungzip this package before downloading to the array.
An example of the proper file name is: ak-nas-2011-04-24-5-0-1-1-33-nd.pkg.gz

NOTE: Uploading the Appliance Kit software version to the array will not cause the Appliance Kit software version to be applied.
           Applying the Appliance Kit software must be done through a separate step as described in this document in step 5 below.

Download Appliance Kit software version to array via CLI:

In the CLI type: maintenance system updates

Then type: download

At the download prompt type: show

Then you need to set these three parameters: URL, user and password.

For the URL give the complete path including the file name.
Type: set url=ftp://x.x.x.x/var/tmp/ak-nas-2011-04-24-5-0-1-1-33-nd.pkg.gz

For the user give a username authorized to manage the array typically root:
Type: set user=root

For the password give the password for the user defined above.
Type: set password=passwordofuser

When done then type: commit

This will start the array Appliance Kit Software download.  Once complete typing: show should show this version now in the list.

Download Appliance Kit software version via BUI:

Navigate BUI to the Maintenance system window.

Immediately to the left of the Available Updates header is a plus (+) sign.

Left clicking on that plus sign will bring up the Add Software Update window.

Left click on the browse button in that window to select the file to download.

In the File Upload window select the file to be downloaded and then click open.

The file download process will begin and you will see a progress bar.

Once the file download is done and the file is processed it will show up in the Available Updates section as an uploaded update.

4. Run Healthcheck to verify Array condition

Run the healthcheck via the CLI:

From the CLI prompt type: maintenance system updates

Type: show to get a list of available array updates.

Type: select (update) where (update) is the particular update shown in the list from previous step.

Type: check to run the healthcheck for that particular version.

Run the healthcheck via the BUI:

Navigate BUI to the Maintenance system window.

Under the section Available Updates the Appliance Kit Software version to be applied should be shown as a line item.
On the right hand part of that line for that version there should be a right arrow icon.

Left clicking on that arrow will bring up the update action window.
Left clicking on "CANCEL" will close this window with no action taken.
Left clicking on "CHECK" will initiate the healthcheck for this version.

5. Apply Appliance Kit firmware update on the array.

NOTE: As part of the array Appliance Kit Software version update the update process may run a healthcheck.
           If there are any problems that occur during this healthcheck process please refer to this document:

Sun Storage 7000 Unified Storage System: Appliance Firmware Update Health checks [Document 1401522.1]

NOTE: Applying the actual Appliance Kit Software version update will cause the array to reboot.
Any current sessions and data access to the array will be terminated.

NOTE: If the array to be updated is part of a cluster please refer to this document:
Sun Storage 7000 Unified Storage System : How to upgrade a clustered systems [Document 1447284.1]

• Apply the Appliance Kit Software version update via the CLI:

This method is the recommended one as it displays every step in details so that if an issue happens during the upgrade process, it's easier to narrow it down.

NOTE: When applying the update from the CLI it is recommended that this be done from the Service Processor console.

This way the reboot process can be monitored all the way through the reboot.

From the CLI prompt type: maintenance system updates

Type: show to get a list of available array updates.

Type: select (update) where (update) is the particular update shown in the list from previous step.

Type: upgrade to initiate the actual update.

Example :

Once the update completes this session will terminate as array will reboot.

• Apply the Appliance Kit Software version update via the BUI:

Navigate BUI to the Maintenance system window.

Under the section Available Updates the Appliance Kit Software version to be applied should be shown as a line item.
On the right hand part of that line for that version there should be a right arrow icon.
Left clicking on that arrow will bring up the update action window.
Left clicking on "APPLY" will initiate the update.
Left clicking on "CANCEL" will close this window with no action taken.
Left clicking on "CHECK" will initiate a healthcheck as described in step 4.

If "APPLY" is clicked on the update will start and will cause this session to terminate when the reboot is done.

6. Check and apply ILOM/BIOS firmware updates

To check the Service Processor BIOS version refer to this document:

        Sun Storage 7000 Unified Storage System: How to check the SP BIOS revision level [Document 1174698.1]

NOTE: Only qualified versions of ILOM/BIOS code are supported to be installed on any ZFSSA array platform.

The current latest versions that can be installed are listed in this document:

 Oracle ZFS Storage Appliance: Critical Security bug fixes for ZFSSA BIOS/ILOM (October 2017) (Doc ID 2351298.1)

Installation of any unsupported versions of ILOM/BIOS code can cause unintended operation and undetermined issues.

If it is determined that the ZFSSA array is running appliance kit code version 8.7.x and is one of the array types as per the NOTE below that can do the automatic

ILOM/BIOS upgrade and is at the proper versions as per that note to do so then it is the CUSTOMERS responsibility to do that upgrade through the automatic method.

If it is determined that the array type or code version is such that that automatic ILOM/BIOS upgrade can not be done then the ILOM/BIOS upgrade

must be done through Oracle support ( via a new Service Request ), OR via a Certified Oracle Partner.

Refer to these documents for BIOS/ILOM upgrades:

    Document ID 1357354.1 - Sun Storage 7000 Unified Storage: How to update the BIOS for a 7x10 NAS Appliance

    Document ID 1357409.1 - Sun ZFS Storage Appliance: How to update the BIOS for a 7x20 NAS Appliance

  [Review the ZS3-x BIOS settings and confirming the correct implementation before updating a new KM doc for these systems]
    The ZS3-x BIOS settings can be found under system board replacements at this wiki site https://stbeehive.oracle.com/teamcollab/wiki/ZFSSAFieldSupport

Instructions to TSC personnel:

The above documents contain the links to our internal web site.  This is intentional to avoid the recycle of obsolete procedures in the field or cause more problems.

Please talk to L2 TSC or make a collaboration tasks for verification.

References

This solution has no attachment