Maintenance Commands                               luactivate(1M)

NAME
     luactivate - activate a boot environment

SYNOPSIS
     /usr/sbin/luactivate [ -l error_log ]  [ -o outfile ]  [  -s
     ]  [ BE_name ]

DESCRIPTION
     The luactivate 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 luactivate command, with no arguments, displays the name
     of  the  boot  environment (BE) that will be active upon the
     next reboot of the system. When an argument (a BE) is speci-
     fied, luactivate activates the specified BE.

     luactivate activates a BE by making the BE's root  partition
     bootable. On an IA machine, this might require that you take
     steps following the completion of luactivate. If  so,  luac-
     tivate displays the correct steps to take.

     To successfully activate a BE, that BE must meet the follow-
     ing conditions:

        o  The BE must have a status of "complete,"  as  reported
           by lustatus(1M).

        o  If the BE is not  the  current  BE,  you  cannot  have
           mounted  the  partitions of that BE (using lumount(1M)
           or mount(1M)).

        o  The BE you want to activate cannot be involved  in  an
           lucompare(1M) operation.

     After activating a specified  BE,  luactivate  displays  the
     steps to be taken for fallback in case of any problem on the
     next reboot. Make note of these instructions and follow them
     exactly, if necessary.

     The luactivate command requires root privileges.

OPTIONS
     The luactivate 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

SunOS 5.8           Last change: 22 Oct 2001                    1

Maintenance Commands                               luactivate(1M)

           All command output is sent to outfile, in addition  to
           where it is sent in your current environment.

     -s    Forced synchronization. The first time you boot from a
           newly  created  BE, Live Upgrade software synchronizes
           this BE with the BE that was last active. (This is not
           necessarily  the  BE that was the source for the newly
           created BE.) It does not perform this  synchronization
           after  this  initial boot, unless you use this option.
           Use this option with great caution, because you  might
           not  be aware or in control of changes that might have
           occurred in the last active BE.

OPERANDS
     BE_name
           Name of the BE to be activated.

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),    lucancel(1M),    lucompare(1M),     lucreate(1M),
     lucurr(1M),    ludelete(1M),    lufslist(1M),    lumake(1M),
     lumount(1M),  lurename(1M),   lustatus(1M),   luupgrade(1M),
     lutab(4), attributes(5), live_upgrade(5)

SunOS 5.8           Last change: 22 Oct 2001                    2