Contained Within
Find More Documentation
Featured Support Resources
|  PDF로 이 문서 다운로드 (3078 KB)
scswitch(1M)
NAME
| SYNOPSIS
| DESCRIPTION
| OPTIONS
| EXAMPLES
| EXIT STATUS
| ATTRIBUTES
| SEE ALSO
| WARNINGS
NAME
scswitch– perform ownership and state change of resource groups
and device groups in Sun Cluster configurations
SYNOPSIS
scswitch -c -h node[:zone][,...] -j resource[,...] -f flag-name
scswitch {-e| -n} [-M] -j resource[,...][-h node[:zone][,...]]
scswitch -F {-g resource-grp[,...]| -D device-group[,...]}
scswitch -m -D device-group[,...]
scswitch -Q [ -g resource-grp[,...]] [-k]
scswitch -R -h node[:zone][,...] -g resource-grp[,...]
scswitch -r [-g resource-grp[,...]]
scswitch -S -h node[:zone][,...] [-K continue_evac]
scswitch -s [-g resource-grp[,...]] [-k]
scswitch {-u| -o} -g resource-grp[,...]
scswitch -Z [-g resource-grp[,...]]
scswitch -z -D device-group[,...] -h node[:zone][,...]
scswitch -z [-g resource-grp[,...]] [-h node[:zone][,...]]
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 scswitch command moves resource groups or device
groups, also called disk device groups, to new primary nodes. It also provides
options for evacuating all resource groups and device groups from a node by
moving ownership elsewhere, bringing resource groups or device groups offline
and online, enabling or disabling resources, switching resource groups to
or from an Unmanaged state, or clearing error flags on
resources.
You can run the scswitch command from any node in
a Sun Cluster configuration. If a device group is offline, you can use scswitch to bring the device group online onto any host in the node
list. However, once the device group is online, a switchover to a spare node
is not permitted. Only one invocation of scswitch at a
time is permitted.
Do not attempt to kill an scswitch operation that
is already underway.
You can use some forms of this command in a non-global zone, referred to simply as a zone. For more information about valid uses of this command in zones, see the descriptions of the individual options.
For ease of administration, use this command in the global zone.
OPTIONS
Basic Options
The following
basic options are supported. Options that you can use with some of these basic
options are described in “Additional Options.”
-
-c
-
Clears the -f flag-name error flag on the specified
set of resources on the specified nodes or zones. For the current release
of Sun Cluster software, the -c option is only
implemented for the Stop_failed resource state. Clearing
the Stop_failed resource state places the resource into
the offline state on the specified nodes or zones.
If you use this option in a non-global zone, this option successfully operates only on resources that can be mastered by that zone. If you use this option in the global zone, this option can operate on any resource.
For ease of administration, use this form of the command in the global zone.
If the Stop method fails on a resource and the Failover_mode property of the resource is set to Hard,
the Resource Group Manager (RGM) halts or reboots the node or zone to force
the resource (and all other resources mastered by that node or zone) offline.
If the Stop method fails on a resource and the Failover_mode property is set to a value other than Hard, the individual resource goes into the Stop_failed
resource state, and the resource group is placed into the Error_stop_failed state. A resource group in the Error_stop_failed
state on any node cannot be brought online on any node, nor can it be edited
(you cannot add or delete resources or change resource group properties or
resource properties). You must clear the Stop_failed resource
state by performing the procedure that is documented in the Sun
Cluster Data Services Installation Guide for Solaris OS.
 Caution – Make sure that both the resource and its monitor are stopped
