cPanel Structure

Details for the complete structure of cPanel by Kevin Asklund. The cPanel and WebHost Manager package includes: * cPanel - Domain Owner Control * WebHost Manager - Server Administration and Reseller * Webmail Panel - Webmail Access Directory Structure of cPanel ======================= Apache ======= /usr/local/apache bin- apache binaries are stored here - httpd, apachectl, apxs conf - conguration les - httpd.conf - php.conf cgi-bin domlogs - domain access and stat log les are stored here for all domains htdocs - default apache DocumentRoot location include - header les libexec - shared object (.so) les are stored here - libphp4.so,mod_rewrite.so logs - apache logs - access_log, error_log, suexec_log man - apache manual pages icons - icon/jpg/gif images modules - shared object (.so) les are store here - Apache-2.x+ Init Script :/etc/rc.d/init.d/httpd or /usr/local/apache/bin/apachectl - apache start script Cpanel script to restart apache - /scripts/restartsrv_httpd Exim ===== Conf : /etc/exim.conf - exim main conguration le - Do not manually edit /etc/localdomains - list of domains allowed to relay/receive mail Log : /var/log/exim_mainlog - incoming/outgoing mails are logged here Log : /var/log/exim_rejectlog - exim rejected mails are reported here Log : /var/log/exim_paniclog - exim errors are logged here Mail queue: /var/spool/exim/input Cpanel script to restart exim - /scripts/restartsrv_exim Email forwarders and catchall address le - /etc/valiases/domainname.com Email lters le - /etc/vlters/domainname.com POP user authentication le - /home/username/etc/domainname/passwd Catchall inbox - /home/username/mail/new POP user inbox - /home/username/mail/domainname/popusername/new POP user spambox - /home/username/mail/domainname/popusername/spam Program : /usr/sbin/exim (suid - -rwsr-xr-x 1 root root )

 Init Script: /etc/rc.d/init.d/exim : /scripts/restartsrv_exim : service exim restart ProFTPD ======== Program :/usr/sbin/proftpd Init Script :/etc/rc.d/init.d/proftpd : /scripts/restartsrv_ftpserver Conf: /etc/proftpd.conf Log: /var/log/messages, /var/log/xferlog Accounts le - /etc/proftpd/$username - all ftp accounts are stored here Pure-FTPD ========= Program : /usr/sbin/pure-ftpd Init Script :/etc/rc.d/init.d/pure-ftpd : /scripts/restartsrv_ftpserver Conf: /etc/pure-ftpd.conf Accounts le: /etc/proftpd/$username - all ftp accounts are stored here Anonymous ftp document root - /etc/pure-ftpd/ip-address Frontpage Extensions ================= Program - (Install): /usr/local/frontpage/version5.0/bin/owsadm.exe Uninstall and then install for re-installations FP les are found as _vti-bin, _vti-pvt, _vti-cnf, vti-log inside the public_html /scripts/setupfp5 domain.com Mysql ======= Program : /usr/bin/mysql Init Script : /etc/rc.d/init.d/mysql : service mysql start/stop : /scripts/restartsrv_mysql Conf : /etc/my.cnf, /root/.my.cnf Data directory - /var/lib/mysql - Where all databases are stored. Database naming convention - username_dbname (eg: john_sales) Log: Startup errors - /var/lib/mysql/hostname.tld.err Permissions on databases - drwx 2 mysql mysql Socket le - /var/lib/mysql/mysql.sock, /tmp/mysql.sock SSHD ====== Program :/usr/local/sbin/sshd Init Script :/etc/rc.d/init.d/sshd - /scripts/restartsrv_sshd Conf: /etc/ssh/sshd_cong Log: /var/log/messages

