Home | History | Annotate | Download | only in man1m
 te
 CDDL HEADER START

 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.

 You can obtain a copy of the license at CDDL.txt
 or http://www.opensolaris.org/os/licensing.
 See the License for the specific language governing permissions
 and limitations under the License.

 When distributing Covered Code, include this CDDL HEADER in each
 file and include the License file at CDDL.txt.
 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]

 CDDL HEADER END
 Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.
 scshutdown 1M "10 Apr 2006" "Sun Cluster 3.2" "System Administration Commands"
 NAME
scshutdown - shut down a cluster 

 SYNOPSIS


scshutdown [-y] [-g grace-period] [message]




 DESCRIPTION

Note - 


Beginning with the Sun Cluster 3.2 release, Sun Cluster software includes an object-oriented command set. Although Sun Cluster software still supports the original command set, Sun Cluster procedural documentation uses only the object-oriented command set. For more information about the object-oriented command set, see the Intro(1CL) man page.




The scshutdown utility shuts down an entire cluster in an orderly fashion.


Before starting the shutdown, scshutdown sends a warning message, then a final message asking for confirmation.


Only run the scshutdown command from one node.


The scshutdown command performs the following actions when it shuts down a cluster:




Changes all functioning resource groups on the cluster to an offline state. If any transitions fail, scshutdown does not complete and displays an error message.






Unmounts all cluster file systems. If any unmounts fail, scshutdown does not complete and displays an error message.






Shuts down all active device services. If any transition of a device fails, scshutdown does not complete and displays an error message.






Runs /usr/sbin/init 0 on all nodes. See init(1M) for more information.




You can use this command only in the global zone.


You need solaris.cluster.system.admin RBAC authorization to use this command. See rbac(5).

 OPTIONS

The following options are supported:


.na
-g grace-period 
.ad


Changes the number of seconds from the 60-second default to the time specified by grace-period.





.na
-y 
.ad


Pre-answers the confirmation question so the command can be run without user intervention.




 OPERANDS

The following operands are supported: 


.na
message 
.ad


Is a string that is issued after the standard warning message The system will be shut down in .\|.\|. is issued. If message contains more than one word, delimit it with single (') or double (")
quotation marks. The warning message and the user-provided message are output when there are 7200, 3600, 1800, 1200, 600, 300, 120, 60, and 30 seconds remaining before scshutdown begins.




 EXAMPLES

Example 1 Shutting Down a Cluster

phys-palindrome-1# scshutdown




 EXIT STATUS

The following exit values are returned:


.na
0
.ad


The command completed successfully.





.na
nonzero
.ad


An error occurred. Error messages are displayed on the standard output.




 ATTRIBUTES

See attributes(5) for descriptions of the following attributes:







ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWsczu
Interface StabilityEvolving



 SEE ALSO

Intro(1CL), cluster(1CL), shutdown(1M), init(1M), attributes(5)