Information on Backup Tarball Contents

1
Information on Backup Tarball Contents
2
Table of Contents

• Introduction
• Introduction (Continued)
• Creating a Backup
• Directories
• Directories (Continued)
• Directories (Continued I)
• Directories (Continued II)

• Directories (Continued III)
• sslcerts
• Directories (Continued IV)
• Directories (Continued V)
• Files without a Directory
• Files without a Directory (Continued)
• Files without a Directory (Continued I)

3
Introduction

• The system creates a tarball file (.tar.gz) every
  time a backup is created. It contains the
  compressed versions of the files of an account.
  The file format that is used by the system is,
  USERNAME.tar.gz. In it, USERNAME represents the
  username of the cPanel account. The following
  things need to be done to view the contents of
  this file
• The tar.gz file needs to be downloaded and then
  its contents need to be extracted.
• The command, tar -tvf USER.tar.gz , needs to be
  used on the command line. In it, USER
  represents the account username. All the backup
  files contents are displayed by it. The contents
  of the file are not extracted by it.
• It needs to be mentioned that it is not
  recommended by cPanel WHM that this file be
  used as an integration end point. This files
  contents can change at any time.

4
Introduction (Continued)

• It needs to be mentioned that the backup process
  runs as that cPanel user for whom data is being
  backed up. All the files that the account owns in
  the backup file are included by the system. The
  files that the account doesnt own but can access
  in the backup file are also included in it. The
  system doesnt back up those files which the
  account does not own and cant access.
• To digress cPanel is a popular web hosting
  control panel. Web hosting is a service that is
  provided by web hosting companies for making
  websites accessible. The Top Cloud Hosting
  Company, the Best Linux Shared Hosting
  Company, the Best Windows Dedicated Hosting
  Company are the terms that are frequently used
  to address the most reliable hosting service
  providers.

5
Creating a Backup

• Creating a backup in WHM One of the
  below-mentioned methods can be used for creating
  an account backup file in WHM.
• Backup Configuration interface in WHM
• WHM gtgt Home gtgt Backup gtgt Backup
  Configuration
• WHMs backup script
• Backup functions of WHM API 1
• Creating a backup in cPanel One of the
  following methods can be used for creating an
  account backup file in cPanel
• Backup interface in cPanel
• cPanel gtgt Home gtgt Files gtgt Backup
• Backup functions of UAPI

6
Directories

• The entries that are the file directories in the
  backup file of an account are mentioned below
• authnlinks The external authentication data of
  an account are contained in the directory,
  /authnlinks . This directory appears only then,
  when external authentication is used by the
  account.
• apache_tls The domain files of the account are
  contained in the /apache_tls directory. The
  files in this directory contain the following,
  for each domain existing on the account
• Private keys
• SSL certificates
• bandwidth The bandwidth information is stored
  by the system in the bandwidth.json file. The
  /bandwidth directory is created in the backup
  file by the system. Data isnt stored in this
  directory.
• bandwidth_db The bandwidth information is
  stored by the system in the bandwidth_db.json
  file. The /bandwidth_db directory is created in
  the backup file by the system. Data isnt stored
  in this directory.
• counters A copy of any file that is owned by
  the account within the directory,
  /var/cpanel/Counters/ is contained in the
  /counters directory. The current count for the
  webpage hit counters is contained in each of
  these files.

7
Directories (Continued)

• cp The user file of the account which exists in
  the directory, /var/cpanel/users is contained in
  the /cp directory. The information of the account
  and account settings are contained in this file.
• cron The cron table file data of the account is
  contained in the /cron directory.
• ccs The accounts Calendar and Contacts Server
  (CCS) plugin data, if it exists, is contained in
  the /ccs directory.
• dnssec_keys The DNSSEC keys for all the domains
  of an account are contained in the /dnssec_keys
  directory. A directory is created by the system
  for each domain. The domains DNSSEC key files
  are copied to it by the system. The DNSSEC key
  files are stored by the system in the format,
  keytag_keytype.key. The keys tag ID is
  represented by keytag. The type of DNSSEC key is
  represented by keytype.
• dnszones Copies of the DNS zone files of an
  account are contained in the /dnszones directory.
  These files are stored by the system in the
  format, DOMAIN.db . DOMAIN refers to the domain
  of the account.
