Programming Guides › Programming Guide for Perl › CLI Policy Management Methods › CLI Cluster Methods

CLI Cluster Methods

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:

Host (string)

Specifies the host IP address.

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.