manpages.info - online man pages   

SunOS man pages : luactivate (1)

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