Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
titleClick here to see client management screenshots...

Installing cPanel

...

To install the cPanel module, visit [Settings] > [Company] > [Modules] > Available

...

, and click the "Install" button

...

for cPanel

...

.

Tip

When the module is installed, it should automatically load the "Manage" screen for the module. You can get back here any time by visiting [Settings] > [Company] > [Modules] > Installed and by clicking the "Manage" button for the module.

cPanel Overview

The "Manage" screen displays an overview of all of your cPanel servers and server groups, and lists all servers and server groups that are configured for cPanel.

Image Removed

Adding a cPanel/WHM Server

  1. From the "Manage" screen, click the "Add Server" button.
  2. Fill out the following options and  click the "Add Server" button:

Image Added

A message will be displayed, indicating that the module was successfully installed. Then click the "Add Server" button.

Image Added

Enter the details for your cPanel/WHM server.

Image Added

Image Added

Field NameDescription
Server LabelEnter a label for this cPanel/WHM server, it can be anything you like.
HostnameEnter the FQDN hostname for
OptionDetails
Server LabelA friendly name for this server, i.e. "Server 1".
HostnameThe hostname of your cPanel/WHM server, i.e. ie "server1.hostnamedomain.com".
User NameEnter your WHM username. This is the username you would log into WHM withThe username associated with your WHM login credentials.
Remote KeyThe

Enter your WHM server remote key

found

. This can be obtained in WHM under

Cluster/Remote Access >

"Setup Remote Access Key".

Use SSL ...when connecting to the APICheck Select this option to send API requests over SSL (recommended)use SSL for all API requests to your WHM server. This is highly recommended.
Account LimitThe Enter the maximum number of cPanel accounts that should be created. Leave blank for unlimited.added to this cPanel/WHM server.
Name ServersEnter the name servers that should be used , tags for these are included in for this server. These will be available to the package welcome email .

Any number of name servers may be added.

NotesAny internal notes pertaining to this server.

 

Image Removed

Adding a Server Group

...

to the client.
NotesEnter any notes that pertain to this server for future reference.

After filling out these options, click "Add Server" to add your cPanel/WHM server.

Server Groups

Server groups are useful for categorizing cPanel servers. When creating a Package, a specific server, or a server group may be selected for provisioning. Blesta will automatically select a cPanel server to provision with when a server group is chosen.

To add a server group, from the cPanel overview at  [Settings] > [Company] > [Modules] > cPanel, click "Add Server Group", then enter the details.

Image Added

...

OptionDetails
Group Name

A friendly Enter the name for this server group.

Add OrderChoose how servers in this group will be selected for provisioning. Currently, first non-full server is the only add order.
Assigned ServersSelect servers under "Available Servers" and click to move them to the left column to add them to the group.

 

...

Welcome Email

When creating or editing a package that uses this module, the following tags will be available:

...