• domainkeys The public and private domain key
  files of an account are contained in the
  directory, /domainkeys. The private keys for each
  domain which exists on the cPanel account are
  contained in the private file. The public keys
  for each domain which exists on the cPanel
  account are contained in the public file.

8
1-800-123 -8156

• Whoa! Thats a big number, arent you
  proud?

9
Directories (Continued I)

• homedir A copy of the /home directory of the
  account is contained in the /homedir directory.
  This file is created by the system with the
  command, getpwnam. The contents of the /home
  directory of the account are contained in this
  directory.
• httpfiles The custom virtualhost templates of
  the account are contained in the /httpfiles
  directory.
• ips The related_ips file is contained in the
  /ips directory. The Ipv6 addresses which exist on
  the server of the account are contained in this
  file.
• locale The custom locale of an account is
  contained in the /locale directory.
• logs The copies of the log files of an account
  in the directory, /usr/local/apache/domlogs are
  contained in the /logs directory. Data tracked by
  the log file are contained in these files.

10
Directories (Continued II)

• mm The Mailman mailing list files of an account
  are contained in the /mm directory. Each mailing
  list has its subdirectory in this directory.
• mma All the accounts domains Mailman files
  are contained in the /mma directory. The copied
  files are divided by the system into
  subdirectories, which correspond to each type of
  mailing list.
• pub/ - All the accounts domains Mailman files
  from the directory, /usr/local/cpanel/3rdparty/mai
  lman/archives/public are contained in this
  directory.
• priv/ - All the accounts domains Mailman files
  from the directory, /usr/local/cpanel/3rdparty/mai
  lman/archives/private are contained in this
  directory.
• mms Files from the accounts directory,
  /usr/local/cpanel/3rdparty/mailman/suspended.lists
  are contained in the /mms directory.
• mysql The accounts MySQL dumps for any of its
  MySQL databases are contained in the /mysql
  directory. These files are stored by it in the
  format, USER_database.sql. USER represents the
  username of the account.
• mysql-timestamps Log files which state when a
  MySQL database was created by the account are
  contained in the /mysql-timestamps directory. The
  files are stored by it in the file format, .txt.
  The MySQL database creation timestamp is
  contained in these files in Unix time format.

11
Directories (Continued III)

• psql The PostgreSQL database files of an
  account are contained in the /psql directory.
  These are contained in .tar file format. This
  directory also contains the following files
• 1psql_users.sql All of the accounts PostgreSQL
  users are contained in this file.
• psql_grants.sql All of the accounts PostgreSQL
  grants are contained in this file.
• resellerconfig The reseller file of a reseller
  account is contained in the directory,
  /resellerconfig. The reseller file has the data
  of the /var/cpanel/resellers file of the account.
  The accounts username and all the accounts
  access control list (ACL) privileges are included
  in it. The resellers-nameservers file is also
  contained in the directory, /resellerconfig. This
  file contains the entry of the account in the
  file, /var/cpanel/resellers-nameservers.
• resellerfeatures A reseller accounts custom
  feature lists are contained in the directory,
  /resellerfeatures.
• resellerpackages A reseller accounts custom
  packages are contained in the directory
  /resellerpackages.
• ssl The backup files /homedir/ssl directory
  contains the contents of the /ssl directory.

12
Directories (Continued IV)

• sslkeys All the SSL keys for the accounts
  domains are contained in the /sslkeys directory.
  This file is copied in the DOMAIN.key format by
  the system. DOMAIN is the domain name of the
  account. It needs to be mentioned that the
  contents of this directory exist in the
  /homedir/ssl directory of the backup file.
• suspended A copy of the file in the accounts
  /var/cpanel/suspended directory is contained in
  the /suspended directory. The files are copied by
  the system in USER or USER.lock format. USER is
  the username of the account. The reason for the
  account suspension, if there is any, is contained
  in each file.
• suspendinfo A copy of the files in the
  accounts directory, /var/cpanel/suspendinfo is
  contained in the /suspendinfo directory.
• userconfig A copy of the files in the
  directory, /var/cpanel/userconfig is contained in
  the /userconfig directory. This file has symlinks
  from the public_html directory of the account.
• userdata The user data of the accounts
  subdomain or domain is contained in the /userdata
  directory. Files are copied in this directory by
  the system from the directory, /var/cpanel/userdat
  a/USER. USER is the username of the account.

