Cpanel to Eenos Migration tool ( cptoeenos a.k.a cp2eenos)

This is a tool to convert Cpanel accounts and whm hosting packages into Eenos backup format so that you can easily migrate from the Cpanel server to the Eenos control panel.

Introduction

Cpanel to Eenos Migration

This tool provides conversion of cpanel hosting accounts into  Eenos backup. This tool also converts the WHM packages into Eenos packages. cptoeenos is a full cpanel account conversion tool.

It is safe to install and use cptoeenos in your production Cpanel server. This tool doesn't make changes to server data or files. It will only copy the required data to the chosen destination. So it is always safe to use the tool in your production servers.

Features of cptoeenos  a.k.a cp2eenos

You can perform the following tasks with cptoeenos tool:

cptoeenos is a Gpl v3 software. Please feel free to use, modify share, and distribute

What is included with the conversion?

The cp2eenos tool will convert the following data from your cpanel server or cpanel backup.

Installation

How to to install cptoeenos a.k.a cp2eenos?

The cptoeenos (cp2eenos) tools are fully developed using Python. You can install it on any Linux-compatible server with Python3  installed.  Your server needs Python3 version 3.6 or higher to use it.

To install cptoeenos run the following command from the shell:

pip  --no-cache-dir install --extra-index-url https://pip.eenos.com/ cptoeenos

You can also use the pip3 command too :

pip3  --no-cache-dir install --extra-index-url https://pip.eenos.com/ cptoeenos

This will install all required packages for cptoeenos. After installing the tools you may use the command cptoeeenos or cp2eenos to start converting.

cptoeenos / cp2eenos command options :

The following command options are available with this tool.

Command(s):
  -f, --full            Convert all Cpanel accounts and hosting packages
  -u user, --user user  Convert a single Cpanel user/reseller account 
  -b backup_file, --backupfile backup_file
                        Convert a Cpanel backup file( .tar , .tar.gz)
  -p, --packages        Convert all WHM hosting packages

Backup convert option(s):
  --skipmysql           Exclude MySQL database(s)
  --skippgsql           Exclude PgSQL database(s)
  --skiphomedir         Exclude Homedir
  --skipemail           Exclude Email accounts 
  --skipresellerconfig  Exclude reseller privileges

Upload Option(s):
  -s path_to_store, --saveto path_to_store
                        A folder location to save the converted backups 

Option(s):
  -h, --help            show this help message and exit
  -d, --demon           Run convert process as daemon service
  -w workdir, --workdir workdir
                        A folder to generate temporary backup files,
                         Working directory : Default /root
  -pu path_to_script, --postupload path_to_script
                        A script path name to run after conversion.
                        You can use a bash script to upload the
                        converted backups to remote server.
Installing from source

You can install cptoeenos from the source.  You may download the installation source from the Cp2Eenos Download Server

The sample command is as follows,

wget -c https://download.eenos.com/tools/cptoeenos/cptoeenos-1.0.0.tar.gz

Now  Build the  source as follows,

tar -xvzf cptoeenos-1.0.0.tar.gz
cd cptoeenos/
./autobuild.sh

Now install the Python packages as follows,

pip3 install dist/cptoeenos-1.0.0-py3-none-any.whl

This will install the cptoeenso tools.

How to Migrate Cpanel to Eenos

Start migration from Cpanel to Eenos

Some sample conversion commands and syntax are given below:

Convert a Cpanel backup file to an Eenos Backup file

You can convert a cpanel backup file to an Eenos backup file. The cpanel backup file must be a .tar or .tar.gz file.

This operation can be performed from any server, there is no need for cpanel installed. You only need to cptoeenos tool.

Syntax:

cptoeenos --saveto /path-to-save-converted-backup --backupfile /path-to-cpanel-account-backup-file

Where,

Example:

If we are going to convert a cpanel backup name backup-10.14.2023_16-20-05_mycpuser.tar.gz and store the converted backup into the folder /backup. The command is as follows:

cp2eenos --saveto /backup --backupfile /home/backup-10.14.2023_16-20-05_mycpuser.tar.gz

This will generate a backup on /backup/eenosbkp-myuser.tar.gz. You may upload this backup file to your  Eenos server and restore it.

To know how to restore a backup in the Eenos Control Panel, please check the restoration documentation.

Convert WHM Hosting Packages to Eenos Hosting Packages

The migration of whm hosting packages to Eenos hosting packages is easy.

You need to install cptoeenos in your Cpanel server to perform this task.

Please use the following command to convert WHM hosting packages.

cptoeenos --saveto /backup --packages

This will convert all your hosting packages from whmcs server and place them into a folder named EenosHostingPackages inside your saved path.

Here the converted package location will be in /backup/EenosHostingPackages

You may now copy or upload  all .yaml files from this folder into /var/eenos/packages/ of your Eenos server

Please make sure to change ownership of all files inside /var/eenos/packages/  will have the eenos user ownership

chown eenos:eenos /var/eenos/packages/*

If the WHM package name contains white spaces or dots, it will be replaced with a hyphen in Eenos during the package conversion.

Convert Cpanel Account

You can convert a Cpanel live account into an Eenos backup file.

You need to install cptoeenos in your Cpanel server to perform this task.

Syntax:

cp2eenos --saveto /backup --user cpusername

Where,

The above command will generate an Eenos-compatible backup of the user cpusername and place it into the location /backup/eenosbkp-cpusername.tar.gz

You may upload this backup file to your Eenos server and restore it.

It is safe to install and use cptoeenos in your production Cpanel server. This tool doesn't make changes to server data or files. It will only copy the required data to the chosen destination. So it is always safe to use the tool in your production servers.

Convert the  Whole Cpanel Server

You can convert all Cpanel accounts and whm hosting packages from your Cpanel server with a simple command.

Syntax:

cp2eenos --saveto /backup  --full

This command will perform the following actions:

Running Conversion in Server Background

You can run any conversion command in the server backup ground using the flag --demon or -d

Example: Run the full server conversion in the server background

cp2eenos --saveto /backup  --full --demon
Automatic upload of converted backups into a remote server

You can attach a post-upload script for the conversion process so that your script will be executed after the backup conversion. This will help you to run automatic upload of converted backups to your remote  Eenos server.

To run a post-upload script, you may use the  flag --postupload path_to_script or -pu path_to_script

where,

This script will be provided with one command line argument which is the backup saved path.

Example : 

Convert the whole cpanel accounts and WHM packages then upload to a remote server using my post upload script /root/postupload.sh

cp2eenos --saveto /backup  --full --demon --postupload /root/postupload.sh

The conversion process will run in the server background and execute the post-upload script soon after finishing the cpanel account conversion process. 

CptoEenos Log Files

All conversion tasks will be logged to the file /var/log/cptoeenos.log  

For non-root users, the log file will be: $HOME/cptoeenos.log  

Change Logs

The cptoeenos Change Logs and  Release Note


V 1.0.0 

Release Date:  27/10/2023

Released the first version of cptoeenos with the following  features: