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 IA 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 conditions:
- The BE must have a status of "complete," as reported by lustatus(1M).
- If the BE is not the current BE, you cannot have mounted the partitions of that BE (using lumount(1M) or mount(1M)).
- 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 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. Live Upgrade software does not perform this synchronization after a BE's initial boot, unless you use the -s option, described below.
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.
The luactivate command requires root privileges.