13
Directories (Continued IV)

• sslkeys All the SSL keys for the accounts
  domains are contained in the /sslkeys directory.
  This file is copied in the DOMAIN.key format by
  the system. DOMAIN is the domain name of the
  account. It needs to be mentioned that the
  contents of this directory exist in the
  /homedir/ssl directory of the backup file.
• suspended A copy of the file in the accounts
  /var/cpanel/suspended directory is contained in
  the /suspended directory. The files are copied by
  the system in USER or USER.lock format. USER is
  the username of the account. The reason for the
  account suspension, if there is any, is contained
  in each file.
• suspendinfo A copy of the files in the
  accounts directory, /var/cpanel/suspendinfo is
  contained in the /suspendinfo directory.
• userconfig A copy of the files in the
  directory, /var/cpanel/userconfig is contained in
  the /userconfig directory. This file has symlinks
  from the public_html directory of the account.
• userdata The user data of the accounts
  subdomain or domain is contained in the /userdata
  directory. Files are copied in this directory by
  the system from the directory, /var/cpanel/userdat
  a/USER. USER is the username of the account.

14
Directories (Continued V)

• va Any of the autoresponders of the account are
  contained in the /va directory. This file is
  copied by the system from the directory,
  /etc/valiases/
• vad A copy of the virtual domain aliases of the
  account are contained in the directory, /vad.
  This file is copied by the system from the
  directory, /etc/vdomainaliases.
• vf A copy of the Exim filters of the user are
  contained in the /vf directory. Copies of the
  filters owned by the user are created by the
  system from the directory, /etc/vfilters.

15
Files without a Directory

• The below-mentioned files in the tarball do not
  exist in a directory
• addons A hash of the addon domains of the
  account and their relative subdomains are
  contained in the addons file.
• autossl.json The AutoSSL run preferences of the
  account are contained in the autossl.json file.
  The run restrictions with regard to AutoSSL that
  have been set by the system administrator are
  contained in this file.
• bandwidth_db.json The bandwidth data
  information of the account is contained in the
  file bandwidth_db.json.
• bandwidth_db.data.json The bandwidth usage data
  of the account is contained in the file
  bandwidth_db.data.json.
•  digestshadow The passwords related to the
  accounts DAV digest authentication with regard
  to the WebDesk feature of cPanel are contained in
  the file, digestshadow.
• cPanel gtgt Home gtgt Files gtgt Web Disk.

16
Files without a Directory (Continued)

• The following files in the tarball do not exist
  in a directory
• has_sslstorage A touch file is contained in the
  has_sslstorage file. The use of the SSL Storage
  Manager feature of WHM by the account is
  indicated by it. This file is stored by it in the
  format, crtindex.txt.
• WHM gtgt Home gtgt SSL/TLS gtgt SSL Storage
  Manager.
• homedir_paths The full path to the /home
  directory of the account is contained in the
  file, homedir_paths.
• mysql.sql The MySQL database grants of the
  account are contained in the file, mysql.sql.
• mysql_host_notes.json The user-provided
  description information for the MySQL database
  hosts of the account, if available, is contained
  in the file, mysql_host_notes.json. 
• nobodyfiles A list of files in the /home
  directory of the account, which is owned by the
  nobody system user, is contained in the file,
  nobodyfiles.
•  

17
Files without a Directory (Continued
I)

• pds A list of the parked domains (aliases) of
  the account are contained in the pds file.
• proftpdpasswd A copy of the ProFTPd file of the
  account in the directory, /etc/proftpd is
  contained in the file, proftpdpasswd.
• quota The quota size of the account (in bytes)
  is contained in the quota file.
• sds A list of the subdomains of the account are
  contained in the file, sds.
• sds2 A hash of subdomains as well as their
  relative document roots are contained in the
  file, sds2.
• shadow A copy of the password of the account
  which the getpwnam command returns is contained
  in the file, shadow.
• shell The login shell of the account is
  contained in the file, shell.
• version The pkgacct version number of the
  account as well as its archive version number are
  contained in the file, version.
• webcalls.json The web call data of the account
  is contained in the file, webcalls.json 
•  

18
Thanks!

• ANY QUESTIONS?

• www.htshosting.org