How to Shut Down a Cluster

Language:

You can shut down a global cluster, a zone cluster, or all zone clusters.

Caution - Do not use send brk on a cluster console to shut down a global-cluster node or a zone-cluster node. The command is not supported within a cluster.

The phys-schost# prompt reflects a global-cluster prompt. Perform this procedure on a global cluster.

This procedure provides the long forms of the Oracle Solaris Cluster commands. Most commands also have short forms. Except for the long and short forms of the command names, the commands are identical.

(x86 only) If your global cluster or zone cluster is running Oracle Real Application Clusters (RAC), shut down all instances of the database on the cluster you are shutting down.
Refer to the Oracle RAC product documentation for shutdown procedures.

Assume a role that provides solaris.cluster.admin RBAC authorization on any node in the cluster.
Perform all steps in this procedure from a node of the global cluster.

Shut down the global cluster, the zone cluster, or all zone clusters.
- Shut down the global cluster. This action also shuts down all zone clusters.
```
phys-schost# cluster shutdown -g0 -y
```
- Shut down a specific zone cluster.
```
phys-schost# clzonecluster halt zoneclustername
```
- Shut down all zone clusters.
```
phys-schost# clzonecluster halt +
```
  You can also use the cluster shutdown command within a zone cluster to shut down that particular zone cluster.

Verify that all nodes on the global cluster or zone cluster are showing the ok prompt on a SPARC based system or a GRUB menu on an x86 based system.
Do not power off any nodes until all nodes are at the ok prompt on a SPARC based system or in a boot subsystem on an x86 based system.
- Check the status of one or more global-cluster nodes from another global-cluster node which is still up and running in the cluster.
```
phys-schost# cluster status -t node
```
- Use the status subcommand to verify that the zone cluster was shut down.
```
phys-schost# clzonecluster status
```

If necessary, power off the nodes of the global cluster.

Example 3-1 Shutting Down a Zone Cluster

The following example shuts down a zone cluster called sczone.

phys-schost# clzonecluster halt sczone
Waiting for zone halt commands to complete on all the nodes of the zone cluster "sczone"...
Sep  5 19:06:01 schost-4 cl_runtime: NOTICE: Membership : Node 2 of cluster 'sczone' died.
Sep  5 19:06:01 schost-4 cl_runtime: NOTICE: Membership : Node 4 of cluster 'sczone' died.
Sep  5 19:06:01 schost-4 cl_runtime: NOTICE: Membership : Node 3 of cluster 'sczone' died.
Sep  5 19:06:01 schost-4 cl_runtime: NOTICE: Membership : Node 1 of cluster 'sczone' died.
phys-schost#

Example 3-2 SPARC: Shutting Down a Global Cluster

The following example shows the console output when normal global-cluster operation is stopped and all nodes are shut down, enabling the ok prompt to be shown. The –g 0 option sets the shutdown grace period to zero, and the -y option provides an automatic yes response to the confirmation question. Shutdown messages also appear on the consoles of the other nodes in the global cluster.

phys-schost# cluster shutdown -g0 -y
Wed Mar 10 13:47:32 phys-schost-1 cl_runtime:
WARNING: CMM monitoring disabled.
phys-schost-1#
INIT: New run level: 0
The system is coming down.  Please wait.
System services are now being stopped.
/etc/rc0.d/K05initrgm: Calling clnode evacuate
The system is down.
syncing file systems... done
Program terminated
ok

Example 3-3 x86: Shutting Down a Global Cluster

The following example shows the console output when normal global-cluster operation is stopped and all nodes are shut down. In this example, the ok prompt is not displayed on all of the nodes. The –g 0 option sets the shutdown grace period to zero, and the -y option provides an automatic yes response to the confirmation question. Shutdown messages also appear on the consoles of the other nodes in the global cluster.

phys-schost# cluster shutdown -g0 -y
May  2 10:32:57 phys-schost-1 cl_runtime:
WARNING: CMM: Monitoring disabled.
root@phys-schost-1#
INIT: New run level: 0
The system is coming down.  Please wait.
System services are now being stopped.
/etc/rc0.d/K05initrgm: Calling clnode evacuate
failfasts already disabled on node 1
Print services already stopped.
May  2 10:33:13 phys-schost-1 syslogd: going down on signal 15
The system is down.
syncing file systems... done
Type any key to continue

See also

See How to Boot a Cluster to restart a global cluster or a zone cluster that was shut down.