lustatus

 

---

 
 
 
 Maintenance Commands                                 lustatus(1M)
 
 
 


NAME
      lustatus - display status of boot environments
 


SYNOPSIS
      lustatus [ -l error_log ]  [ -o outfile ]  [ BE_name ]
 


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:
 
      BE_name
            Name of the BE.
 
      Complete
            Indicates whether a BE  is  able  to  be  booted.  Any
            current  activity  or  failure  in  an  lucreate()  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 incom-
            plete.
 
      Active
            Indicates whether the  BE  is  currently  active.  The
            "active" BE is the one currently booted.
 
      ActiveOnReboot
            Indicates whether the  BE  becomes  active  upon  next
            reboot of the system.
 
      CopyStatus
            Indicates whether the creation or repopulation of a BE
            is  scheduled  or  active  (that  is,  in progress). A
            status of SCHEDULED or COMPARING (from  lucompare(1M))
            prevents  you performing Live Upgrade copy, rename, or
            upgrade operations.
 
      The following is an example lustatus display:
 
      BE_name             Complete  Active  ActiveOnReboot  CopyStatus
      ------------------------------------------------------------------------
      disk_a_S7            yes       yes     yes              -
      disk_b_S7database    yes       no      no              SCHEDULED
      disk_b_S8            no        no      no               -
 
 
 
 SunOS 5.8           Last change: 22 Oct 2001                    1
 
 
 
 
 
 
 Maintenance Commands                                 lustatus(1M)
 
 
 
      Note that you could not perform  copy,  rename,  or  upgrade
      operations  on disk_b_S8, because it is not complete, nor on
      disk_b_S7database, because a Live Upgrade operation is pend-
      ing.
 
      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.
 


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
 


ATTRIBUTES
      See attributes(5) for descriptions of the  following  attri-
      butes:
 
      ____________________________________________________________
     |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
     |_____________________________|_____________________________|
     | Availability                | SUNWluu                     |
     |_____________________________|_____________________________|
 
 


SEE ALSO
      lu(1M),   luactivate(1M),    lucancel(1M),    lucompare(1M),
      lucreate(1M),    lucurr(1M),   ludelete(1M),   lufslist(1M),
      lumake(1M),   lumount(1M),   lurename(1M),    luupgrade(1M),
      lutab(4), attributes(5), live_upgrade(5)
 
 
 
 SunOS 5.8           Last change: 22 Oct 2001                    2
 
 
 

---