ImportAssist
ImportAssist is a tool that migrates data from external systems into a WHMCS installation.
In addition to importing data from another WHMCS instance, ImportAssist can also import from a range of other web based billing applications.
Contents
Download ImportAssist
ImportAssist is available via the WHMCS Marketplace. To download it, visit the ImportAssist Marketplace listing.
Installation
To install ImportAssist, perform the following steps:
- Unzip the ZIP file that you downloaded.
- Upload the import_assist directory to /modules/addons.
- Log in to the WHMCS Admin Area.
- Go to Configuration () > System Settings > Addon Modules or, prior to WHMCS 8.0, Setup > Addon Modules.
- Perform the displayed steps to complete activation.
- Grant your admin role permission to access it post-activation.
Using ImportAssist
You can access activated installations of ImportAssist by navigating to Addons > ImportAssist for WHMCS.
The system will then guide you through performing a data migration.
We recommend taking a full backup of your WHMCS database before performing any import. This will allow you to revert your changes in case of problems.
Supported Scripts and Versions
WHMCS ImportAssist supports importing data from the following applications and versions:
- WHMCS Versions 6.2.x, 6.3.x, 7.0.x, 7.1.x, 7.2.x, 7.3.x, 7.4.x, 7.5.x, 7.6.x, 7.7.x, 7.8.x, 7.9.x, 7.10.x, 8.0x, v8.1.x, 8.2.x
- Blesta Versions 2.x, 3.x, 4.x
- ClientExec Versions 5.3, 5.4, 5.5, 5.6, 5.7, 5.8, 5.9, 6.x
- HostBill Versions 2016 and later
While performing imports from other software versions may be possible, use of these versions is unsupported.
What will Import
The data that can be migrated varies:
WHMCS 6.2 - 7.7
WHMCS 7.8 - 7.10
WHMCS 8.0+
Blesta 2.x
Blesta 3.x, 4.1
ClientExec
HostBill
Troubleshooting
In the unlikely event of an import failure, download a copy of the Import Log. The Import Log is available to download during and after the import process.
For help with any problems, send us the Import Log in a Technical Support ticket describing the issue.
Unable to connect to the database
This error indicates that ImportAssist cannot establish a connection to the source database from which the data is being imported. Check the following points to resolve this error:
- Valid database connection details exist in ImportAssist. If they are not up-to-date, correct them.
- The database host is valid relative to the WHMCS installation that is using ImportAssist. If the source database is located on the same server, try using localhost or 127.0. 0.1.
- If the source data is remote, ensure that remote MySQL® access is permitted on the source server.
- The MySQL service on the source server is online and remotely accessible.
- The specified MySQL user has been assigned to the desired database and given full access to it.