Changing Cluster Configurations

Cluster configurations determine the behavior of all the servers that were added to the cluster. When changing a setting in a cluster, such as changing a directive's value or loading an extension, and all the servers in the cluster will be modified accordingly once your PHP is restarted .

For more information on working with a Zend Server cluster, watch this video:

This procedure describes how to change your entire cluster's configuration. In a cluster, any changes that you do are applied to all the servers in your cluster without exception.

Instructions on how to complete a procedure

To change a cluster configuration:

  1. In the UI, edit your settings as necessary.
  2. If the change requires a restart (e.g., Zend component directive change), in the Toolbar, the restart icon lights up , indicating a restart is needed to apply changes. Click to restart server and apply changes.

The changes will be applied to all the servers belonging to the cluster.

These procedures describe how to apply or revert external changes made to the settings of a single cluster server via the file system. If applied, the new settings are applied on all the servers in the cluster. If reverted, the new settings are reverted to the current cluster configuration.

Applying the Changes to the Cluster

After making an external change to the server settings via your file system, the Notification Center will notify you of an existing configuration mismatch. This procedure describes how to apply this change to all the servers in the cluster.

Instructions on how to complete a procedure

To apply changes to the entire cluster:

  1. In the UI, go to Servers | Manage Servers.
  2. From the Servers list, select the server you made changes to, and under the Actions column (the Message column for the server will display the configuration change), click .
  3. Click OK when prompted, to confirm the action.
    The changes are applied. In the Servers list, the server status changes to pending restart .
  4. In the toolbar, the restart icon lights up , indicating a restart is needed to apply changes. Click to restart the servers in the cluster and apply your changes.

 

Reverting the Changes to Cluster Configurations

After making an external change to the server settings via your file system, the Notification Center will notify you of an existing configuration mismatch. This procedure describes how to revert your changes to the cluster configurations.

Instructions on how to complete a procedure

To revert changes to cluster configurations:

  1. In the UI, go to Servers | Manage Servers.
  2. From the Servers list, select the server you would like to revert changes to (the Message column for the server will display the configuration change), and under the Actions column, click .
  1. Click OK when prompted, to confirm the action.
    The changes are reverted. In the Servers list, the server status changes to pending restart .
  2. In the toolbar, the restart icon lights up , indicating a restart is needed to apply changes. Click to restart the servers in the cluster and apply your changes.

 

If you are planning to make comprehensive changes, and you are not sure what the outcome will be in terms of performance and behavior, or you want to make changes to a cluster running a PHP application in production, the safest alternative is to manually apply the changes on a staging server, test it, and then export the changes to your cluster using the Zend Server Import/Export feature.

Instructions on how to complete a procedure

To import configurations to your cluster:

  1. In the UI of your staging server, go to Administration | Import/Export.
  2. In the Export area, click Export Configurations.
  3. Select the file location for exporting the staging PHP and system configurations, and click Save.
    Your configurations are exported and saved as a .zip file at the selected location.
  4. In the UI of one of your cluster servers, go to Administration | Import/Export.
  5. In the Import area, click Browse, and select the file containing the exported system configurations.
  6. Click Upload.
  7. In the toolbar, the restart icon lights up , indicating a restart is needed to apply changes. Click to restart the servers in the cluster and apply your changes.
    The system configurations are uploaded to your cluster.

You can also export your current settings for future use, as a back-up or for copying into another working environment. For more information, see Backing Up and Restoring Settings.