man pages section 1M: System Administration Commands

lustatus(1M)

Name

lustatus– display status of boot environments

Synopsis

/usr/sbin/lustatus [-l error_log] [-o outfile] [BE_name] 
     [-X]

Description

The lustatus command is part of a suite of commands that make up the Live Upgrade feature of the Solaris operating environment. See live_upgrade(5) for a description of the Live Upgrade feature.

The lustatus command displays the status information of the boot environment (BE) BE_name. If no BE is specified, the status information for all BEs on the system is displayed.

The headings in the lustatus information display are described as follows:

Boot Environment Name: Name of the BE.
Is Complete: Indicates whether a BE is able to be booted. Any current activity or failure in an lucreate(1M) or luupgrade(1M) operation causes a BE to be incomplete. For example, if there is a copy operation proceeding on or scheduled for a BE, that BE is considered incomplete.
Active Now: Indicates whether the BE is currently active. The “active” BE is the one currently booted.
Active On Reboot: Indicates whether the BE becomes active upon next reboot of the system.
Can Delete: Indicates that no copy, compare, or upgrade operations are being performed on a BE. Also, none of that BE's file systems are currently mounted. With all of these conditions in place, the BE can be deleted.
Copy Status: Indicates whether the creation or repopulation of a BE is scheduled or active (that is, in progress). A status of ACTIVE, COMPARING (from lucompare(1M)), UPGRADING, or SCHEDULED prevents you performing Live Upgrade copy, rename, or upgrade operations.

The following is an example lustatus display:

Boot Environment     Is       Active Active    Can    Copy      
Name                 Complete Now    On Reboot Delete Status    
-------------------- -------- ------ --------- ------ ----------
disk_a_S7            yes      yes    yes       no     -
disk_b_S7db          yes      no     no        no     UPGRADING
disk_b_S8            no       no     no        no     -
S9testbed            yes      no     no        yes    -

Note that you could not perform copy, rename, or upgrade operations on disk_b_S8, because it is not complete, nor on disk_b_S7db, because a Live Upgrade operation is pending.

The lustatus command requires root privileges.

Options

The lustatus command has the following options:

-l error_log: Error and status messages are sent to error_log, in addition to where they are sent in your current environment.
-o outfile: All command output is sent to outfile, in addition to where it is sent in your current environment.
-X: Enable XML output. Characteristics of XML are defined in DTD, in /usr/share/lib/xml/dtd/lu_cli.dtd.<num>, where <num> is the version number of the DTD file.

Operands

BE_name: Name of the BE for which to obtain status. If BE_name is omitted, lustatus displays status for all BEs in the system.

Exit Status

The following exit values are returned:

0: Successful completion.
>0: An error occurred.

Files

/etc/lutab: list of BEs on the system
/usr/share/lib/xml/dtd/lu_cli.dtd.<num>: Live Upgrade DTD (see -X option)

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWluu