About Halting, Rebooting, and Uninstalling Zones
This section provides an overview of the procedures for halting, rebooting, uninstalling, and
Halting a Zone
The zoneadm halt command is used to remove both the application environment and
the virtual platform for a zone. The zone is then brought back to
the installed state. All processes are killed, devices are unconfigured, network interfaces are
destroyed, file systems are unmounted, and the kernel data structures are destroyed.
The halt command does not run any shutdown scripts within the zone. To
shut down a zone, see How to Use zlogin to Shut Down a Zone.
If the halt operation fails, see Zone Does Not Halt.
Rebooting a Zone
The zoneadm reboot command is used to reboot a zone. The zone is
halted and then booted again. The zone ID will change when the
zone is rebooted.
Zone Boot Arguments
Zones support the following boot arguments used with the zoneadm boot and
The following definitions apply:
- -i altinit
Selects an alternative executable to be the first process. altinit must be a valid path to an executable. The default first process is described in init(1M).
- -m smf_options
Controls the boot behavior of SMF. There are two categories of options, recovery options and messages options. Message options determine the type and number of messages that displays during boot. Service options determine the services that are used to boot the system.
Recovery options include the following:
Prints standard per-service output and all svc.startd messages to log.
Boot to the subgraph defined by the given milestone. Legitimate milestones are none, single-user, multi-user, multi-user-server, and all.
Message options include the following:
Prints standard per-service output and error messages requiring administrative intervention
Prints standard per-service output and messages providing more information.
Boots only to milestone svc:/milestone/single-user:default. This milestone is equivalent to init level s.
For usage examples, see How to Boot a Zone and How to Boot a Zone in Single-User Mode.
For information on the Solaris service management facility (SMF) and init ,
see Chapter 15, Managing Services (Overview), in System Administration Guide: Basic Administration, svc.startd(1M) and init(1M).
If you set the autoboot resource property in a zone's configuration to true,
that zone is automatically booted when the global zone is booted. The default
setting is false.
Note that for zones to autoboot, the zones service svc:/system/zones:default must also
Uninstalling a Zone
The zoneadm uninstall command is used to uninstall all of the files under
the zone's root file system. Before proceeding, the command prompts you to confirm
the action, unless the -F (force) option is also used. Use the uninstall
command with caution, because the action is irreversible.