Nodes

The Nodes Object is a container for the Node Object for the associated cluster.

Description

class arcapix.fs.gpfs.nodes.Nodes

A collection of Node objects

Instantiate a collection of the nodes on the cluster.

get(k[, d]) → D[k] if k in D, else d. d defaults to None.
new(name, quorum_candidate=False, manager_candidate=False, admin_name=None)

Create a Node object, representing a particular NSD or similar within the system.

Parameters:
  • name
  • quorum_candidate
  • manager_candidate
  • admin_name
destroy(name)

Remove a node from the cluster

Parameters:name (str) – Name of the node to remove

Note - node deleting is an asynchronous process.

minQuorumNodes

Returns the minimum number of nodes required to achieve quorum.

Return type:int
tiebreakerDisks

Returns whether tiebreak disks are in use

Return type:bool

Warning

In certain situations, this will not be wholly accurate due to an issue with GPFS itself that IBM are aware of and will be providing a fix in the future.

nodesUp

Returns the number of nodes that are up

Return type:int
localNode

Returns the node on which the api is running

Return type:Node
serverLicensed()

Returns a convenience view over the Nodes collection of only those nodes with a server license

Return type:dict
incorrectlyLicensed()

Returns a convenience view over the Nodes collection of only those nodes which are not correctly licensed

Return type:dict
clientLicensed()

Returns a convenience view over the Nodes collection of only those nodes with a server license

Return type:dict
fpoLicensed()

Returns a view over the Nodes collection of only those nodes with a server license

Return type:dict
changeLicenses(licenseType, *nodes)

Change the license type of a node or collection of nodes

Parameters:
  • licenseType (str) – The type of license - either fpo, server or client
  • nodes (str or Node) – one or more nodes to change

Examples

Utilising Nodes from the Cluster Object

>>> from arcapix.fs.gpfs import Cluster
>>>
>>> # Load the cluster
... mycluster = Cluster()
>>>
>>> for n in mycluster.nodes.values():
...     print "Name: {0}\tState: {1}".format(n.name, n.state)
...
Name: pixstor-sn-001 State: active
Name: pixstor-sn-002 State: active

Utilising Nodes directly

>>> from arcapix.fs.gpfs import Nodes
>>>
>>> # Show the minimum number of nodes required for quorum
... print Nodes().minQuorumNodes

Change the licenses of 2 nodes

>>> from arcapix.fs.gpfs import Cluster
>>>
>>> # Load the cluster nodes
... mynodes = Cluster().nodes
>>>
>>> # Change nodes to server license
... mynodes.changeLicense('server', 'pixstor-sn-001', 'pixstor-sn-002')