on the specified node or zone before you clear the Stop_failed
resource state. Clearing the Stop_failed resource state
without fully killing the resource and its monitor can lead to more than one
instance of the resource executing on the cluster simultaneously. If you are
using shared storage, this situation can cause data corruption. If necessary,
as a last resort, execute a kill(1)
command on the associated processes.
-
-e
-
Enables the specified resources.
If you use this option in a non-global zone, this option successfully operates only on resources that can be mastered by that zone. If you use this option in the global zone, this option can operate on any resource.
For ease of administration, use this form of the command in the global zone.
Once you have enabled a resource, it goes online or offline depending
on whether its resource group is online or offline.
You can specify the -h option with the -e
option to enable a resource on only a specified subset of nodes or zones.
If you omit the -h option, the specified resources are enabled
on all nodes or zones.
-
-F
-
Takes offline
the specified resource groups (-g) or device groups (-D) on all nodes.
If you use this option in a non-global zone, this option successfully operates
only on resource groups whose node list contains that zone. If you use this
option in the global zone, this option can operate on any resource group.
For ease of administration, use this form of the command in the global zone.
When you specify the -F option with the -D
option, you can run the -F option only from the global zone.
When the -F option takes a device group offline, the
associated VxVM disk group or Solaris Volume Manager disk set is deported
or released by the primary node. Before a device group can be taken offline,
all access to its devices must be stopped, and all dependent file systems
must be unmounted. You can start an offline device group by issuing an explicit scswitch call, by accessing a device within the group, or by mounting
a file system that depends on the group.
-
-m
-
Takes the specified
device groups offline from the cluster for maintenance. The resulting state
survives reboots.
You can use this option only in the global zone.
Before a device group can be placed in maintenance mode, all access
to its devices must be stopped, and all dependent file systems must be unmounted.
If a device group is currently being accessed, the action fails and the specified
device groups are not taken offline from the cluster.
Device groups are brought back online by using the -z
option. Only explicit calls to the scswitch command can
bring a device group out of maintenance mode.
-
-n
-
Disables the
specified resources.
If you use this option in a non-global zone, this option successfully operates only on resources that can be mastered by that zone. If you use this option in the global zone, this option can operate on any resource.
For ease of administration, use this form of the command in the global zone.
A disabled resource that is online on its current masters is immediately
brought offline from its current masters. The disabled resource remains offline
regardless of the state of its resource group.
You can specify the -h option with the -e
option to disable a resource on only a specified subset of nodes or zones.
If you omit the -h option, the specified resources are disabled
on all nodes or zones.
-
-o
-
Takes the specified
unmanaged resource groups out of the unmanaged state.
If you use this option in a non-global zone, this option successfully operates
only on resource groups whose node list contains that zone. If you use this
option in the global zone, this option can operate on any resource group.
For ease of administration, use this form of the command in the global zone.
Once a resource group is in the managed state, the RGM attempts to bring
the resource group online.
-
-Q
-
Brings the specified
resource groups to a quiescent state.
If you use this option in a non-global zone, this option successfully operates
only on resource groups whose node list contains that zone. If you use this
option in the global zone, this option can operate on any resource group.
For ease of administration, use this form of the command in the global zone.
If you omit the -g option, the -Q option
applies to all resource groups.
This option stops the specified resource groups from continuously switching
from one node to another in the event of the failure of a Start
or Stop method. This form of the scswitch
command does not exit until the resource groups have reached a quiescent state
in which they are no longer stopping or starting on any node.
If a Monitor_stop, Stop, Postnet_stop, Start, or Prenet_start method fails on any resource in a group while the scswitch -Q command is executing, the resource behaves as if its Failover_mode property was set to None, regardless
of its actual setting. Upon failure of one of these methods, the resource
moves to an error state (either the Start_failed or Stop_failed resource state) rather than initiating a failover or
a reboot of the node.
When the scswitch -Q command exits, the specified
resource groups might be online or offline or in the ONLINE_FAULTED or ERROR_STOPPED_FAILED state. You can determine
their current state by executing the clresourcegroup status
command.
If a node dies during execution of the scswitch -Q
command, execution might be interrupted, leaving the resource groups in a
non-quiescent state. If execution is interrupted, scswitch -Q returns a nonzero exit code and writes an error message to the
standard error. In this case, you can reissue the scswitch -Q command.
You can specify the -k option with the -Q
option to hasten the quiescing of the resource groups. If you specify the -k option, it immediately kills all methods that are running on behalf
of resources in the affected resource groups. If you do not specify the -k option, methods are allowed to continue running until they exit
or exceed their configured timeout.
-
-R
-
Takes the specified
resource groups offline and then back online on the specified primary nodes
or zones.
If you use this option in a non-global zone, this option successfully operates
only on resource groups whose node list contains that zone. If you use this
option in the global zone, this option can operate on any resource group.
For ease of administration, use this form of the command in the global zone.
The specified node or zone must be a current primary node of the resource
group.
-
-r
-
Resumes the automatic
recovery actions on the specified resource group, which were previously suspended
by the -s option.
If you use this option in a non-global zone, this option successfully operates
only on resource groups whose node list contains that zone. If you use this
option in the global zone, this option can operate on any resource group.
For ease of administration, use this form of the command in the global zone.
If you omit the -g option, the -r option
applies to all resource groups.
A suspended resource group is not automatically
restarted or failed over until you explicitly issue the command that resumes
automatic recovery. Whether online or offline, suspended data services remain
in their current state. You can still manually switch the resource group to
a different state on specified nodes or zones. You can also still enable or
disable individual resources in the resource group.
For information about how to suspend automatic recovery actions on resource
groups, see the description of the -s option.
-
-S
-
Switches all
resource groups and device groups off the specified node,
or switches all resource groups off the specified zone.
When used on a non-global zone, this option evacuates only the resource
groups that are located in that zone. There is no effect on device groups.
When executed in a global zone, this option can evacuate any specified
node or zone in the cluster. When executed in a non-global zone, this option
can only evacuate that non-global zone.
The system attempts to select new primaries based on configured preferences
for each group. All evacuated groups are not necessarily remastered by the
same primary. If all groups that are mastered by the specified node or zone
cannot be successfully evacuated from the specified node or zone, the command
exits with an error.
Resource groups are first taken offline before they are relocated to
new primary nodes or zones. An evacuated resource group might remain offline
if the system cannot start it on a new primary node or zone.
If the primary ownership of a device group cannot be changed to one
of the other nodes or zones, primary ownership for that device group is retained
by the original node or zone.
-
-s
-
Suspends the
automatic recovery actions on and quiesces the specified resource group.
If you use this option in a non-global zone, this option successfully operates
only on resource groups whose node list contains that zone. If you use this
option in the global zone, this option can operate on any resource group.
For ease of administration, use this form of the command in the global zone.
If you omit the -g option, the -s option
applies to all resource groups.
A suspended resource group is not automatically started, restarted,
or failed over until you explicitly resume monitoring of the resource group
with this option. While monitoring of the resource group remains suspended,
data services remain online. You can still manually switch the resource group
online or offline on specified nodes or zones. You can also still enable or
disable individual resources in the resource group.
You might need to suspend the automatic recovery of a resource group
to investigate and fix a problem in the cluster. Or, you might need to perform
maintenance on resource group services.
You can also specify the -k option to immediately kill
all methods that are running on behalf of resources in the affected resource
groups. By using the -k option, you can speed the quiescing
of the resource groups. If you do not specify the -k option,
methods are allowed to continue running until they exit or exceed their configured
timeout.
For information about how to resume automatic recovery actions on resource
groups, see the description of the -r option.
-
-u
-
Puts the specified
managed resource groups into the unmanaged state.
If you use this option in a non-global zone, this option successfully operates
only on resource groups whose node list contains that zone. If you use this
option in the global zone, this option can operate on any resource group.
For ease of administration, use this form of the command in the global zone.
As a precondition of the -u option, all resources that
belong to the indicated resource groups must first be disabled.
-
-Z
-
This option does
the following:
-
Enables all resources of the specified resource groups
-
Moves those resource groups into the managed state
-
Brings those resource groups online on all the default primaries
If you use this option in a non-global zone, this option successfully operates
only on resource groups whose node list contains that zone. If you use this
option in the global zone, this option can operate on any resource group.
For ease of administration, use this form of the command in the global zone.
If you omit the -g option, the -Z option
applies to all resource groups.
When the -g option is not specified, the scswitch command attempts to bring all resource groups online, except resource
groups that are suspended.
-
-z
-
Requests
a change in mastery of the specified resource group or device group.
If you use this option in a non-global zone, this option successfully operates
only on resource groups whose node list contains that zone. If you use this
option in the global zone, this option can operate on any resource group.
For ease of administration, use this form of the command in the global zone.
If you omit the -g option, the -z option
applies to all resource groups.
When used with the -D option, the -z
option switches one or more specified device groups to the specified node.
Only one primary node name can be specified for a device group's switchover.
When multiple device groups are specified, the -D option switches
the device groups in the order specified. If the -z -D operation encounters an error, the operation stops and no further
switches are performed.
When used with only the -g option, the -z
option brings the specified resource groups, which must already be managed,
online on their most preferred nodes or zones. This form of scswitch does not bring a resource group online in violation of its strong RG_affinities, and it writes a warning message if the affinities
of a resource group cannot be satisfied on any node or zone. This option does
not enable any resources, enable monitoring on any resources, or take any
resource groups out of the unmanaged state, as the -Z option
does.
When used with the -g and -h options,
the -z option brings the specified resource groups online
on the nodes or zones that are specified by the -h option,
and it takes them offline on all other cluster nodes or zones. If the node
list that is specified with the -h option is empty (-h ""), the -z option takes the resource groups
that are specified by the -g option offline from all of their
current masters. All nodes or zones that are specified by the -h
option must be current members of the cluster and must be potential primaries
of all of the resource groups that are specified by the -g
option. The number of nodes or zones that are specified by the -h
option must not exceed the setting of the Maximum_primaries
property of any of the resource groups that are specified by the -g option.
When used alone (scswitch -z), the -z option switches online all managed resource groups that are not
suspended on their most preferred nodes or zones.
If you configure the RG_affinities property of one
or more resource groups and you issue the scswitch -z -g command (with or without the -h option), additional
resource groups other than those that are specified after the -g
option might be switched as well. RG_affinities is described
in rg_properties(5).
Additional Options
EXAMPLES
Example 1 Switching Over a Resource Group
The following command switches over resource-grp-2
to be mastered by schost-1.
schost-1# scswitch –z –h schost-1 –g resource-grp-2
|
Example 2 Bringing Online a Managed Resource Group Without Enabling Monitoring
or Resources
The following command brings resource-grp-2 online
if resource-grp-2 is already managed, but does not enable
any resources or enable monitoring on any resources that are currently disabled.
schost-1# scswitch –z –g resource-grp-2
|
Example 3 Switching Over a Resource Group Configured to Have Multiple Primaries
The following command switches over resource-grp-3,
a resource group that is configured to have multiple primaries, to be mastered
by schost-1,schost-2,schost-3.
schost-1# scswitch –z –h schost-1,schost-2,schost-3 –g resource-grp-3
|
Example 4 Moving All Resource Groups and Device Groups Off a Node
The following command switches over all resource groups and device groups
from schost-1 to a new set of primaries.
schost-1# scswitch –S –h schost-1
|
Example 5 Moving All Resource Groups and Device Groups Persistently Off a Node
The following command switches over all resource groups and device groups
from schost-1 to a new set of primaries. The command also
specifies a 120-second wait before resource groups and device groups are permitted
to switch back to schost-1.
The use of the -K option in the following command prevents
resource groups from automatically switching back to schost-1
after schost-1 is successfully evacuated. An example of
when a resource group might attempt to switch back to schost-1
is if the resource group fails to start on its new master. Another example
is if a resource group has strong negative affinities configured with the RG_affinities property.
schost-1# scswitch –S –h schost-1 -K 120
|
Example 6 Restarting Resource Groups
The following command restarts resource-grp-1 and resource-grp-2 on the non-global zones schost-1:zone1
and schost-2:zone1.
schost-1# scswitch –R –h schost-1:zone1,schost-2:zone1 –g resource-grp-1,resource-grp-2
|
Example 7 Disabling Resources
schost-1# scswitch –n –j resource-1,resource-2
|
Example 8 Enabling a Resource
schost-1# scswitch –e –j resource-1
|
Example 9 Taking Resource Groups to the Unmanaged State
schost-1# scswitch –u –g resource-grp-1,resource-grp-2
|
Example 10 Taking Resource Groups Out of the Unmanaged State
schost-1# scswitch –o –g resource-grp-1,resource-grp-2
|
Example 11 Switching Over a Device Group
The following command switches over device-group-1
to be mastered by schost-2.
schost-1# scswitch –z –h schost-2 –D device-group-1
|
Example 12 Putting a Device Group Into Maintenance Mode
The following command puts device-group-1 into maintenance
mode.
schost-1# scswitch –m –D device-group-1
|
Example 13 Quiescing Resource Groups
The following command brings resource groups RG1
and RG2 to a quiescent state.
schost-1# scswitch –Q -g RG1,RG2
|
Example 14 Clearing a Start_failed Resource State by Switching
Over a Resource Group
The Start_failed resource state indicates that a Start or Prenet_start method failed or timed
out on a resource, but its resource group came online anyway. The resource
group comes online even though the resource has been placed in a faulted state
and might not be providing service. This state can occur if the resource's Failover_mode property is set to None or to another
value that prevents the failover of the resource group.
Unlike the Stop_failed resource state, the Start_failed resource state does not prevent
you or the Sun Cluster software from performing actions on the resource group.
You do not need to issue the scswitch -c command to
clear a Start_failed resource state. You only need to execute
a command that restarts the resource.
The following command clears a Start_failed resource
state that has occurred on a resource in the resource-grp-2
resource group. The command clears this condition by switching the resource
group to the schost-2 node.
schost-1# scswitch –z –h schost-2 –g resource-grp-2
|
Example 15 Clearing a Start_failed Resource State by Restarting
a Resource Group
The following command clears a Start_failed resource
state that has occurred on a resource in the resource-grp-2
resource group. The command clears this condition by restarting the resource
group on the schost-1 node.
For more information about the Start_failed resource
state, see the r_properties(5)
man page.
schost-1# scswitch –R –h schost-1 –g resource-grp-2
|
Example 16 Clearing a Start_failed Resource State by Disabling
and Enabling a Resource
The following command clears a Start_failed resource
state that has occurred on the resource resource-1 by disabling
and then re-enabling the resource.
For more information about the Start_failed resource
state, see the r_properties(5)
man page.
schost-1# scswitch –n –j resource-1
schost-1# scswitch –e –j resource-1
|
EXIT STATUS
This command blocks until requested actions are completely finished
or an error occurs.
The following exit values are returned:
-
0
-
The command completed successfully.
- nonzero
-
An error has occurred. scswitch writes an error message to the standard error.
If the scswitch command exits with
a nonzero exit status and the error message “cluster
is reconfiguring” is displayed, the requested operation
might have completed successfully, despite the error. If you doubt the result,
you can execute the scswitch command again with the same
arguments after the reconfiguration is complete.
If the scswitch command exits with a nonzero exit
status and the error message “Resource group failed
to start on chosen node and may fail over to other node(s)”
is displayed, the resource group continues to reconfigure for some time after
the scswitch command exits. Additional scswitch or clresourcegroup operations on that resource
group fail until the resource group has reached a terminal state such as the Online, Online_faulted, or Offline
state on all nodes.
If you invoke the scswitch command on multiple resources
or resource groups and multiple errors occur, the exit value might only reflect
one of the errors. To avoid this possibility, invoke the scswitch command on just one resource or resource group at a time.
Some operations are not permitted on a resource group (and its resources)
whose RG_system property is True. See rg_properties(5) for more information.
ATTRIBUTES
SEE ALSO
kill(1), pfcsh(1), pfexec(1), pfksh(1), pfsh(1), Intro(1CL), cldevicegroup(1CL), clresourcegroup(1CL), su(1M), attributes(5), rbac(5), r_properties(5), rg_properties(5)
Sun Cluster
Data Services Planning and Administration Guide
WARNINGS
If you take a resource group offline by using the -z
or -F option with the -g option, the Offline state of the resource group does not survive node reboots.
If a node dies or joins the cluster, or if other resource groups are switching
over, the resource group might come online. The resource group comes online
on a node or zone even if you previously switched the resource group offline.
Even if all of the resources are disabled, the resource group comes online.
To prevent the resource group from coming online automatically, use
the -s option to suspend the automatic recovery actions of
the resource group. To resume automatic recovery actions, use the -r option.
Sun Cluster 3.2 Last Revised 18 Jul 2006
NAME
| SYNOPSIS
| DESCRIPTION
| OPTIONS
| EXAMPLES
| EXIT STATUS
| ATTRIBUTES
| SEE ALSO
| WARNINGS
|
