Print this page
2594 implement graceful shutdown for local zones in zoneadm
   1 '\" te

   2 .\" Copyright (c) 2009 Sun Microsystems, Inc. All Rights Reserved.
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH ZONEADM 1M "Feb 13, 2009"
   7 .SH NAME
   8 zoneadm \- administer zones
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBzoneadm\fR \fB-z\fR \fIzonename\fR [\fB-u\fR \fIuuid-match\fR] \fIsubcommand\fR
  13      [\fIsubcommand_options\fR]
  14 .fi
  15 
  16 .LP
  17 .nf
  18 \fBzoneadm\fR [\fB-R\fR \fIroot\fR] [\fB-z\fR \fIzonename\fR] [\fB-u\fR \fIuuid-match\fR] list
  19      [\fIlist_options\fR]
  20 .fi
  21 
  22 .LP
  23 .nf
  24 \fBzoneadm\fR [\fB-R\fR \fIroot\fR] \fB-z\fR \fIzonename\fR [\fB-u\fR \fIuuid-match\fR] mark incomplete
  25 .fi
  26 


 240 .sp
 241 .in +2
 242 .nf
 243 # zoneadm -z my-zone detach
 244 .fi
 245 .in -2
 246 .sp
 247 
 248 The source zone must be halted before this subcommand can be used.
 249 .RE
 250 
 251 .sp
 252 .ne 2
 253 .na
 254 \fB\fBhalt\fR\fR
 255 .ad
 256 .sp .6
 257 .RS 4n
 258 Halt the specified zones. \fBhalt\fR bypasses running the shutdown scripts
 259 inside the zone. It also removes run time resources of the zone.
 260 .sp
 261 Use:
 262 .sp
 263 .in +2
 264 .nf
 265 zlogin \fIzone\fR shutdown
 266 .fi
 267 .in -2
 268 .sp
 269 
 270 to cleanly shutdown the zone by running the shutdown scripts.
 271 .RE
 272 
 273 .sp
 274 .ne 2
 275 .na
 276 \fB\fBhelp\fR [\fIsubcommand\fR]\fR
 277 .ad
 278 .sp .6
 279 .RS 4n
 280 Display general help. If you specify \fIsubcommand\fR, displays help on
 281 \fIsubcommand\fR.
 282 .RE
 283 
 284 .sp
 285 .ne 2
 286 .na
 287 \fB\fBinstall\fR [\fB-x\fR \fInodataset\fR] [\fIbrand-specific options\fR]\fR
 288 .ad
 289 .sp .6
 290 .RS 4n


 411 .RS 4n
 412 Move the \fIzonepath\fR to \fInew_zonepath\fR. The zone must be halted before
 413 this subcommand can be used. The \fInew_zonepath\fR must be a local file system
 414 and normal restrictions for \fIzonepath\fR apply.
 415 .RE
 416 
 417 .sp
 418 .ne 2
 419 .na
 420 \fB\fBready\fR\fR
 421 .ad
 422 .sp .6
 423 .RS 4n
 424 Prepares a zone for running applications but does not start any user processes
 425 in the zone.
 426 .RE
 427 
 428 .sp
 429 .ne 2
 430 .na
 431 \fB\fBreboot\fR\fR
 432 .ad
 433 .sp .6
 434 .RS 4n
 435 Restart the zones. This is equivalent to a \fBhalt\fR \fBboot\fR sequence. This
 436 subcommand fails if the specified zones are not active.

 437 .RE
 438 













 439 .sp
 440 .ne 2
 441 .na
 442 \fB\fBuninstall [\fR\fB-F\fR\fB]\fR\fR
 443 .ad
 444 .sp .6
 445 .RS 4n
 446 Uninstall the specified zone from the system. Use this subcommand with caution.
 447 It removes all of the files under the \fIzonepath\fR of the zone in question.
 448 You can use the \fB-F\fR flag to force the action.
 449 .RE
 450 
 451 .sp
 452 .ne 2
 453 .na
 454 \fB\fBverify\fR\fR
 455 .ad
 456 .sp .6
 457 .RS 4n
 458 Check to make sure the configuration of the specified zone can safely be


   1 '\" te
   2 .\" Copyright 2014 Nexenta Systems, Inc. All rights reserved.
   3 .\" Copyright (c) 2009 Sun Microsystems, Inc. All Rights Reserved.
   4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   5 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   6 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   7 .TH ZONEADM 1M "Oct 30, 2013"
   8 .SH NAME
   9 zoneadm \- administer zones
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fBzoneadm\fR \fB-z\fR \fIzonename\fR [\fB-u\fR \fIuuid-match\fR] \fIsubcommand\fR
  14      [\fIsubcommand_options\fR]
  15 .fi
  16 
  17 .LP
  18 .nf
  19 \fBzoneadm\fR [\fB-R\fR \fIroot\fR] [\fB-z\fR \fIzonename\fR] [\fB-u\fR \fIuuid-match\fR] list
  20      [\fIlist_options\fR]
  21 .fi
  22 
  23 .LP
  24 .nf
  25 \fBzoneadm\fR [\fB-R\fR \fIroot\fR] \fB-z\fR \fIzonename\fR [\fB-u\fR \fIuuid-match\fR] mark incomplete
  26 .fi
  27 


 241 .sp
 242 .in +2
 243 .nf
 244 # zoneadm -z my-zone detach
 245 .fi
 246 .in -2
 247 .sp
 248 
 249 The source zone must be halted before this subcommand can be used.
 250 .RE
 251 
 252 .sp
 253 .ne 2
 254 .na
 255 \fB\fBhalt\fR\fR
 256 .ad
 257 .sp .6
 258 .RS 4n
 259 Halt the specified zones. \fBhalt\fR bypasses running the shutdown scripts
 260 inside the zone. It also removes run time resources of the zone.











 261 .RE
 262 
 263 .sp
 264 .ne 2
 265 .na
 266 \fB\fBhelp\fR [\fIsubcommand\fR]\fR
 267 .ad
 268 .sp .6
 269 .RS 4n
 270 Display general help. If you specify \fIsubcommand\fR, displays help on
 271 \fIsubcommand\fR.
 272 .RE
 273 
 274 .sp
 275 .ne 2
 276 .na
 277 \fB\fBinstall\fR [\fB-x\fR \fInodataset\fR] [\fIbrand-specific options\fR]\fR
 278 .ad
 279 .sp .6
 280 .RS 4n


 401 .RS 4n
 402 Move the \fIzonepath\fR to \fInew_zonepath\fR. The zone must be halted before
 403 this subcommand can be used. The \fInew_zonepath\fR must be a local file system
 404 and normal restrictions for \fIzonepath\fR apply.
 405 .RE
 406 
 407 .sp
 408 .ne 2
 409 .na
 410 \fB\fBready\fR\fR
 411 .ad
 412 .sp .6
 413 .RS 4n
 414 Prepares a zone for running applications but does not start any user processes
 415 in the zone.
 416 .RE
 417 
 418 .sp
 419 .ne 2
 420 .na
 421 \fB\fBreboot\fR\ [\fB--\fR \fIboot_options\fR]]\fR
 422 .ad
 423 .sp .6
 424 .RS 4n
 425 Restart the zones. This is equivalent to a \fBhalt\fR \fBboot\fR sequence. This
 426 subcommand fails if the specified zones are not active. See \fIboot\fR subcommand
 427 for the boot options.
 428 .RE
 429 
 430 .sp
 431 .ne 2
 432 .na
 433 \fB\fBshutdown\fR [\fB-r\fR [\fB--\fR \fIboot_options\fR]]\fR
 434 .ad
 435 .sp .6
 436 .RS 4n
 437 Gracefully shutdown the specified zone. This subcommand waits for all zone
 438 processes to finish; the default timeout is SCF_PROPERTY_TIMEOUT value from
 439 the SMF service system/zones. If the \fB-r\fR option is specified, reboot the
 440 zone. See \fIboot\fR subcommand for the boot options.
 441 .RE
 442 
 443 .sp
 444 .ne 2
 445 .na
 446 \fB\fBuninstall [\fR\fB-F\fR\fB]\fR\fR
 447 .ad
 448 .sp .6
 449 .RS 4n
 450 Uninstall the specified zone from the system. Use this subcommand with caution.
 451 It removes all of the files under the \fIzonepath\fR of the zone in question.
 452 You can use the \fB-F\fR flag to force the action.
 453 .RE
 454 
 455 .sp
 456 .ne 2
 457 .na
 458 \fB\fBverify\fR\fR
 459 .ad
 460 .sp .6
 461 .RS 4n
 462 Check to make sure the configuration of the specified zone can safely be