|
Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!
System Administration Commands luactivate(1M)
NAME
luactivate - 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 speci-
fied, 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 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.
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
SunOS 5.10 Last change: 20 Nov 2003 1
System Administration Commands luactivate(1M)
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 synclist(4).) Live Upgrade software does
not perform this synchronization after a BE's initial
boot, unless you use the -s option, described below.
o If luactivate detects conflicts between files that are
subject 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 conflict 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. 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 neces-
sary. If a bootstrap 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 luac-
tivate, booting of the BE will fail. See fmthard(1M)
and dkio(7I).
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 environ-
ment.
SunOS 5.10 Last change: 20 Nov 2003 2
System Administration Commands luactivate(1M)
-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 synchroniza-
tion with the -s option, the BE containing Solaris 2.6
might be synchronized with files that, while compatible
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.
SunOS 5.10 Last change: 20 Nov 2003 3
System Administration Commands luactivate(1M)
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 attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWluu |
|_____________________________|_____________________________|
SEE ALSO
lu(1M), lucancel(1M), lucompare(1M), lucreate(1M),
lucurr(1M), ludelete(1M), ludesc(1M), lufslist(1M),
lumake(1M), lumount(1M), lurename(1M), lustatus(1M),
luupgrade(1M), lutab(4), attributes(5), live_upgrade(5)
SunOS 5.10 Last change: 20 Nov 2003 4
Man(1) output converted with
man2html and wrapped by fishsponge
This page was generated on Wed Sep 12 11:26:11 GMT 2007
|
Your favourite pages:
No pages logged yet. Trying to save cookie... Top 10 most popular pages:
sqlite3 man page (5334 hits) (openSUSE 10.2)
svn man page (5209 hits) (FreeBSD 6.2)
adv_cap_autoneg man page (4870 hits) (Solaris 10 11_06)
CPAN man page (4607 hits) (Suse Linux 10.1)
ssh man page (4342 hits) (Suse Linux 10.1)
ssh-socks5-proxy-connect man page (2884 hits) (Solaris 10 11_06)
netcat man page (2717 hits) (Suse Linux 10.1)
pprosetup man page (2492 hits) (Solaris 10 11_06)
startproc man page (2471 hits) (Suse Linux 10.1)
signal man page (2408 hits) (Suse Linux 10.1)
|