Click to add to Favorites Sun Storage 7000 Unified Storage System: How To

Upgrade the Appliance Kit Software and Service Processor BIOS/ILOM Firmware (Doc
ID 1513423.1) To BottomTo Bottom

In this Document
Goal
Array Appliance Kit Software upgrade
Solution

UPDATE THE APPLIANCE KIT SOFTWARE

References
APPLIES TO:

Sun ZFS Storage 7120 - Version All Versions and later

Sun Storage 7210 Unified Storage System - Version All Versions and later
Sun ZFS Storage 7420 - Version All Versions and later
Sun ZFS Storage 7320 - Version All Versions and later
Oracle ZFS Storage ZS3-4 - Version All Versions and later
7000 Appliance OS (Fishworks)
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.

Note: For 7x10 with revision older than ak-2010.08.17.2.1 (2010.Q3.2.1) please open
a Support Request with Oracle to help upgrade to ak-2010.08.17.2.1 (2010.Q3.2.1).
Once at 2010.Q3.2.1 or higher you can then upgrade as per the 'Download link'
column in Document ID 2021771.1 - Oracle ZFS Storage Appliance: Software Updates
UPDATE THE APPLIANCE KIT SOFTWARE

NOTE: To prevent any 'spurious' ASRs being generated during the upgrade procedure,
you may consider disabling 'ASR/Phone Home' on the appliance, or deactivating ASR
for the asset via My Oracle Support (See Doc ID 1508403.1)

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:

7000:> configuration version show

Appliance Name: se-7000a-fll03
Appliance Type: Sun Storage 7000
Appliance Version: 20xx.xx.xx.x.x,x-x.xx
First Installed: Thu Jul 07 2011 16:50:41 GMT+0000 (UTC)
Last Updated: Wed Aug 08 2012 06:07:36 GMT+0000 (UTC)
Last Booted: Tue Feb 12 2013 14:19:51 GMT+0000 (UTC)
Appliance Serial Number: 61226a65-a3f0-4367-a523-cc49e8b95674
Chassis Serial Number: 0917QAP00E
Software Part Number: Sun Microsystems, Inc. 259-5151
Vendor Product ID: urn:uuid:615bcdd7-195e-11de-857b-080020a9ed93
Browser Name: aksh 1.0
Browser Details: aksh
HTTP Server: Apache/2.2.16 (Unix)
SSL Version: OpenSSL 0.9.8o 01 Jun 2010
Appliance Kit: ak/SUNW,codename@20xx.xx.xx.x.x,x-x.xx
Operating System: SunOS 5.11 ak/generic@20xx.xx.xx.x.x,x-x.xx 64-bit
BIOS: American Megatrends Inc. 0ABMN080 06/25/2010
Service Processor: 2.0.2.16
7000:>

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

Appliance Kit ak/SUNW,codename@20xx.xx.xx.x.xx,x-x.x

Operating System SunOS 5.11 ak/generic@20xx.xx.xx.x.xx,x-x.x 64-bit
BIOS American Megatrends Inc. 0ABMN080 07/03/2012
Service Processor 2.0.2.16

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:

7000:> maintenance system updates show

Updates:

UPDATE DATE STATUS

ak-nas@2010.08.17.4.2,1-1.37 2011-9-19 17:37:58 previous
ak-nas@2011.04.24.4.2,1-1.19 2012-5-7 19:26:43 current
ak-nas@2011.04.24.9.0,1-1.48 2014-4-13 21:28:50 waiting

Deferred updates:

The following updates enable features that are incompatible with earlier
software versions. As these updates cannot be reverted once committed, and peer
system resources are updated across a cluster, verifying first that the system
upgrade is functioning properly before applying deferred updates is advised.

1. Improved RAID performance

1. Improved snapshot performance

Hardware Updates: 1 remaining

The appliance is currently configured as part of a cluster. The cluster peer
may have shared resources for which deferred updates are available. After all
updates are completed, check both cluster peers for any deferred updates.
7000:>
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 :

ZFSSA:maintenance system updates ak-nas@2013.06.05.6.8,1-1.1> upgrade

This procedure will consume several minutes and requires a system reboot upon
successful update, but can be aborted with [Control-C] at any time prior to
reboot. A health check will validate system readiness before an update is
attempted, and may also be executed independently using the check command.
Are you sure? (Y/N) Are you sure? (Y/N)
Updating from ... ak/nas@2013.06.05.4.2,1-1.1
Loading media metadata ... done.
Selecting alternate product ... SUNW,otoroZ4
Installing Oracle ZFS Storage ZS4-4 2013.06.05.6.8,1-1.1
pkg://sun.com/ak/SUNW,otoroZ4@2013.06.05.6.8,1-1.1:20161012T160957Z
Creating system/ak-nas-2013.06.05.6.8_1-1.1 ... done.
Creating system/ak-nas-2013.06.05.6.8_1-1.1/install ... done.
Creating system/ak-nas-2013.06.05.6.8_1-1.1/boot ... done.
Creating system/ak-nas-2013.06.05.6.8_1-1.1/root ... done.
Creating system/ak-nas-2013.06.05.6.8_1-1.1/install/svc ... done.
Creating system/ak-nas-2013.06.05.6.8_1-1.1/install/var ... done.
Creating system/ak-nas-2013.06.05.6.8_1-1.1/install/home ... done.
Creating system/ak-nas-2013.06.05.6.8_1-1.1/install/stash ... done.
Creating system/ak-nas-2013.06.05.6.8_1-1.1/wiki ... done.
Extracting os image ... done.
Customizing Solaris ... done.
Creating driver_aliases.addendum... done.
Updating vfstab ... done.
Generating usr/man windex ... done.
Generating usr/perl5/man windex ... done.
Preserving ssh keys ... done.
Configuring smf(5) ... done.
Extracting appliance kit ... Creating private passwd and shadow files ... done.
Creating private smbshadow file ... done.
Copying pkcs11.conf ... done.
Creating product symlink ... done.
Registering update job 26fd9073-6ced-6433-e6f7-ca87fc2131bb ... done.
Creating install profile ... done.
Assigning appliance serial number ... edc0f5c4-96f1-cd6d-984f-e7c786961560
Determining chassis serial number ... 1516NM902A
Setting appliance product string ... SUNW,otoroZ4
Setting appliance product class ... nas
Setting install timestamp ... done.
Saving SSL keys ... done.
Updating phone-home key ... done.
Saving currently running profile ... done.
Installing firmware ... done.
Installing device links ... Installing device files ... Updating device links ...
done.
Updating /etc ... done.
Building boot menu ... done.
Installing boot amd64/unix ... done.
Installing boot menu ... done.
Snapshotting zfs filesystems ... done.
Installing grub on /dev/rdsk/c0t5000CCA0710E5720d0s0 ... done.
Installing grub on /dev/rdsk/c0t5000CCA0710D21E4d0s0 ... done.
Update completed; rebooting.
ZFSSA console login: syncing file systems... done

[..]

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]

Currently if it is determined that the BIOS/ILOM version needs to be upgraded this

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