Overview
Do not perform the steps in this document unless you are certain that your server’s userdata files are corrupt or do not exist. You should only perform these steps when no other method will resolve the issue.
In certain circumstances, your server’s userdata files (the files that the /var/cpanel/userdata/ directory contains for each account) may become corrupt, or may not exist. If this occurs, use the methods in this document to attempt to rebuild these files.
The method that you use depends on whether a valid httpd.conf file exists on your server:
- If a valid
httpd.conffile exists, follow the Rebuild userdata files with a valid httpd.conf file steps below. - If a valid
httpd.conffile does not exist, follow the Rebuild userdata files from a recent backup steps below.
The steps below assume that you have already logged in to your server via SSH as the root user.
Rebuild userdata files
Rebuild from a valid file
These steps require that a valid httpd.conf file exists on your server. If one does not exist, rebuild userdata files from a recent backup instead.
Rebuild from a recent backup
These steps rebuild userdata files from a recent backup. If a valid httpd.conf file exists on your server, we strongly recommend that you rebuild from this file instead.
If a userdata directory currently exists on your server, copy it and its contents to the cpanel directory.
To do this, run the following command:
cp -rfp /var/cpanel/userdata /var/cpanelThe method that you use to extract the backup depends on the type of backup file.
For example, if your backup file is a .tar.gz file, run the following command, where backup.tar.gzrepresents the absolute path to the backup file:
tar -zxvf backup.tar.gzThe /scripts/updateuserdatacache script ensures that the system properly caches all userdata files.
To do this, run the following command:
/scripts/updateuserdatacacheYou must rebuild Apache to use the rebuilt userdata files.
To do this, run the following command:
/scripts/rebuildhttpdconfAfter you rebuild Apache, you must restart it on your server.
To do this, run the following command:
/scripts/restartsrv_httpd