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
Library
PDF
Print View
Feedback
search filter icon
search icon

Document Information

Using This Documentation

Chapter 1 Introduction

Chapter 2 Hardware Maintenance

Chapter 3 System Maintenance

System

Introduction

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

Updates

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

Preconditions

Update Health Checks

BUI

CLI

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

Rollback

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

COMSTAR Deferred Update

Triple Parity RAID

Triple-Parity RAID Deferred Update

Dedup

Data Deduplication Deferred Update

Replication

Replication Deferred Update

Received Properties

Received Properties Deferred Update

Slim ZIL

Introduction

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

Introduction

Multiple Initiator Groups per LUN

Introduction

Support for Large Block Sizes

Support for Large Block Sizes

Sequential Resilvering

Sequential Resilvering

ConfigurationBackup

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

Problems

Problems

Active Problems Display

Repairing problems

Related features

Logs

Logs

Alerts

Faults

System

Audit

Phone Home

BUI

Viewing Logs

Exporting Logs

CLI

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

Versioning

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

BUI

CLI

Downloading Workflows

Viewing Workflows

Executing Workflows

Configuration Backup

The configuration backup function enables the administrator to:

Backup Contents

A configuration backup does include:


Note -  In a cluster configuration, configuration backups are visible only on the node on which they were created or imported.

A configuration backup does not include:

Restore Impact

The restore operation takes a selected configuration backup, and modifies all of the corresponding system settings to reflect those in the backup, including removing aspects of the configuration that were not present at the time of the backup. Administrators should adhere to the following guidelines when planning a restore:

Security Considerations

A configuration backup contains information that is normally only accessible to the root administrative user on the appliance. Therefore, any configuration backup that is exported to another system or into a filesystem share must apply security restrictions to the backup file to ensure that unauthorized users cannot read the backup file.

Local user passwords are stored in the backup file in encrypted (hashed) format, not as clear text. However, on the system, access to these password hashes is restricted, as they could be used as input to dictionary attacks. Therefore, administrators must carefully protect configuration backups that are exported, either by restricting file access to the backup, or by applying an additional layer of encryption to the entire backup file, or both.

Directory user passwords are not stored in the appliance, and therefore are not stored in the configuration backup. If you have deployed a directory service such as LDAP or AD for administrative user access, there are no copies of directory service password hashes for directory users stored in the configuration backup. Only the user name, user ID, preferences, and authorization settings for directory users are stored in the backup and then restored.

Following a configuration restore, the local root administrative user password is not modified to the root password at the time of the backup. The root password is left as-is, unmodified, by the restore process, to ensure that the password used by the administrator who is executing the restore process (and thus has logged in, using that password) is retained. If the administrator's intent was to also change the root password at the time of configuration restore, that step must be executed manually following the restore, using the normal administrative password change procedure.

Managing Configuration Backups Using the BUI

The following section outlines how various Configuration Backup tasks can be accomplished using the Configuration Backup area near the bottom of the Maintenance > System screen in the BUI.

Create a Configuration Backup

To create a backup, simply click the Backup button above the list of saved configurations and follow the instructions. You are prompted to enter a descriptive comment for the backup.

Restore from a Saved Configuration

Click the rollback icon image: on any saved configuration to begin the process of reverting the system to that saved configuration. Review the Restore Impact guidance above, and confirm that it is ok to proceed.

Delete a Saved Configuration

To delete a Saved Configuration simply click the trash icon image: to delete the configuration that is no longer required.

Export a Saved Configuration

To export a Saved Configuration, mouse over the configuration list entry you wish to export and click the download icon image: . Your browser prompts you to save the file locally. The file is a compressed archive whose contents are versioned and may vary over time. You should not attempt to unpack or modify the content of the archive, and doing so renders it unable to be imported back to the appliance successfully.

Import a Saved Configuration

To import a previously exported Saved Configuration, click the add icon image: at the top of the saved configurations list and then use your web browser's file selection dialog to locate the previously exported configuration. You should upload the single, compressed archive file previously saved using the export function.

Managing Configuration Backups Using the CLI

The following section outlines how various Configuration Backup tasks can be accomplished using the CLI in the maintenance system configs context.

Listing Configurations
host:maintenance system configs> list
CONFIG                               DATE                SYSTEM   VERSION
bfa614d7-1db5-655b-cba5-bd0bb0a1efc4 2009-8-5 17:14:28   host      2009.08.04,1-0
cb2f005f-cf2b-608f-90db-fc7a0503db2a 2009-8-24 17:56:53  host      2009.08.18,1-0
Create a Configuration Backup

The backup command saves a configuration backup. You are prompted to enter a descriptive comment for the backup. Then enter done to execute the backup operation.

host:maintenance system configs> backup
Backup Configuration. Enter a descriptive comment for this configuration, and
click Commit to backup current appliance settings:
host:maintenance system configs conf_backup step0> set comment="pre-upgrade"
                      comment = pre-upgrade
host:maintenance system configs conf_backup step0> done
host:maintenance system configs> 
Restore from a Saved Configuration

The restore command reverts the system to a saved configuration. You are prompted to enter the universal unique identifier for the backup (see the output of list, above). Then enter done to execute the restore. Review the Restore Impact guidance above, and confirm that it is ok to proceed.

host:maintenance system configs> restore
Restore. Select the configuration to restore:
host:maintenance system configs conf_restore step0> 
    set uuid=36756f96-b204-4911-8ed5-fefaf89cad6a 
                         uuid = 36756f96-b204-4911-8ed5-fefaf89cad6a
host:maintenance system configs conf_restore step0> done

Note -  Storage pools are not automatically unconfigured when you execute the restore command.
Delete a Saved Configuration

The destroy command deletes a saved configuration:

host:maintenance system configs> destroy cb2f005f-cf2b-608f-90db-fc7a0503db2a
Are you sure you want to delete the saved configuration "new"? y
host:maintenance system configs> 
Export a Saved Configuration

The export command exports a saved configuration, by means of executing an HTTP or FTP PUT operation against a remote HTTP or FTP server. You can also use the export function to export the file to a share on the appliance itself, that has the HTTP or FTP protocol enabled for writing. You can enter a username and password for authentication to the remote server if one is required.

Import a Saved Configuration

The import command imports a saved configuration, by means of executing an HTTP or FTP GET operation against a remote HTTP or FTP server. You can also use the import function to import a configuration stored in a share on the appliance itself, that has the HTTP or FTP protocol enabled for reading. You can enter a username and password for authentication to the remote server if one is required.