Perl ==== Program :/usr/bin/perl Directory :/usr/lib/perl5/5.8.x/ Version: perl -v Check: /scripts/checkperlmodules Installer: /scripts/perlinstaller : /scripts/realperlinstaller : perl -MCPAN -e shell Build: /home/.cpan PHP ==== System PHP Program :/usr/local/bin/php, /usr/bin/php, /usr/local/php4/bin/php ini le: /usr/local/lib/php.ini - apache must be restarted after any change to this le php can be recomplied using /scripts/easyapache : /scripts/phpup using /var/cpanel/ easy/apache/prole/ Internal PHP Program : /usr/local/cpanel/3rdparty/bin/php : /var/cpanel/3rdparty/bin/php ini le: /usr/local/cpanel/3rdparty/etc/php.ini internal PHP can be recompiled using : /scripts/makecpphp using /var/cpanel/easy/ apache/prole/makecpphp.prole.yaml Named(BIND) ============ Program: /usr/sbin/named Init Script: /etc/rc.d/init.d/named Cong: /etc/named.conf Zone les:/var/named/ Log: /var/log/messages: /var/named/data/named.run NSD (Alternate DNS option) ===================== Program: /usr/sbin/nsd Init Script : /etc/rc.d/init.d/nsd db records : /var/named Cong: /etc/nsd/nsd.conf Log: /var/log/messages Courier ===== Program: /usr/lib/courier-imap/libexec/couriertcpd Init Script: /etc/init.d/courier : /scripts/restartsrv_courier Cong: /usr/local/libexec/courier-imap Log: /var/log/maillog

Dovecot ====== Program: /usr/sbin/dovecot Init Script: /etc/init. Cong: /etc/dovecot.conf Log: /var/log/maillog

cPanel installation directory structure ============================= /usr/local/cpanel + 3rdparty/ - tools like fantastico, mailman les are located here + addons/ - AdvancedGuestBook, phpBB etc + base/ - phpmyadmin, squirrelmail, skins, webmail etc + bin/ - cpanel binaries + cgi-sys/ - cgi les like cgiemail, formmail.cgi, formmail.pl etc + logs/ - cpanel access_log, error_log, license_log, stats_log + whostmgr/ - whm related les + base/frontend - cPanel related les - themes + perl/ - internal Perl modules for compiled binaries + etc/init - init les for cPanel services WHM related les =============== /var/cpanel - whm les + bandwidth/ - rrd les of domains + username.accts - reseller accounts are listed in this les + packages - hosting packages are listed here + root.accts - root owned domains are listed here + suspended - suspended accounts are listed here + users/ - cpanel user le - theme, bwlimit, addon, parked, sub-domains all are listed in this les + zonetemplates/ - dns zone template les are taken from here Common CPanel scripts =================== cpanel/whm Scripts are located in /scripts/ + addns - add a dns zone + addfpmail - Add frontpage mail extensions to all domains without them + addfpmail2 -Add frontpage mail extensions to all domains without them

+ addpop - add a pop account + addservlets - Add JSP support to an account (requires tomcat) + addstatus - (Internal use never called by user) + adduser - Add a user to the system + apachelimits - calculates memory limits for apache processes then adds to httpd.conf + bandwidth - (deprecated) + betaexim - Installs the latest version of exim + biglogcheck - looks for logs nearing 2 gigabytes in size + bsdcryptoinstall - Installs crypto on FreeBSD + bsdldcong - Congures the proper lib directories in FreeBSD + bsdpkgpingtest - Tests the connection speed for downloading FreeBSD packages + buildbsdexpect - Install expect on FreeBSD + buildeximconf - Rebuilds exim.conf + buildpostgrebsd-dev - Installs postgresql on FreeBSD. + chcpass - change cpanel passwords + cleandns - removes domains from named.conf that do not have a Zone. + courierup - used to update/reinstall courier + cpbackup - to backup accounts (if backups enabled) (--force) + dnscluster - used to synchronize DNS zones with clustered servers (--help) + dumpstor - displays contents of .datastore storable les + dumpgdbm - displays contents of .gdbm locale les + easyapache - recompile/upgrade apache and/or php + editquota - used to manually set a users quota limit + ensure_vhost_includes - ensures users includes are added in httpd.conf + eximup - used to update exim to latest version - will overwrite any manual changes + xcommonproblems - xes mailbox permissions, mailman, cgi scripts, ndc and quotas + xfrontpageperm - xes permission issues with Front Page + xmailman - xes common mailman issues + xndc - xes rndc errors with named + xquotas - xes quota problems + fullhordereset - resets horde database to a fresh one - all previous user data are lost + ftpup - used to update/install FTP server (pureftpd or proftpd) to latest version + generatemaildirsize - generates new maildirsize for any or all users *(--help) + initquotas - initializes quotas + installzendopt - installs zend optimizer - thru phpextensionmgr + killacct - terminate an account - make sure you take a backup of the account rst + killdns - removes a DNS Zone + mailperm - xes permission problems with mail directories + makecpphp - rebuilds internal PHP from /var/cpanel/easy/apache/prole/ makecpphp.prole.yaml + mysqlup - used to update mysql to latest version specied in /var/cpanel/cpanel.cong + park - to park a domain - only adds DNS + pkgacct - used to backup an account + pre* - used to create pre service scripts that run before a service is updated + post* - used to create post service scripts that run after a service is updated + phpup - used to update PHP only

