| |
| System Administration Commands | lu(1M) |
| | lu - FMLI-based interface to Live Upgrade functions |
SYNOPSIS
| |
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 Language
Interpreter.) lu enables you to create and upgrade boot environments (BEs) and perform other administrative tasks on BEs. The lu program performs a subset of the functions provided by the Live Upgrade command-line utilities.
The output of the lu command is not internationalizable. The command and its FMLI-based interface is subject to change in a future release.
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 luactivate(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 functions performed by the command-line lucreate(1M) utility.
- Current
- Display the name of the current boot environment. Equivalent 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.
- 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 useful because it prevents you from selecting an invalid alternative. 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 system 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) utility, 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.
|
|
| |
-
/etc/lutab
- list of BEs on the system
|
| |
See attributes(5) for descriptions of the following attributes:
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| Availability | SUNWluu |
|
| |
luactivate(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)
Solaris Installation Guide
|
| |
