Skip to Content
Browse documentation

DirectAdmin Migration with datoeenos

Install the DirectAdmin converter, convert live users or supported backups, review da2eenos options and validate the resulting Eenos backups.

datoeenos and da2eenos invoke the same DirectAdmin converter. Use it for standalone backup conversion. For destination-driven live migration, see WAP DirectAdmin import.

Install and check

For live users, hosting packages or a whole-server conversion, install the tool on the source DirectAdmin server. To convert an existing backup archive, install it on the Eenos destination or another suitable Linux server.

Use Python 3 and its matching pip installer. The tool declares Python 3.6 or later; the selected release's dependencies must also support your Python version. Run the following installation command from the server shell as root. Include the Eenos package index:

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

If the Python 3 installer is named pip instead of pip3, use that name with the same arguments. Choose one installation command. The package name is datoeenos; installation provides both datoeenos and da2eenos commands.

Check the installed command and its supported options:

da2eenos --help

Live conversion needs root access to the DirectAdmin source and its data. Prepare private, existing work/output directories, sufficient extraction space and trusted backup copies. See common working rules.

Choose one conversion command

Replace the example username and paths. Create fresh private directories first and execute one command appropriate to the source.

Convert a copied DirectAdmin account backup:

da2eenos --backupfile /backup/user.admin.exampleuser.tar.gz --saveto /backup/da-run-01/output --workdir /backup/da-run-01/work

The current converter accepts .tar, .tar.gz and zstd-compressed backup input such as .tar.zst. Zstd conversion invokes /usr/bin/zstd and creates or replaces an adjacent decompressed tar file, then removes that temporary tar after extraction. Work from a backup copy, reserve space beside it and do not place an unrelated same-name tar there.

Convert one live DirectAdmin account:

da2eenos --user exampleuser --saveto /backup/da-run-02/output --workdir /backup/da-run-02/work

Convert all live accounts and packages:

da2eenos --full --saveto /backup/da-run-03/output --workdir /backup/da-run-03/work

Convert live hosting packages only:

da2eenos --packages --saveto /backup/da-run-04/output --workdir /backup/da-run-04/work

Options

OptionMeaning
-f, --fullConvert all live accounts and packages.
-u, --user USERConvert one live source account.
-b, --backupfile PATHConvert a supported backup file.
-p, --packagesConvert live hosting packages.
-s, --saveto DIRRequired existing output directory.
-w, --workdir DIRExisting temporary-work base directory.
--skipmysqlSkip MySQL data conversion.
--skiphomedirSkip home-directory data conversion.
--skipemailSkip email data conversion.
--skipresellerconfigSkip reseller configuration conversion.
-d, --demonDetach into background mode; use this exact spelling.
-pu, --postupload SCRIPTInvoke a script after conversion dispatch with the output directory.
-h, --helpShow installed options.

The reviewed DirectAdmin parser does not expose --skippgsql. Do not copy that option from the cPanel tool. Skipped components require a separate migration plan.

Review results

Root runs log to /var/log/datoeenos.log; non-root runs log to datoeenos.log in the invoking user's home. Check conversion errors, output archives, package files and the backup path reported in the log. Do not use exit status alone as proof that every component converted.

Current output uses DNSv2 and targets Eenos 5.0.1 or later. Review DNS records and address mappings, including IPv6; an absent source IPv6 address is not a reason to publish a loopback AAAA record. Check ownership and packages before restore.

Background mode and post-upload

Run a foreground test before using background mode. Detached execution still needs log and archive review.

The optional post-upload script receives the save directory and can run despite individual conversion failures. Use a trusted executable script with an absolute path without spaces or shell metacharacters. Have it validate the files it uploads and verify the uploaded copies separately.

Finish with restore on Eenos and verification before cutover.