clusterEnableServer

This method is used to re-enable a cluster member. This process may be asynchronous if Session Clustering is used. If this is the case, the initial operation will return an HTTP 202 response. This action is idempotent, and running it on an enabled server will result in a 200 OK response with no consequences. On a Zend Server Cluster Manager with no valid license this operation fails.

 

 

Required Permissions: full

HTTP method: POST

Supported by Editions: Zend Server Cluster Manager

Request Parameters:

Parameter

 Type

Required

Description

serverId

String

Yes

The server ID

 

Expected Response Code:

Response Type: serverInfo with the status of the server being enabled.  Status is expected to be either startingUp if the server is in the process of re-joining the cluster, or any other active status (OK, pendingRestart, misconfigured, extensionMismatch, daemonMismatch, notResponding) if the process was completed.

Possible Action Specific Error Codes:

HTTP Code

 Error Code

Description

404

noSuchServer

There is no server with the provided server ID.

500

cantConnectToServer

Zend Server Cluster Manager is unable to connect to the specified server.

500

invalidServerResponse

An invalid or unexpected response from the server.

503

temporarilyLocked

The server cannot be disabled because another server in the cluster is performing a graceful startup/shutdown.

405

notImplementedByEdition

The method is not implemented by this edition of Zend Server.

500

serverNotLicensed

Zend Server Cluster Manager is not licensed.

 

Usage Example

Example:

Request (headers removed for clarity):

POST /ZendServerManager/Api/clusterEnableServer
serverID=5

Response:

HTTP/1.0 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<zendServerAPIResponse xmlns="http://www.zend.com/server/api/1.0">
    
  <requestData>
    <apiKeyName>angel.eyes</apiKeyName>
    <method>clusterEnableServer</method>
  </requestData>
  
  <responseData>
    <serverInfo>
      <id>5</id>
      <name>www-02</name>
      <address>https://www-02.local:10082/ZendServer</address>
      <status>pendingRestart</status>
      <messageList />
    </serverInfo>
  </responseData>
</zendServerAPIResponse>

 

 

 

Related Links

Related Links:

Server and Cluster Management Methods