luactivate(1M) System Administration Commands luactivate(1M)NAMEluactivate - activate a boot environment
SYNOPSIS
/usr/sbin/luactivate [-l error_log] [-o outfile] [-s]
[BE_name] [-X]
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 specified, luactivate activates the
specified BE.
luactivate activates a BE by making the BE's root partition bootable.
On an x86 machine, this might require that you take steps following the
completion of luactivate. If so, luactivate displays the correct steps
to take.
To successfully activate a BE, that BE must meet the following condi‐
tions:
o The BE must have a status of "complete," as reported by lus‐
tatus(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 lucom‐
pare(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.
Note -
Before booting a new BE, you must run luactivate to specify that BE
as active. luactivate performs a number of tasks, described below,
that ensure correct operation of the BE. In some cases, a BE is not
bootable until after you have run the command.
The luactivate command performs the following tasks:
o 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.) Synchronize here means
that certain system files and directories are copied from
the last-active BE to the BE being booted. (See syn‐
clist(4).) Live Upgrade software does not perform this syn‐
chronization after a BE's initial boot, unless you use the
-s option, described below.
o If luactivate detects conflicts between files that are sub‐
ject to synchronization, it issues a warning and does not
perform the synchronization for those files. Activation can
complete successfully, in spite of such a conflict. A con‐
flict can occur if you upgrade one BE or another to a new
operating system version or if you modify system files (for
example, /etc/passwd) on one of the BEs.
o luactivate checks to see whether upgrade problems occurred.
For example, packages required for the correct operation of
the operating system might be missing. This package check is
done for the global zone as well as all non-global zones
inside of the BE. The command can issue a warning or, if a
BE is incomplete, can refuse activation.
o luactivate determines whether the bootstrap program requires
updating and takes steps to update if necessary. If a boot‐
strap program changed from on operating release to another,
an incorrect bootstrap program might render an upgraded BE
unbootable. See installboot(1M).
o luactivate modifies the root partition ID on a Solaris x86
disk to enable multiple BEs to reside on a single disk. In
this configuration, if you do not run luactivate, booting of
the BE will fail. See fmthard(1M) and dkio(7I).
The luactivate command requires root or equivalent 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 envi‐
ronment.
-o outfile All command output is sent to outfile, in addition to
where it is sent in your current environment.
-s Causes synchronization to occur (see DESCRIPTION) even
if next boot of a specified BE is not the first boot of
that BE. 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.
If using -s, take special care when booting to an ear‐
lier release of Solaris than what is installed on the
last-active BE. For example, consider that the last-
active BE contains Solaris 9 and you want to activate a
BE that contains Solaris 2.6. If you forced synchro‐
nization with the -s option, the BE containing Solaris
2.6 might be synchronized with files that, while com‐
patible with Solaris 9, might not work under Solaris
2.6.
-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 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
/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 │SUNWlu │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOlucancel(1M), lucompare(1M), lucreate(1M), lucurr(1M), ludelete(1M),
ludesc(1M), lufslist(1M), lumake(1M), lumount(1M), lurename(1M), lusta‐
tus(1M), luupgrade(1M), lutab(4), attributes(5), live_upgrade(5),
zones(5)NOTES
After entering init 6, if an activated BE fails to boot, consult
/var/svc/log/rc6.log on the current BE for possible obstacles.
SunOS 5.10 22 Nov 2006 luactivate(1M)