lu(1M) System Administration Commands lu(1M)NAMElu - FMLI-based interface to Live Upgrade functions
SYNOPSIS
/usr/sbin/lu
DESCRIPTION
Sun no longer recommends use of the lu command. The lu command dis‐
plays a character user interface (CUI). The underlying command
sequence for the CUI--typically lucreate, luupgrade, and luactivate--is
straightforward to use. The SEE ALSO section below highlights the full
Solaris Live Upgrade command set.
The lu program 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 lu program is a Forms and Menu Language Interpreter-based user
interface. (See fmli(1) for a description of the Forms and Menu Lan‐
guage Interpreter.) lu enables you to create and upgrade boot environ‐
ments (BEs) and perform other administrative tasks on BEs. The lu pro‐
gram performs a subset of the functions provided by the Live Upgrade
command-line utilities.
Users of lu should be aware of the following:
o lu is a deprecated interface. It will be replaced in the
future and should not be depended on for critical function‐
ality.
o All new Live Upgrade features are being implemented in the
Live Upgrade command-line utilities. No new features are
being made available in lu.
o The lu command is not internationalized. It will not be
internationalized in a future release.
lu should be used for learning or experimenting only. For any produc‐
tion use or to use the full capabilities of Live Upgrade, use the Live
Upgrade command-line utilities.
Invocation of the lu command requires root privileges.
The lu command accepts no arguments. After invoking lu, you receive a
display with the following options:
Activate Activate a boot environment. This option designates that
the system boot from the specified BE upon next reboot.
This option is equivalent to the command-line luacti‐
vate(1M) utility.
Cancel Cancel a copy job. Live Upgrade allows you to schedule the
copy, upgrade, and flash functions (all described below) at
a later time. The cancel function enables you to cancel a
scheduled job. This function is equivalent to the command-
line lucancel(1M) utility.
Compare Compare the contents of BEs. Enables you to obtain a
detailed comparison of two BEs. Equivalent to the command-
line lucompare(1M) utility.
Copy Start/schedule a copy. Copies the contents of one BE to
another. Equivalent of the command-line lumake(1M) utility.
At any time, you can have only one Live Upgrade operation
scheduled.
Create Create a boot environment. Implements a subset of the func‐
tions performed by the command-line lucreate(1M) utility.
Current Display the name of the current boot environment. Equiva‐
lent of the command-line lucurr(1M) utility.
Delete Delete a boot environment. Equivalent of the command-line
ludelete(1M) utility.
List List the file systems of a boot environment. Equivalent of
the command-line lufslist(1M) utility.
Rename Change the name of a boot environment. Equivalent of the
command-line lurename(1M) utility.
Status List the status of all boot environments. Equivalent of the
command-line lustatus(1M) utility.
Upgrade Upgrade a boot environment or upgrade the OS on an inactive
BE. This option enables you to upgrade to a new operating
system or install new packages or patches on a specified
BE. Implements a subset of the functions performed by the
command-line luupgrade(1M) utility. Note that if you are
performing an upgrade that requires more than one CD, you
must use the -i option of luupgrade.
Flash Flash a boot environment. This option enables you to
install an operating system on a BE from a flash archive.
You can perform the same function with luupgrade(1M).
Help Displays help information. There are also context-specific
help screens for many of the options.
Exit Exit lu.
Navigation
You navigate through lu's various screens using arrow keys and function
keys (usually F2 through F9 on the keyboard of a Sun desktop system).
Available key functions are displayed at the base of the lu screen. You
can use Ctrl-F, plus a number key, to duplicate a function key. For
example, press Ctrl-F and the number key 2 to duplicate the F2 key.
In a screen for a given option, you can press Esc to obtain context-
specific help.
Display Issues
When viewing the FMLI interface remotely, such as over a tip line, you
might need to set the TERM environment variable to VT220. When using
the FMLI interface in a CDE environment use dtterm, rather than xterm,
as the value of the TERM variable.
The lu command supports only single-byte environments.
Common Functions
Most of the options listed above offer the following functions. These
functions are accessible through function keys indicated at the base of
the screen.
Choice Available to you whenever you have a field that can be filled
in. Pressing the Choice function key gives you a popup screen
displaying a list of alternatives. For example, for options
involving copying or upgrading BEs, you receive a list of
available BEs. You can then use arrow and function keys to
make a selection from this popup. The choice function is use‐
ful because it prevents you from selecting an invalid alter‐
native. In our example, it prevents you from choosing a BE
that is not available for a copy or upgrade operation. Such
non-availability might occur when a BE is in the midst of an
upgrade.
Cancel Cancel an operation.
Save Proceed with an operation.
Other Functions
The "Create" option, described above, offers the following functions:
Split Split a file system. For example, you can split a / file sys‐
tem into /, /usr, and /var. To split a file system, you must
have disk slices available on which to mount the separated
file system(s). If you do not, lu invokes the format(1M) util‐
ity, in which you can use the partition option to create a new
disk slice.
Merge Join one or more file systems with its (or their) parent file
system. For example, using a source BE that has separate /,
/usr, and /var file systems, you can merge these file systems
under / on a target BE.
FILES
/etc/lutab list of BEs on the system
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWluu │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOluactivate(1M), lucancel(1M), lucompare(1M), lucreate(1M), lucurr(1M),
ludelete(1M), ludesc(1M), lufslist(1M), lumake(1M), lumount(1M), lure‐
name(1M), lustatus(1M), luupgrade(1M), lutab(4), attributes(5),
live_upgrade(5)
Solaris Installation Guide
WARNINGS
The lu command is a deprecated interface. See DESCRIPTION.
SunOS 5.10 14 Mar 2007 lu(1M)
