CLI Cluster Methods

Contents
casso10
Contents
AddServer Method Adds a Server to the Cluster
The AddServer method adds a server to the cluster.
Syntax
The AddServer method has the following format:
Netegrity::PolicyMgtCluster->AddServer(Host, Port)
Parameters
The AddServer method accepts the following parameters:
  1. Host
    (string)
    Specifies the host IP address.
  2. Port
    (int)
    Specifies the server port.
Return Value
The AddServer method returns one of the following values:
  • A PolicyMgtServer object
  • undef
    if the call was unsuccessful
Remarks
The servers in a cluster are referenced in an array. When you add a server to a cluster, it is added to the end of the server array.
Due to dynamic load balancing, in which requests are sent to the highest-capacity available server in the cluster, the order in which servers are added to the cluster does not matter.
To add a non-clustered server to a host configuration, call the PolicyMgtHostConfig->AddServer method.
GetAllServers Method Retrieves an Array of All the Servers in a Cluster
The GetAllServers method retrieves an array of all the servers in the cluster.
Syntax
The GetAllServers method has the following format:
Netegrity::PolicyMgtCluster->GetAllServers( )
Parameters
The GetAllServers method accepts no parameters.
Return Value
The GetAllServers method returns one of the following values:
  • An array of PolicyMgtServer objects
  • undef
    if the call was unsuccessful
Remarks
To retrieve the servers that are not members of clusters, call the PolicyMgtHostConfig->GetAllServers method.