clressharedaddress(1CL) Sun Cluster Maintenance Commands clressharedaddress(1CL)
NAME
clressharedaddress, clrssa - manage Sun Cluster resources for shared addresses
SYNOPSIS
/usr/cluster/bin/clressharedaddress [subcommand]
-?
/usr/cluster/bin/clressharedaddress -V
/usr/cluster/bin/clressharedaddress [subcommand
[options]] -v [saresource]...
/usr/cluster/bin/clressharedaddress create -g resourcegroup
[-h lhost[,...] ] [-N netif@node[,...]]
[-X node[:zone][,...]] [-p name=value] [-d] saresource
/usr/cluster/bin/clressharedaddress create -i {-
| clconfiguration} [-a] [-g resourcegroup[,...]]
[-X node[:zone][,...]] [-p name=value] [-d] {+
| saresource...}
/usr/cluster/bin/clressharedaddress delete [-g resourcegroup[,...]]
[-F] {+ | saresource...}
/usr/cluster/bin/clressharedaddress disable [-g resourcegroup[,...]]
[-R] [ [-z zone] -n node[:zone][,...]] {+ | saresource...}
/usr/cluster/bin/clressharedaddress enable [-g resourcegroup[,...]]
[-R] [ [-z zone] -n node[:zone][,...]] {+ | saresource...}
/usr/cluster/bin/clressharedaddress export [-o
{- | configfile}] [+ | saresource...]
/usr/cluster/bin/clressharedaddress list [-s state[,...]]
[-g resourcegroup[,...]] [+ | saresource...]
/usr/cluster/bin/clressharedaddress list-props
[-l listtype] [-p name[,...]] [+ | lhresource...]
/usr/cluster/bin/clressharedaddress monitor [-g resourcegroup[,...]]
{+ | saresource...}
/usr/cluster/bin/clressharedaddress reset [-f errorflag]
[-g resourcegroup[,...]] {+ | saresource...}
/usr/cluster/bin/clressharedaddress set [-i {-
| clconfiguration}] [-g resourcegroup[,...]]
[-X node[:zone][,...]] [-p name[+|-]=value] {+
| saresource...}
/usr/cluster/bin/clressharedaddress show [-g resourcegroup[,...]]
[-p name[,...]] [+ | saresource...]
/usr/cluster/bin/clressharedaddress status [-s state[,...]]
[ [-z zone] -n node[:zone][,...]] [-g resourcegroup[,...]]
[+ | saresource...]
/usr/cluster/bin/clressharedaddress unmonitor [-g resourcegroup[,...]]
{+ | saresource...}
DESCRIPTION
The clressharedaddress command manages resources for Sun Cluster shared addresses. The clrssa command is the short form of the
clressharedaddress command. The clressharedaddress command and the clrssa command are identical. You can use either form of the command.
You can also use the clresource(1CL) command to manage resources for a shared address.
You can run the clressharedaddress command with the create subccommand or the delete subcommand only from the global zone.
Some subcommands of the clressharedaddress command modify the resource configuration. You can use these subcommands from the global zone or
a non-global zone. If you use a subcommand that modifies resource configuration from a non-global zone, only resources that the non-global
zone can master are modified. The following subcommands modify resource configuration:
o disable
o enable
o monitor
o reset
o set
o unmonitor
Some subcommands of the clressharedaddress command only obtain information about resources. You can use these subcommands from the global
zone or a non-global zone. However, even when you use these subcommands from a non-global zone, the scope of the command is not limited to
that zone. Information about all resources that are supplied as operands to the command is obtained, regardless of whether the non-global
zone can master the resources. The following commands only obtain information about resources:
o export
o list
o list-props
o show
o status
To avoid unpredictable results from this command, run all forms of the command from the global zone.
The general form of this command is:
clressharedaddress [subcommand] [options] [operands]
You can omit subcommand only if options specifies the option -? or -V.
Each option of this command has a long form and a short form. Both forms of each option are given with the description of the option in the
OPTIONS section of this man page.
SUBCOMMANDS
The following subcommands are supported:
create
Creates the shared address resources that are specified as operands to the command.
When you usecreate with the -i option to specify a configuration file, the subcommand accepts the plus sign (+) as an operand. When you
use the + operand, all resources in the configuration file that do not exist are created.
By default, resources are created in the enabled state with monitoring enabled. However, a resource comes online and is monitored only
after the resource's resource group is brought online. To create resources in the disabled state, specify the -d option.
You can use this subcommand only in the global zone.
Users other than superuser require solaris.cluster.modify role-based access control (RBAC) authorization to use this subcommand.
See also the description of the delete subcommand.
delete
Deletes the shared address resources that are specified as operands to the command. This subcommand accepts the plus sign (+) as an op-
erand to specify that all resources are deleted.
The -g option filters the list of operands to limit the resources that are deleted. The -g option deletes only the resources in the
list of operands that are members of the resource groups in resourcegrouplist.
o By default, a resource is deleted only if the following conditions are met:
o The resource must be disabled.
o All dependencies on the resource must be eliminated.
o To ensure that all specified resources are deleted, specify the -F option. The effects of the -F option are as follows:
o All specified resources are deleted, even resources that are not disabled.
o All specified resources are removed from resource-dependency settings of other resources.
Resources are deleted in the order that is required to satisfy dependencies between the resources, regardless of the order in which
resources are specified on the command line.
You can use this subcommand only in the global zone.
Users other than superuser require solaris.cluster.modify RBAC authorization to use this subcommand.
See also the description of the create subcommand.
disable
Disables the shared address resources that are specified as operands to the command. This subcommand accepts the plus sign (+) as an
operand to specify that all resources are disabled.
The -g option filters the list of operands to limit the resources that are disabled. The -g option disables only the resources in the
list of operands that are members of the resource groups in resourcegrouplist.
To ensure that all required resource dependencies are satisfied, specify the -R option. The -R option disables any resources that
depend on the resources that are specified as operands to the command, even if the resources are not specified as operands to the com-
mand. The -g option and the -t option do not apply to resources that are to be disabled solely to satisfy resource dependencies.
Resources are disabled in the order that is required to satisfy dependencies between the resources, regardless of the order in which
resources are specified on the command line.
You can use this subcommand from the global zone or a non-global zone. If you use this subcommand from a non-global zone, only
resources that the non-global zone can master are modified.
Users other than superuser require solaris.cluster.admin RBAC authorization to use this subcommand.
See also the description of the enable subcommand.
enable
Enables the shared address resources that are specified as operands to the command. This subcommand accepts the plus sign (+) as an op-
erand to specify that all resources are enabled.
The -g option filters the list of operands to limit the resources that are enabled. The -g option enables only the resources in the
list of operands that are members of the resource groups in resourcegrouplist.
To ensure that all required resource dependencies are satisfied, specify the -R option. The -R option enables any resources that depend
on the resources that are specified as operands to the command, even if the resources are not specified as operands to the command. The
-g option does not apply to resources that are to be enabled solely to satisfy resource dependencies.
Resources are enabled in the order that is required to satisfy dependencies between the resources, regardless of the order in which
resources are specified on the command line.
You can use this subcommand from the global zone or a non-global zone. If you use this subcommand from a non-global zone, only
resources that the non-global zone can master are modified.
Users other than superuser require solaris.cluster.admin RBAC authorization to use this subcommand.
See also the description of the disable subcommand.
export
Exports the shared address resource configuration in the format that is described by the clconfiguration(5CL) man page.
You can use this subcommand from the global zone or a non-global zone. If you use this subcommand from a non-global zone, the scope of
the command is not limited to that zone. Information about all resources that are supplied as operands to the command is obtained,
regardless of whether the non-global zone can master the resources.
Users other than superuser require solaris.cluster.read RBAC authorization to use this subcommand.
list
Displays a list of the shared address resources that are specified as operands to the command. By default, all resources are displayed.
The -g option filters the list of operands to limit the resources that are displayed. The -g option displays only the resources in the
list of operands that are members of the resource groups in resourcegrouplist.
This subcommand accepts the plus sign (+) as an operand to specify all resources in the specified resource groups or that are instances
of the specified resource types. If no operands are supplied, all resources in the specified resource groups or that are instances of
the specified resource types are displayed.
If you specify the -v option, the resource group and resource type of each resource in the list is also displayed.
You can use this subcommand from the global zone or a non-global zone. If you use this subcommand from a non-global zone, the scope of
the command is not limited to that zone. Information about all resources that are supplied as operands to the command is obtained,
regardless of whether the non-global zone can master the resources.
Users other than superuser require solaris.cluster.read RBAC authorization to use this subcommand.
list-props
Displays a list of the properties of the shared address resources that are specified as operands to the command. By default, the exten-
sion properties of all resources are displayed.
The following options filter the list of operands to limit the resources whose properties are displayed:
-g resourcegrouplist Displays the properties only of the shared address resources in the list of operands that are members of
the resource groups in resourcegrouplist.
The -l option specifies the type of resource properties that are to be displayed:
-l all Specifies that standard properties and extension properties are displayed.
-l extension Specifies that only extension properties are displayed. By default, only extension properties are dis-
played.
-l standard Specifies that only standard properties are displayed.
If you do not specify the -loption, only extension properties are displayed, unless you specify a standard property explicitly by using
the -p option or the -y option.
The -p option limits the set of resource properties that is to be displayed. The -p option displays only the properties that are speci-
fied in namelist. You can specify standard properties and extension properties in namelist.
If you specify the -v option, the description of each property is also displayed.
This subcommand accepts the plus sign (+) as an operand to specify all resources in the specified resource groups or that are instances
of the specified resource types. If no operands are supplied, properties of all resources in the specified resource groups or that are
instances of the specified resource types are displayed.
You can use this subcommand from the global zone or a non-global zone. If you use this subcommand from a non-global zone, the scope of
the command is not limited to that zone. Information about all resources that are supplied as operands to the command is obtained,
regardless of whether the non-global zone can master the resources.
Users other than superuser require solaris.cluster.read RBAC authorization to use this subcommand.
monitor
Turns on monitoring for the shared address resources that are specified as operands to the command. This subcommand accepts the plus
sign (+) as an operand to specify that monitoring is turned on for all resources.
The -g option filters the list of operands to limit the resources that are monitored. The -g option monitors only the resources in the
list of operands that are members of the resource groups in resourcegrouplist.
If monitoring is turned on for a resource, the resource is monitored only if the following conditions are met:
o The resource is enabled.
o The resource group that contains the resource is online on at minimum one cluster node.
Note -
When you turn on monitoring for a resource, you do not enable the resource.
You can use this subcommand from the global zone or a non-global zone. If you use this subcommand from a non-global zone, only
resources that the non-global zone can master are modified.
Users other than superuser require solaris.cluster.admin RBAC authorization to use this subcommand.
See also the description of the unmonitor subcommand.
reset
Clears an error flag that is associated with the shared address resources that are specified as operands to the command. This subcom-
mand accepts the plus sign (+) as an operand to specify that the error flag is cleared for all resources.
The -g option filters the list of operands to limit the resources that are reset. The -g option resets only the resources in the list
of operands that are members of the resource groups in resourcegrouplist.
By default, the reset subcommand clears the STOP_FAILED error flag. To specify explicitly the error flag that is to be cleared, use the
-f option. The only error flag that the -f option accepts is the STOP_FAILED error flag.
You can use this subcommand from the global zone or a non-global zone. If you use this subcommand from a non-global zone, only
resources that the non-global zone can master are modified.
Users other than superuser require solaris.cluster.admin RBAC authorization to use this subcommand.
set
Modifies specified properties of the shared address resources that are specified as operands to the command. This subcommand accepts
the plus sign (+) as an operand to specify that the specified properties of all resources are modified.
The -g option filters the list of operands to limit the resources that are modified. The -g option modifies only the resources in the
list of operands that are members of the resource groups in resourcegrouplist.
You can use this subcommand from the global zone or a non-global zone. If you use this subcommand from a non-global zone, only
resources that the non-global zone can master are modified.
Users other than superuser require solaris.cluster.modify RBAC authorization to use this subcommand.
show
Displays the configuration of the shared address resources that are specified as operands to the command. By default, the configuration
of all resources is displayed.
The -g option filters the list of operands to limit the resources for which the configuration is displayed. The -g option displays the
configuration of only the resources in the list of operands that are members of the resource groups in resourcegrouplist.
The -p option limits the set of resource properties that is to be displayed. The -p option displays only the properties that are speci-
fied in namelist. You can specify standard properties and extension properties in namelist.
This subcommand accepts the plus sign (+) as an operand to specify all resources in the specified resource groups or that are instances
of the specified resource types. If no operands are supplied, the configuration of all resources in the specified resource groups or
that are instances of the specified resource types are displayed.
You can use this subcommand from the global zone or a non-global zone. If you use this subcommand from a non-global zone, the scope of
the command is not limited to that zone. Information about all resources that are supplied as operands to the command is obtained,
regardless of whether the non-global zone can master the resources.
Users other than superuser require solaris.cluster.read RBAC authorization to use this subcommand.
status
Displays the status of the shared address resources that are specified as operands to the command. By default, the status of all
resources is displayed.
The following options filter the list of operands to limit the list of resources for which the status is displayed:
-g resourcegrouplist Displays the status of only the resources in the list of operands that are members of the resource groups
in resourcegrouplist.
-n nodelist Displays the status of only the resources in the list of operands that are hosted on the nodes or in the
zones in nodelist.
-s statelist Displays the status of only the resources in the list of operands that are in the states in statelist.
This subcommand accepts the plus sign (+) as an operand to specify all resources in the specified resource groups or that are instances
of the specified resource types. If no operands are supplied, the status of all resources in the specified resource groups or that are
instances of the specified resource types are displayed.
You can use this subcommand from the global zone or a non-global zone. If you use this subcommand from a non-global zone, the scope of
the command is not limited to that zone. Information about all resources that are supplied as operands to the command is obtained,
regardless of whether the non-global zone can master the resources.
Users other than superuser require solaris.cluster.read RBAC authorization to use this subcommand.
unmonitor
Turns off monitoring for the shared address resources that are specified as operands to the command. This subcommand accepts the plus
sign (+) as an operand to specify that monitoring is turned off for all resources.
If you turn off monitoring for a resource that is disabled, the resource is not affected. The resource and its monitor are already off-
line.
Note -
When you turn off monitoring for a resource, you do not disable the resource. However, when you disable a resource, you do not need
to turn off monitoring for the resource. The disabled resource and its monitor are kept offline.
The -g option filters the list of operands to limit the resources for which monitoring is turned off. The -g option turns off monitor-
ing for the resources in the list of operands that are members of the resource groups in resourcegrouplist.
You can use this subcommand from the global zone or a non-global zone. If you use this subcommand from a non-global zone, only
resources that the non-global zone can master are modified.
Users other than superuser require solaris.cluster.admin RBAC authorization to use this subcommand.
See also the description of the disable subcommand and the monitor subcommand.
OPTIONS
The following options are supported:
-?
--help
Displays help information. When this option is used, no other processing is performed.
You can specify this option without a subcommand or with a subcommand.
If you specify this option without a subcommand, the list of subcommands for this command is displayed.
If you specify this option with a subcommand, the usage options for the subcommand are displayed.
The effect of this option with specific subcommands is as follows:
create When specified with the -g option, this option displays help information for all resource properties of the
specified resource group.
set Displays help information for properties of the resources that are specified as operands to the command.
-a
--automatic
Automatically performs the following additional operations when resources are being created from cluster configuration information:
o Registering resource types
o Creating resource groups
o Creating resources on which the resources that are specified in the list of operands depend
The cluster configuration information must contain sufficient information to do all of the following:
o Enable the resource types to be registered
o Enable the resource groups to be created
o Enable the resources to be create
You can specify this option only with the create subcommand. If you specify this option, you must also specify the -i option and pro-
vide a configuration file.
-d
--disable
Disables a resource when the resource is created. You can specify this option only with the create subcommand. By default, resources
are created in the enabled state.
Enabling a resource does not guarantee that the resource is brought online. A resource comes online only after the resource's resource
group is brought online on at minimum one node.
-f errorflag
--flag errorflag
Specifies explicitly the error flag that is to be cleared by the reset subcommand. You can specify this option only with the reset sub-
command. By default, the reset subcommand clears the STOP_FAILED error flag.
The only error flag that the -f option accepts is the STOP_FAILED error flag.
-F
--force
Forces the deletion of resources that are not disabled. You can specify this option only with the delete subcommand.
-g resourcegroup[,...]
--resourcegroup resourcegroup-[,...]
Specifies a resource group or a list of resource groups.
For subcommands except create, the command acts on only the resources in the list of operands that are members of the resource groups
that the -g option specifies.
The effect of this option with specific subcommands is as follows:
create Specifies that the resource is created in the specified resource group. When you use -g with the create
subcommand, you can specify only one resource group.
-h lhost[,...]
--logicalhost lhost-[,...]
Specifies the host name list. You must use the -h option either when more than one logical host needs to be associated with the new
SharedAddress resource or when the logical host does not have the same name as the resource itself. All logical hosts in a HostnameList
for a SharedAddress resource must be on the same subnet. If you do not specify the HostnameList property, the HostnameList will be the
same as the SharedAddress resource.
The logical host names for a SharedAddress resource must be on the same subnet.
You can use -h can instead of setting the HostnameList property with -p; however, you cannot use -h and explicitly set HostnameList in
the same command.
You can only use -h is with the create subcommand.
-i {- | clconfiguration}
--input {- | clconfiguration-}
Specifies configuration information that is to be used for creating or modifying shared address resources. This information must con-
form to the format that is defined in the clconfiguration(5CL) man page. This information can be contained in a file or supplied
through standard input. To specify standard input, specify - instead of a file name.
Only the resources that are supplied as operands to the command are created or modified. Options that are specified in the command
override any options that are set in the configuration information. If configuration parameters are missing in the configuration infor-
mation, you must specify these parameters on the command line.
The effect of this option with specific subcommands is as follows:
create When specified with the -a option, this option registers all required resource types and creates all
required resource groups. You must supply all information that is required for the registration and config-
uration. All other configuration data is ignored.
-l listtype
--listtype listtype
Specifies the type of resource properties that are to be displayed by the list-props subcommand. You can specify this option only with
the list-props subcommand.
You must specify one value from the following list for listtype:
all Specifies that standard properties and extension properties are displayed.
extension Specifies that only extension properties are displayed. By default, only extension properties are dis-
played.
standard Specifies that only standard properties are displayed.
If you do not specify the -l option, only extension properties are displayed, unless you specify a standard property explicitly by
using the -p option.
-n node[:zone][,...]
--node node-[:zone-][,...]
Specifies a node or a list of nodes. You can specify each node as node name or a node ID. For each node, you can optionally specify a
non-global zone on the node.
The subcommands with which you can specify this option are as follows:
disable Disables only the resources in the list of operands that are hosted on the specified nodes or in the speci-
fied zones.
enable Enables only the resources in the list of operands that are hosted on the specified nodes or in the speci-
fied zones.
status Reports the status only of resources in the list of operands that are hosted on the specified nodes or in
the specified zones.
-N netif@node[,...]
--netiflist netif-@node-[,...]
Specifies a resource property. The -Noption enables you to set the NetIfList property without using the -p option for the property. If
you do not specify -N, the clressharedaddress command attempts to set the NetIfList property for you based on available IPMP groups or
public adapters, and the subnet associated with the HostnameList property.
You can specify the NetIfList property in the form of ipmpgroup@node[,...]. However, -N accepts both ipmpgroup@node[,...] and public-
NIC@node[,...]. If you do not use -N, or if you use it with publicNIC@node, the clressharedaddress command attempts to create the nec-
essary IPMP groups. The system creates a set of one or more single-adapter IPMP groups with a set of default later modified to include
multiple adapters using standard Solaris interfaces.
You can use -N instead of directly setting the NetIfList property with -p; however, you cannot use -N and explicitly set NetIfList in
the same command.
You can only use -N with the create subcommand.
-o {- | clconfiguration}
--output {- | clconfiguration-}
Specifies the location where resource configuration information is to be written. This location can be a file or standard output. To
specify standard output, specify - instead of a file name. If you specify standard output, all other standard output for the command is
suppressed. You can specify this option only with the export subcommand.
Configuration information is written only for the resources that are supplied as operands to the command. The information is written in
the format that is defined in the clconfiguration(5CL) man page.
-p name=value
-p name-+=array-values
-p name-=array-values
--property name-=value
--property name+=array-values
--property name--=array-values
Sets the standard properties and extension properties of a resource. You can specify this option only with the create subcommand and
the set subcommand.
For a description of standard properties, see the r_properties(5) man page.
For a description of a resource type's extension properties, see the documentation for the resource type.
The operators to use with this option are as follows:
= Sets the property to the specified value. The create subcommand and the set subcommand accept this operator.
+= Adds a value or values to a string array value. Only the set subcommand accepts this operator. You can specify this opera-
tor only for string array values.
-= Removes a value or values from a string array value. Only the set subcommand accepts this operator. You can specify this
operator only for string array values.
If a per-node property is to be set only on a subset of cluster nodes, specify the nodes where the property is set by appending the
list of nodes in braces to the property name as follows:
name{nodelist}
nodelist is a comma-separated list of node names or node IDs. For more information about per-node properties, see the rt_properties(5)
man page.
-p name[,...]
--property name-[,...]
Specifies a list of properties for the list-props subcommand and show subcommand.
You can use this option for standard properties and extension properties of a resource.
For a description of standard properties, see the r_properties(5) man page.
For a description of a resource type's extension properties, see the documentation for the resource type.
Without this option, the list-props subcommand and show subcommand list all or most resource properties, depending on whether the -v
option is also specified.
-R
--recursive
Recursively enables or disables resources to ensure that all required dependencies are satisfied. You can specify this option only with
the disable subcommand and the enable subcommand.
The effect of this option with these subcommands is as follows:
disable Disables any resources that depend on the resources that are specified as operands to the command, even if
the resources are not specified as operands to the command.
enable Enables any resources on which resources that are specified as operands to the command depend, even if the
resources are not specified as operands to the command.
-s state[,...]
--state state-[,...]
Specifies a list of states for the list subcommand and status subcommand.
This option limits the output to include only those resources that are in one of the specified states on one or more nodes in the node
list.
The possible states are as follows:
o degraded
o detached
o faulted
o monitor_failed
o not_online - specifies any state other than online or online_not_monitored
o offline
o online
o online_not_monitored
o start_failed
o stop_failed
o unknown
o unmonitored
o wait
-V
--version
Displays the version of the command.
Do not specify this option with subcommands, operands, or other options. The subcommands, operands, or other options are ignored. The
-V option only displays the version of the command. No other operations are performed.
-v
--verbose
Displays verbose messages to standard output.
You can specify this option with any form of the command.
Do not specify the -v option with the -o - option. The-v option is ignored. The -o - option suppresses all other standard output.
-X node[:zone][,...]
--auxnode node-[:zone-][,...]
Sets the AuxNodeList SharedAddress resource property.
The nodes in the AuxNodeList list can host the set of logical hosts that is associated with the shared address resource. However, these
nodes cannot serve as the primary node during a failover.
-z zone
--zone zone
Applies the same zone name to all nodes in a node list for which a zone is not explicitly specified. You can specify this option only
with the -n option.
OPERANDS
The following operands are supported:
resource Specifies that the Sun Cluster resource names should be accepted as operands. If the subcommand accepts more than one
resource, you can use the plus sign (+) to specify all shared address resources.
EXIT STATUS
If the command is successful for all specified operands, it returns zero (CL_NOERR). If an error occurs for an operand, the command pro-
cesses the next operand in the operand list. The returned exit code always reflects the error that occurred first.
This command returns the following exit status codes:
0 CL_NOERR
No error
The command that you issued completed successfully.
1 CL_ENOMEM
Not enough swap space
A cluster node ran out of swap memory or ran out of other operating system resources.
3 CL_EINVAL
Invalid argument
You typed the command incorrectly, or the syntax of the cluster configuration information that you supplied with the -i option was
incorrect.
6 CL_EACCESS
Permission denied
The object that you specified is inaccessible. You might need superuser or RBAC access to issue the command. See the su(1M) and rbac(5)
man pages for more information.
9 CL_ESTATE
Object is in wrong state
You tried to modify a property, a resource group, or other object that you cannot modify at that particular time or at any time.
10 CL_EMETHOD
Resource method failed
A method of a resource failed. The method failed for one of the following reasons:
o The validate method failed when you tried to create a resource or modify the properties of a resource.
o A method other than validate failed when you tried to enable, disable, or delete a resource.
15 CL_EPROP
Invalid property
The property or value that you specified with the -p, -y, or -x option does not exist or is not allowed.
35 CL_EIO
I/O error
A physical input/output error has occurred.
36 CL_ENOENT
No such object
The object that you specified cannot be found for one of the following reasons:
o The object does not exist.
o A directory in the path to the configuration file that you attempted to create with the -o option does not exist.
o The configuration file that you attempted to access with the -i option contains errors.
39 CL_EEXIST
Object exists
The device, device group, cluster interconnect component, node, cluster, resource, resource type, or resource group that you specified
already exists.
These exit values are compatible with the return codes that are described in the scha_calls(3HA) man page.
EXAMPLES
Example 1 Creating a Shared Address Resource
This command creates a resource that is named sharedhost1 in a resource group that is named rg-failover. The resource is created in the
enabled state, with monitoring enabled.
# clressharedaddress create -g rg-failover sharedhost1
Example 2 Creating a Shared Address Resource With a Different Logical Host Name
This command creates a resource named rs-sharedhost1 in a resource group that is named rg-failover.
The logical host name is not the same as the resource name, but the name and IP address of the logical host remain the same.
# clressharedaddress create -g rg-failover
-h sharedhost1 rs-sharedhost1
Example 3 Specifying the IPMP Groups for a Shared Address Resource
This command sets the IPMP groups for the sharedhost1 resource.
# clressharedaddress create -g rg-failover
-N ipmp0@black,ipmp0@white sharedhost1
Example 4 Deleting a Shared Address Resource
This command deletes a resource that is named sharedhost1.
# clressharedaddress delete sharedhost1
Example 5 Listing Shared Address Resources
This command lists all shared address resources.
# clressharedaddress list
sharedhost1
sharedhost2
Example 6 Listing Shared Address Resources With Resource Groups and Resource Types
This command lists all shared address resources with their resource groups and resource types.
# clressharedaddress list -v
Resources Resource Groups Resource Types
--------- --------------- --------------
sharedhost1 rg-failover-1 SUNW.SharedAddress
sharedhost2 rg-failover-2 SUNW.SharedAddress
Example 7 Listing Extension Properties of Shared Address Resources
This command lists the extension properties of all shared address resources.
# clressharedaddress list-props -v
Properties Descriptions
---------- ------------
NetIfList List of IPMP groups on each node
AuxNodeList List of nodes on which this resource is available
HostnameList List of hostnames this resource manages
CheckNameService Name service check flag
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWsczu |
+-----------------------------+-----------------------------+
|Interface Stability |Evolving |
+-----------------------------+-----------------------------+
SEE ALSO
Intro(1CL), cluster(1CL), clresource(1CL), clreslogicalhostname(1CL), clresourcegroup(1CL), clresourcetype(1CL), scha_calls(3HA), clconfig-
uration(5CL), rbac(5), r_properties(5)
NOTES
The superuser user can run all forms of this command.
Any user can run this command with the following options:
o -? option
o -V option
To run this command with subcommands, users other than superuser require RBAC authorizations. See the following table.
+-----------+---------------------------------------------------------+
|Subcommand | RBAC Authorization |
+-----------+---------------------------------------------------------+
|create | solaris.cluster.modify |
+-----------+---------------------------------------------------------+
|delete | solaris.cluster.modify |
+-----------+---------------------------------------------------------+
|disable | solaris.cluster.admin |
+-----------+---------------------------------------------------------+
|enable | solaris.cluster.admin |
+-----------+---------------------------------------------------------+
|export | solaris.cluster.read |
+-----------+---------------------------------------------------------+
|list | solaris.cluster.read |
+-----------+---------------------------------------------------------+
|list-props | solaris.cluster.read |
+-----------+---------------------------------------------------------+
|monitor | solaris.cluster.admin |
+-----------+---------------------------------------------------------+
|reset | solaris.cluster.admin |
+-----------+---------------------------------------------------------+
|set | solaris.cluster.modify |
+-----------+---------------------------------------------------------+
|show | solaris.cluster.read |
+-----------+---------------------------------------------------------+
|status | solaris.cluster.read |
+-----------+---------------------------------------------------------+
|unmonitor | solaris.cluster.admin |
+-----------+---------------------------------------------------------+
Sun Cluster 3.2 31 Jul 2007 clressharedaddress(1CL)