createClusterResource

Request

 <ncsRequest>
   <clusterConfig>
     <createClusterResource>
       <resourceType>
         <pool/>
         <resource/>
         <template/>
       <resourceType>
       <name>
       <templateName>
       <onlineResource/>
       <scriptInfo>
         <unloadScript>
           <script>
           <timeout>
         </unloadScript>
         <loadScript>
           <script>
           <timeout>
         </loadScript>
         <monitorScript>
           <script>
           <timeout>
         </monitorScript>
       </scriptInfo>
       <monitorInfo>
         <monitorMode>
            <enabled/>
         </monitorMode>
         <frequency>60</frequency>
         <maxFailures>5</maxFailures>
         <failurePeriod>600</failurePeriod>
         <action>
           <comatose/>
         <action>
       </monitorInfo>
       <policyInfo>
         <followMaster/>
         <ignoreQuorum/>
         <startMode>
           <manual/>
           <auto/>
         </startMode>
         <failoverMode>
           <manual/>
           <auto/>
         </failoverMode>
         <failbackMode>
           <manual/>
           <auto/>
           <disable/>
         </failbackMode>
       </policyInfo>
       <preferredNodeInfo>
         <preferredNodes>
           <node>  
         <preferredNodes>
       </preferredNodeInfo>
       <protocolInfo> 
         <ipAddress>
         <afp/>
         <ncp/>
         <cifs/>
         <cifsServerName>
         <poolDistinguishedName/>
         <virtualServerName/>
       </protocolInfo>
     </createClusterResource>
   </clusterConfig>
 </ncsRequest> 
 

Reply

 <ncsReply>
   <clusterConfig>
     <createClusterResource>
       <result value=> 
         <description>
       </result>
     </createClusterResource>
   </clusterConfig>
 </ncsReply>
 

Elements

resourceType

(Optional) Defines what kind of cluster resource to create:

Resource Type	Description
pool	Specifies the cluster pool resource.
resource	Specifies the cluster resource.
template	Specifies the cluster resource template.

name

Name of the cluster resource.

templateName

(Optional) If resourceType=template, name of the template.

onlineResource

(Optional) If present, online the resource after creation.

scriptInfo

(Optional) Defines unload and load script information:

Script values	Description
unloadScript script timeout	Resource unload script contents and timeout amount.
loadScript script timeout	Resource load script contents and timeout amount.
monitorScript script timeout	Resource monitor script contents and timeout amount. Available only on Linux.

monitorInfo

(Optional) Defines monitor script information. Available on Linux only.

Script values	Description
monitorMode enabled disabled	Enables or disables the monitoring mode.
frequency	Monitors the resource every X seconds.
maxFailures	If there are a specified number of failures in a given amount of time, the resource will either migrate or go comatose.
failurePeriod	Length of time for failure, specified in seconds.
action migrate comatose	Action to take if maxium number of failures occurs.

policyInfo

(Optional) Defines the policy information:

Policy values	Description
followMaster	If present, resource always runs on cluster master node.
ignoreQuorum	If present, resource ignores quorum on cluster startup.
startMode manual auto	(Optional) Resource starts manually or automatically on cluster startup.
failoverMode manual auto	(Optional) Resource failover is manual or automatic.
failbackMode manual auto disable	(Optional) Resource failback is manual, automatic, or disabled.

preferredNodeInfo

(Optional) Provides list of ordered nodes, from most preferred to least preferred.

Node value	Description
preferredNodes node	List of nodes and node name.

protocolInfo

Values used to set the protocol information:

Protocol Values	Description
ipAddress	IP address of virtual server.
afp	(Optional) If present, enable AFP advertizing for virtual server.
ncp	(Optional) If present, enable NCP advertizing for virtual server.
cifs	(Optional) If presents, enable CIFS advertizing for virtual server. Element must include cifsServerName.
cifsServerName	NetBios name for CIFS virtual server.
poolDistinguishedName	Distinguished name of existing NSS Pool eDirectory object that is being cluster enabled by this operation.
virtualServerName	Name of virtual NCP server object to create in eDirectory.