CPanel/WHM Import

From WHMCS Documentation

Revision as of 14:19, 13 October 2011 by John (talk | contribs) (Created page with 'The WHM Import Tool can be accessed using the Utilities menu. This will allow you to import all the domains from your existing cPanel/WHM servers. It can save hours of time and…')
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

The WHM Import Tool can be accessed using the Utilities menu. This will allow you to import all the domains from your existing cPanel/WHM servers. It can save hours of time and is very easy to use. Here is how:

WHM Import List
  1. You must first ensure you have setup the server you wish to import accounts from in Setup > Servers
  2. Next, go to Utilities > WHM Import Script
  3. Now choose the server you want to import accounts from in the dropdown box
  4. A list of the accounts on that server will now be displayed
  5. From here you can select the accounts you wish to import - it will highlight domains that already exist in your WHMCS system so you don't create duplicates - and you can select all the accounts in one go by clicking the checkbox in the header row
  6. Then simply click the Import button at the bottom of the page an the accounts will be imported

The information cPanel stores is very limited, for example it doesn't hold the clients name, the amount they pay or their next due date. So importing does require some manual work too but what can be imported (domain, username, server & package) does mean that all the cPanel account management functions are possible from WHMCS, for example Suspend/Unsuspend/Terminate/Upgrades/Downgrades & Password Resets.

Accounts created by the import process have their domains & usernames retrieved automatically from the server, as well as being assigned to the appropriate package and server within WHMCS. But due to no billing details being stored in cpanel, intially all accounts will be set to free and you will then need to go through and update the imported domains with the appropriate pricing, billing cycles, next due dates and client information.

Quite often you may find you need to move the domains around and group more than one domain to certain clients. To do this, see the Moving a Product/Service to another Client article in the Products Management section.

Common Problems

Import Failed

This error occurs when an account cannot be assigned to a package in WHMCS. This happens when there is no package setup for the WHM Package Name in WHMCS. Before performing an import, you must ensure you have setup all the packages in use on the server by accounts you are wanting to import on a package in WHMCS. To do this, go to Setup > Products/Services > Edit > Module Settings tab, and enter the WHM Package Name such as "demohost_Starter" in the Package Name field on the modules settings tab.