getResourceInfo

Gets the cluster resource information. See Section A.3.1, Cluster Configuration Commands.

Request

 <ncsRequest>
   <clusterConfig>
     <getResourceInfo>
       <typeOfInfo>
         <scriptInfo/>
         <policyInfo/>
         <preferredNodeInfo/>
         <protocolInfo/>
       </typeOfInfo>
       <name>
     </getResourceInfo>
   </clusterConfig>
 </ncsRequest>  
 

Reply

 <ncsReply>
   <clusterConfig>
     <getResourceInfo>
       <resourceType>
         <pool/>
         <resource/>
         <template/>
         <masterIP/>
       <resourceType>
       <scriptInfo>
         <unloadScript>
           <script>
           <timeout>
         </unloadScript>
         <loadScript>
           <script>
           <timeout>
         </loadScript>
       </scriptInfo>
       <policyInfo>
         <followMaster/>
         <ignoreQuorum/>
         <startMode>
           <manual/>
           <auto/>
         </startMode>
         <failoverMode>
           <manual/>
           <auto/>
         </failoverMode>
         <failbackMode>
           <manual/>
           <auto/>
           <disable/>
         </failbackMode>
       </policyInfo>
       <preferredNodeInfo>
         <unassignedNodes>
         </unassignedNodes>
         <preferredNodes>
           <node>
         </preferredNodes>
       </preferredNodeInfo>
       <protocolInfo>
         <virtualServerName>
         <cifsServerName>
         <ipAddress>
         <afp/>
         <ncp/> 
         <cifs/>
       </protocolInfo>
     </getResourceInfo>
   </clusterConfig>
 </ncsReply>  
 

Elements

typeOfInfo

(Optional) If omitted, all information is returned. Otherwise, the information is divided in categories of information and identifies which categories you want to get as specified below:

Values

Description

scriptInfo

(Optional) If present, gets the script information.

policyInfo

(Optional) If present, gest the policy information.

preferredNodeInfo

(Optional) If present, gets the preferred nodes information.

protocolInfo

(Optional) If present, gets the protocol info.

name

Name of the cluster resource.

Value

Description

description

A text description for the result.

resourceType

Information is returned for the following types of resources:

Values

Description

pool

The cluster pool resource.

resource

The cluster resource.

template

The cluster template.

masterIP

The master IP address resource.

scriptInfo

Optional script information for unloading or loading a resource:

Values

Description

unloadScript

  • script
  • timeout

The script contents and amount of timeout allocated for unload.

loadScript

  • script
  • timeout

The script contents and amount of timeout allocated for load.

policyInfo

Optional policy information for managing the cluster:

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 value to start a resource manually or automatically on cluster startup.

failoverMode

  • manual
  • auto

Optional value to failover a resource manually or automatically.

failbackMode

  • manual
  • auto
  • disable

Optional value to failback a resource manually or automatically or to disable it.

preferredNodeInfo

Optional list of unassigned and assigned node names:

Values

Description

unassignedNodes

  • node

List of unassigned node names.

preferredNodes

  • node

List of assigned nodes, from most preferred to least preferred.

protocolInfo

Optional server protocol values:

Values

Description

virtualServerName

Name of virtual NCP server.

cifsServerName

If cifs is present, NetBios name of virtual CIFS server.

ipAddress

IP address of virtual server.

afp

(Optional) If present, AFP advertizing is enabled.

ncp

(Optional) If present, NCP advertizing is enabled.

cifs

(Optional) If present, CIFS advertizing is enabled.