Base de Conhecimento

Overview:

The Configuration Cluster interface allows you to link a master server to one or more additional servers in the configuration cluster. You can then choose to copy server configuration settings from WHM’s Update Preferences interface (WHM >> Home >> Server Configuration >> Update Preferences) to the configuration cluster’s servers.

Configuration Cluster

Before you set up a configuration cluster in the Configuration Cluster interface, log in as a root-level user on the server that you wish to use as the master server. You must also log in to the master server as a root-level user to make any configuration changes that you want to copy to the configuration cluster’s servers.

The Configuration Cluster interface displays a list of all of the servers that you linked to the currently-authenticated server.

• Server — The server’s IP address, or the name that you assigned to the server (for example, example.com).

  Important:

  You can use any other domain name that resolves to the server’s IP address for this value. However, to prevent problems if you migrate domains to another server, we recommend that you use the server’s hostname.

• User — The username of the server’s root-level account. This value defaults to the root user.

• API Token or Remote Access Key — The signature version of the server’s remote access key or API token.

  Remember:

  We deprecated WHM’s Remote Access Key feature in cPanel & WHM version 64. We strongly recommend that you use API tokens instead.

Add a server

To add a server to the configuration cluster, perform the following steps:

1. Click Create at the top right or bottom right corner of the interface.
2. Enter the server name in the Server text box.
3. Enter the server’s root-level account username in the User text box.
4. Paste the server’s remote access key or API token in the API Token or Remote Access Key text box.
   • You can generate an API token in WHM’s Manage API Tokens interface (WHM >> Home >> Development >> Manage API Tokens).
   • You can generate a remote access key in WHM’s Remote Access Key interface (WHM >> Home >> Clusters >> Remote Access Key).
     Remember:

     We deprecated WHM’s Remote Access Key feature in cPanel & WHM version 64. We strongly recommend that you use API tokens instead.
5. Click Save. The server will appear in the configuration cluster servers table.

Edit a remote access key or API token for a server

To modify the remote access key or API token for a server in the configuration cluster, perform the following steps:

1. Click the arrow icon () that corresponds to the server for which to modify the remote access key or API token.
2. Make any desired changes in the User text box.
3. Make any desired changes in the API Token or Remote Access Key text box.
4. Click Save.

Delete a server

To remove a server from the list of the configuration cluster’s servers, perform the following steps:

1. Click the trash icon () that corresponds to the server that you wish to delete.
2. A confirmation window will appear. Click Continue.
   Note:

   When you delete a server from the list of configuration cluster servers, the settings that you already applied to that server remain in place. The master server will not relay any new changes, and will not overwrite changes that you make on the previously-linked server.