Revision as of 09:57, 21 January 2011

Setting Up a Plesk Server

The following steps guide you through the process of setting up a server in WHMCS for Plesk Hosting Accounts.

1. Begin by going to Setup > Servers
2. Click Add New Server
3. Enter the server name, IP address, username and password as appropriate
4. Set the type to Plesk8, Plesk9 or Plesk10 if you have ADMIN or RESELLER access to the Plesk Panel, or choose Pleskreseller if you only have CLIENT access for Plesk
5. Custom Port: If you have a non-standard (8443) port for Plesk, you should enter the port number in the Access Hash section of the Server setup
6. Click Save Changes to complete the process and add your new server

Setting Up a Plesk Package

To setup a package for your Plesk server, go to Setup > Products/Services, proceed to the new product setup and enter the details such as name, pricing, etc... as normal Then on the Module Settings tab you should do the following:

1. Set the Module to Plesk or Pleskreseller matching what you used for the server
2. For a shared hosting account, enter both the Client Template and Domain Template names (Plesk 8 & 9 Only) or the Service Plan Name (for Plesk 10) - these must be entered exactly as setup inside Plesk where you configure the limits & permissions
3. For a reseller account, you must enter both the fields described above but also the Reseller Template name(Plesk 8 & 9 Only) or the Reseller Plan Name (for Plesk 10) to define the resellers limits & permissions.

Common Problems

The client account is getting setup but the domain is not

This is usually due to the permissions of the domain template exceeding the server resources or containing something such as ColdFusion support when the server doesn't support it. You should always test your domain template works directly in Plesk after setting it up if it is a new setup.

I get a blank command error from WHMCS when it tries to setup an account

This can occur if your firewall is blocking connections on port 8443. You need to open it on both the server WHMCS is on and the server WHMCS is connecting to for inbound and outbound connections.

Module Command Error: 1013 - Template does not exist

This error message is coming direct from the Plesk API. When configuring the product, you have to enter the client and domain template names. These are currently incorrect or missing so you will need to correct them in Setup > Products/Services on the Modules Settings tab when editing your product

1014 - Parser error: Request is invalid

This error message indicates there is a field value missing - this is most commonly caused by having no assigned IPs in the client or domain templates IP pool.

2306 - Domain adding was failed. Error: xxxxx template failed: Unable to apply limits

This error message comes direct from the Plesk API. It means that the template you are attempting to use exceeds your limits or has a feature your server doesn't support. You should try creating an account with the template inside Plesk itself as then you get more details about the problem.

With accounts created on my Plesk server from WHMCS the www. subdomain doesn't work

This happens due to the default DNS settings on a Plesk server and the requirement to tick a box when creating an account to enable it. To avoid that, simply follow the steps below.

1. Login to Plesk
2. Click "Server"
3. Click "DNS Settings"
4. Click "Add New Record"
5. Choose "CNAME" under record type
6. Enter "www" in "Enter Domain Name"
7. Enter "<domain>" in "Enter Canonical Name"
8. Hit OK to complete the changes

Module Command Error 1005 - Protocol version '1.6.0.0' not supported. Current protocol version is '1.5.2.1'

This error means the incorrect Plesk module has been selected. Version 4.3.1 and above includes separate modules for each version of Plesk, so for example if Plesk 8 is running on the server ensure the Plesk 8 module has been selected under Setup > Servers > Edit and Setup > Products/Services > Edit > Module Settings tab.

Versions 4.0.x - 4.2.x only support Plesk 9 as standard, please upgrade or contact support who can provide a Plesk 8 module.

Module Command Error 1014 - Parser error: Cannot parse the XML from the source specified

The Plesk API only supports the characters a-z 0-9. If the client's profile contains other characters, accents etc, it will cause account creation to fail. You should edit the client's profile to remove these characters.