+ rebuildcpusers - chowns /var/cpanel/users les + rebuildnamedconf + rebuildparkeddomains + restartsrv - restart script for services + restorepkg - restores an account from a backup le ( pkgacct le) + runlogsnow - update logs of all users + runweblogs - update stats for a particular user + securetmp - secures /tmp partition with options nosuexec and nosuid + setupftpserver - sets which FTP server to install (pureftpd or proftpd) + setupmailserver - sets which mail service to install (courier or dovecot) + setupnameserver - sets which DNS service to install (Bind or NSD) + suspendacct - suspends an account + unsuspendacct - unsuspends a suspended account + upcp - updates cpanel to the latest version (--force) + updatenow - updates the cpanel scripts + updateuserdomains - updates /etc/userdomains entries from /var/cpanel/users + wwwacct - to create new accounts (wwwacct domain.com user password) Important cPanel/WHM les ==================== /usr/local/apache/conf/httpd.conf - apache conguration le /etc/exim.conf - mail server conguration le /etc/named.conf - name server (named) conguration le /etc/proftpd.conf - proftpd server conguration le /etc/pure-ftpd.conf - pure-ftpd server conguration le /etc/valiases/domainname - catchall and forwarders are set here /etc/vlters/domainname - email lters are set here /etc/userdomains - all domains are listed here - addons, parked,subdomains along with their usernames /etc/localdomains - exim related le - all domains should be listed here to be able to send/receive emails /var/cpanel/users/username - cpanel user le /var/cpanel/cpanel.cong - cpanel conguration le ( Tweak Settings )* /etc/cpbackup-userskip.conf /etc/syscong/network - Networking Setup* /etc/hosts /var/spool/exim /var/spool/cron - cronjobs are stored here for all users /etc/resolv.conf - Networking Setup> Resolver Conguration /etc/nameserverips - Networking Setup> Nameserver IPs ( FOr resellers to give their nameservers ) /var/cpanel/resellers - For addpkg, etc permissions for resellers. /etc/chkserv.d - Main >> Service Conguration >> Service Manager * /var/run/chkservd - Main >> Server Status >> Service Status * /var/log/dcpumon - top log process

/root/cpanel3-skel - skel directory. Eg: public_ftp, public_html. (Account Functions >Skeleton Directory )* /etc/wwwacct.conf - account creation defaults le in WHM (Basic cPanel/WHM Setup)* /etc/cpupdate.conf - Update Cong * /etc/cpbackup.conf - Congure Backup* /etc/clamav.conf - clamav (antivirus conguration le ) /etc/my.cnf - mysql conguration le /usr/local/lib/php.ini - php conguration le /etc/ips - ip addresses on the server (except the shared ip) (IP Functions>Show IP Address Usage )* /etc/ipaddrpool - ip addresses which are free /etc/ips.dnsmaster - name server ips /etc/domainips - IPs set as dedicated for specic domains /var/cpanel/Counters - To get the counter of each users. /var/cpanel/bandwidth - To get bandwith usage of domains /var/cpanel/userdata - Denes parked, addon, subdomains as well as VirtualHost /var/cpanel/logs - transfer logs /var/cpanel/easy - easyapache build les/prole /var/cpanel/userhomes - session holder for Horde, Roundcube, phpmyadmin /var/cpanel/serviceauth - chkservd service user/pass data /var/cpanel/updatelogs - upcp daily logs