System

Introduction

The Maintenance > System screen provides several system-level features. The screen allows the administrator to:

• View the status of the system disks

• Manage software updates and update the system software

• Create and restore appliance configuration backups

• Create and upload a support bundle

• Repeat the initial setup with existing settings

• Reset the system to the factory defaults

• View pending disk firmware updates

System Disks

The system disks section shows the status of the system disks, and their current usage. The BUI displays this with a pie-chart, and the CLI as a text list. For example:

tarpon:> maintenance system disks show
Properties:
                       profile = mirror
                          root = 1.14G
                           var = 52.4M
                        update = 2.52M
                         stash = 14.8M
                          dump = 16.0G
                         cores = 18K
                       unknown = 39.0G
                          free = 401G

Disks:

DISK        LABEL      STATE
disk-000    HDD 7      healthy
disk-001    HDD 6      healthy

Note: The "disk" column is not required by the GUI.

Support Bundles

The appliance can generate support bundles containing system configuration information and core files for use by remote support in debugging system failures. Support bundles are generated automatically in response to faults if the Phone Home service is enabled. Administrators can manually generate and upload a support bundle from this section of the Maintenance > System screen.

Once generated, support bundles are automatically uploaded to Sun's Support files Service at http://supportfiles.sun.com. To facilitate this, the appliance must be connected to the Internet, either directly or through the web proxy configured on the Phone Home service screen. If the upload fails, the system will make another attempt.

After a support bundle has been successfully uploaded, the support bundle and core files are automatically deleted from the system.

Managing Support Bundles Using the BUI

To generate a support bundle, click the icon next to Support Bundles on the Maintenance > System screen. You are presented with the randomly generated filename for the support bundle. Provide this filename to support personnel so that they can retrieve your support bundle.

For each support bundle currently being generated or uploaded or which has failed to upload, the following options may be available:

Icon Description Cancel the current operation. If the bundle is being generated, it will be deleted. If the bundle is being uploaded, the upload will be cancelled and the appliance will not retry it later. Download the support bundle. Try again to upload the bundle to support. Cancel any pending operation and delete the support bundle.

Managing Support Bundles Using the CLI

To generate and upload a new support bundle, use the sendbundle command:

loader:> maintenance system 
loader:maintenance system> sendbundle
A support bundle is being created and sent to Sun. You will receive an alert
when the bundle has finished uploading. Please save the following filename, as
Sun support personnel will need it in order to access the bundle:

   /cores/ak.9a4c3d7b-50c5-6eb9-c2a6-ec9808ae1cd8.tar.gz

As the message indicates, you must provide this filename to support personnel in order for them to retrieve your bundle.

Manage bundles from the maintenance system bundles context in the CLI, as follows:

loader:maintenance system> bundles
loader:maintenance system bundles> list
BUNDLE                                                  STATUS      PROGRESS
/cores/ak.9a4c3d7b-50c5-6eb9-c2a6-ec9808ae1cd8.tar.gz   Uploading      7%
loader:maintenance system bundles> 

Bundles are identified by the filename, omitting the ak. prefix and the file type suffix. To delete a support bundle, use the destroy command. To view details, use the select and list commands:

loader:maintenance system bundles> select 9a4c3d7b-50c5-6eb9-c2a6-ec9808ae1cd8 
loader:maintenance system bundles 9a4c3d7b-50c5-6eb9-c2a6-ec9808ae1cd8> list
Properties:
          filename = /cores/ak.9a4c3d7b-50c5-6eb9-c2a6-ec9808ae1cd8.tar.gz
          status = uploading
                step_progress = 14.709744730821669

These read-only properties indicate that the appliance is 14% of the way through uploading the file. To retry a failed upload or cancel a pending operation, enter the retry and cancel commands respectively.

Initial Setup

Initial setup will step through the tasks performed as part of the initial configuration. This will not change any of the current settings unless explicitly requested. User data on the storage pool (including projects and shares) will not be affected.

To perform an initial setup:

• BUI: click the "INITIAL SETUP" button on the Maintenance > System screen.

• CLI: enter the maintenance system context, then enter the setup command.

Factory Reset

Factory reset will reset the appliance configuration back to factory settings of the current software version, and reboot the appliance. All configuration changes will be lost, and the appliance will need to go through initial configuration again, as when it was first installed. User data on the storage pool (including projects and shares) will not be affected - however the pool will need to be imported as part of the initial setup process.

To perform a factory reset:

• BUI: click the "FACTORY RESET" button on the Maintenance > System screen.

• CLI: enter the maintenance system context, then issue the factoryreset command.

Note: Factory reset of a single controller while configured into a cluster is not supported. The controller must be unclustered first.