View source for Cluster.locate


'''cluster.locate''' is used to locate or allocate a resource on cluster nodes.

===Mandatory parameters===

;nodename
:    name of the node requesting the operation 
;callto
:    target resource whose node is to be located 

===Optional===

;allocate
:    set to true to allocate a new node for the callto resource if it cannot be located 
;billid
:    billing ID of the incoming call that triggered the resource location request 
;username
:    user ID of the incoming call leg, if any 

===Return value===

A module should acknowledge the message if the node was located or allocated. The returned text value is the node name. If the message returns false then the node was not found and was not allocated.