(WHM >> Home >> Clusters >> Configuration Cluster)
|Table of Contents|
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.
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.
The server's IP address, or the name that you assigned to the server (for example,
The username of the server's
|Remote Access Key|
The signature version of the server's remote access key or API token.
Add a server
To add a server to the configuration cluster, perform the following steps:
- Click Create at the top right or bottom right corner of the interface.
Enter the server name in the Server text box.
Note title Notes:
- We recommend that you use the server's hostname.
- You cannot modify the server name after you add a server to the configuration cluster.
Enter the server's
root-level account username in the User text box.
Note title Note:
This value defaults to the
- Paste the server's remote access key or API token in the Remote Access Key text box.
You can generate a remote access key in WHM's Remote Access Key interface (WHM >> Home >> Clusters >> Remote Access Key).
Tip title Remember: Include Page LIB:_RemoteAccessKeyDeprecated LIB:_RemoteAccessKeyDeprecated
- You can generate an API token in WHM's Manage API Tokens interface (WHM >> Home >> Development >> Manage API Tokens).
- Click Save. The server will appear in the configuration cluster servers table.
Edit a server's remote access key or API token
To modify the remote access key or API token for a server in the configuration cluster, perform the following steps:
- Click the arrow icon ( ) that corresponds to the server for which to modify the remote access key or API token.
- Make any desired changes in the User text box.
Make any desired changes in the Remote Access Key text box.
Note title Note:
The Remote Access Key text box displays either the current access key's signature or API token. However, you must enter the entire remote access key or API token to make changes.
- Click Save.
Delete a server
To remove a server from the list of the configuration cluster's servers, perform the following steps:
- Click the trash icon ( ) that corresponds to the server that you wish to delete.
- A confirmation window will appear. Click Continue.
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.