JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle® ZFS Storage Appliance Customer Service Manual

For ZS3-x, 7x20 Controllers, and DE2-24, Sun Disk Shelves

Oracle Technology Network
Print View
search filter icon
search icon

Document Information

Using This Documentation

Chapter 1 Introduction

Chapter 2 Hardware Maintenance

Chapter 3 System Maintenance



System Disks

Support Bundles

Managing Support Bundles Using the BUI

Generating and Uploading a Support Bundle Using the BUI

Support Bundle Options

Managing Support Bundles Using the CLI

Initial Setup

Factory Reset


System Updates

Software Update Notification

Scheduling Software Notification Using the BUI

Scheduling Software Notification Using the CLI

Checking for Updates Using the BUI

Checking for Updates Using the CLI

System Update Overview


Update Health Checks



Troubleshooting Update Health Check Failures

Actions to Take to Resolve Health Check Alerts

Resolution Steps

Steps for Resolving Health Check Alerts

Deferred Updates

Reboot After an Update

Hardware Firmware Updates


Fail-safe Rollback

Cluster Upgrade

Performing the Cluster Upgrade

Cluster States During Upgrade

Updating via the BUI

Unpacking and Verifying Media

Beginning the Upgrade

Rolling Back

Removing Update Media

Applying Deferred Updates

Updating via the CLI

Unpacking and Verifying Media

Beginning an Upgrade

Rolling Back

Removing Update Media

Applying Deferred Updates (CLI)

Passthrough x

Passthrough-x Deferred Update

User Quotas

User Quotas Deferred Update


COMSTAR Deferred Update

Triple Parity RAID

Triple-Parity RAID Deferred Update


Data Deduplication Deferred Update


Replication Deferred Update

Received Properties

Received Properties Deferred Update

Slim ZIL


Snapshot Deletion

Snapshot Deletion Deferred Update

Recursive Snapshots

Recursive Snapshots Deferred Update

Multi Replace

Multi Replace Deferred Update

RAIDZ Mirror

RAIDZ/Mirror Deferred Update

Optional Child Dir


Multiple Initiator Groups per LUN


Support for Large Block Sizes

Support for Large Block Sizes

Sequential Resilvering

Sequential Resilvering


Configuration Backup

Backup Contents

Restore Impact

Security Considerations

Managing Configuration Backups Using the BUI

Create a Configuration Backup

Restore from a Saved Configuration

Delete a Saved Configuration

Export a Saved Configuration

Import a Saved Configuration

Managing Configuration Backups Using the CLI

Listing Configurations

Create a Configuration Backup

Restore from a Saved Configuration

Delete a Saved Configuration

Export a Saved Configuration

Import a Saved Configuration



Active Problems Display

Repairing problems

Related features







Phone Home


Viewing Logs

Exporting Logs


Listing Logs

Viewing a Log

Viewing All Log Entries

Viewing Groups of Log Entries

Viewing Entry Details

Exporting Logs

Maintenance Workflows

Using Workflows

Workflow Execution Context

Workflow Parameters

Constrained Parameters

Optional Parameters

Workflow Error Handling

Workflow Input Validation

Workflow Execution Auditing

Workflow Execution Reporting


Appliance Versioning

Workflow Versioning

Workflows as Alert Actions

Alert Action Execution Context

Auditing Alert Actions

Using Scheduled Workflows

Using the CLI

Coding the Schedule

Example: Device Type Selection



Downloading Workflows

Viewing Workflows

Executing Workflows

Updating via the CLI

Because you log into the appliance to use the CLI, the upload as described earlier is actually a download. To download the media onto the appliance via the CLI, execute the download command in maintenance system updates:

dory:maintenance system updates> download
dory:maintenance system updates download (uncommitted)> get
                          url = (unset)
                         user = (unset)
                     password = (unset)

You must set the "url" property to be a valid URL for the download. This may be either local to your network or over the internet. The URL can be either HTTP (beginning with "http://") or FTP (beginning with "ftp://"). If user authentication is required, it may be a part of the URL (for example, "ftp://myusername:mypasswd@myserver/export/foo"), or you may leave the username and password out of the URL and instead set the user and password properties.

dory:maintenance system updates download (uncommitted)> set url=
                          url = ftp://foo/update.pkg.gz
dory:maintenance system updates download (uncommitted)> set user=bmc
                         user = bmc
dory:maintenance system updates download (uncommitted)> set password
Enter password: 
                     password = ********
dory:maintenance system updates download (uncommitted)> commit
Transferred 157M of 484M (32.3%) ...      

Unpacking and Verifying Media

After the file has been transferred, it is automatically unpacked and verified:

dory:maintenance system updates download (uncommitted)> commit
Transferred 484M of 484M (100%) ... done 
Unpacking ... done
dory:maintenance system updates> list
UPDATE                           DATE                      STATUS
ak-nas@2009.10.14,1-0-nd         2009-10-14 08:45          AKUP_WAITING

Beginning an Upgrade

To begin an upgrade, select the update that constitutes the upgrade. During this process, an update health check is performed to verify that the appliance is ready to update.

Note -  If the update is no longer appropriate for the system (because you have skipped past its version number), an error message may be provided.

From this context, you can set any properties specific to the update, including applying deferred updates. For more information on the set of properties available for the particular update, run the help properties command. User-controllable properties begin with the update_ prefix:

clownfish:maintenance system updates ak-nas@2009.04.03,1-0> help properties
Properties that are valid in this context:

   version              => Update media version

   date                 => Update release date

   status               => Update media status

   update_zfs_upgrade   => Apply incompatible storage pool update

clownfish:maintenance system updates ak-nas@2009.04.03,1-0> get
                       version = 2009.04.03,1-0
                          date = 2009-4-3 08:45:01
                        status = AKUP_WAITING
            update_zfs_upgrade = deferred
clownfish:maintenance system updates ak-nas@2009.04.03,1-0> set update_zfs_upgrade=onreboot
            update_zfs_upgrade = onreboot
clownfish:maintenance system updates ak-nas@2009.04.03,1-0> 

After you set any properties, execute the upgrade command. You are prompted for confirmation and (assuming an affirmative) the upgrade begins:

dory:maintenance system updates> select ak-nas@2009.10.14,1-0-nd 
dory:maintenance system updates ak-nas@2009.10.14,1-0-nd> upgrade
The selected software update requires a system reboot in order to take effect.
The system will automatically reboot at the end of the update process. The
update will take several minutes. At any time during this process, you can
cancel the update with [Control-C].

Are you sure? (Y/N) y
Updating from ... ak/nas@2009.10.11,1-0
Backing up smf(5) ... done.
Loading media metadata ... done.
Selecting alternate product ... SUNW,iwashi
Installing Sun Storage 7120 2009.10.14,1-0
Creating system/boot/ak-nas-2009.10.14_1-0 ... done.
Creating system/root/ak-nas-2009.10.14_1-0 ... done.

As the upgrade proceeds, the latest message is printed. You can cancel the upgrade at any time by pressing ^C, at which point you are prompted for confirmation:

Updating from ... ak/nas@2009.10.11,1-0
Backing up smf(5) ... done.
Loading media metadata ... ^C
This will cancel the current update. Are you sure? (Y/N) y
error: interrupted by user
dory:maintenance system updates ak-nas@2009.10.14,1-0-nd>

Rolling Back

To roll back to an earlier version, select the update that corresponds to that version and execute the rollback command. You are asked to confirm that you wish to execute a rollback, and then the system reboots and executes the rollback. Unlike fail-safe rollback, you are not asked for further confirmation when the system reboots. For information on the fail-safe rollback, see Fail-safe Rollback.

Removing Update Media

To remove update media, use the destroy command, specifying the update to be removed:

dory:maintenance system updates> destroy ak-nas@2009.10.14,1-0-nd
This will destroy the update "ak-nas@2009.10.14,1-0-nd". Are you sure? (Y/N) y 
dory:maintenance system updates>

Applying Deferred Updates (CLI)

To see if there are any available deferred updates, run the show command. If deferred updates are available, you can use the apply command:

clownfish:maintenance system updates> show

UPDATE                                  DATE                      STATUS
ak-nas@2011.,1-       2012-6-24 17:14:19        current
ak-nas@2011.,1-1.28            2012-11-5 03:11:34        waiting
ak-nas@2013.,1-1.2             2013-6-19 12:58:18        unavailable

Waiting media is listed as unavailable if the currently active software is not sufficiently recent to be able to upgrade to that waiting media. In this example, media has been downloaded for both 2011.1.4.2 and 2013.1 but the 2013.1 upgrade is unavailable because you first need to upgrade to at least 2011.1.4.2.

Deferred updates:

The following incompatible updates are available. Applying these updates will
enable new software features as described below, but will prevent older
versions of the software from accessing the underlying resources. You should
apply deferred updates once you have verified that the current software update
is functioning and a rollback is not required. Applying deferred updates in a
cluster will also update any resources on the cluster peer.

1. Support for the "passthrough-x" aclinherit property for shares.
clownfish:maintenance system updates> apply
Applying deferred updates will prevent rolling back to previous versions of

Are you sure? (Y/N) 
clownfish:maintenance system updates> apply