install awstats for zpanel on chicagovps

Click here to see the best cheap VPS  in the market.

After giving up kloxo-mr and webmin/virtualmin, I installed zpanel for vps management. But frankly speaking, zpanel also disappointed me when I logged in its administration panel. It has no file manager as the one in CPanel, and it has not awstats installed, which is the most frequently used software by webmasters.    But the GUI looks clean and concise, so I decide to go ahead to install/set up the missing software myself. In the last post, I have talked about enabling sftp in zpanel, in this post, I will talk about how to install awstats on  zpanel.

If you search google for the websites about installing awstats for zpanel, you will definitely find this webpage:, although it turns to be a topic about fixing a bug of webalizer stats module in zpanel(yes, the only stats report module, i.e., webalizer stats in zpanel has a bug that makes it not working) . In fact, awstats module comes with zpanel as a zpp package(a kind of file format used by zpanel to manage modules). Unfortunately, you can not find the zpp package to download on zpanel’s official website. The website seems dead, the module download urls are broken.  The original developers of zpanel seem to move to another similar project:  sentora. I wonder why I could not find the sentora project in those “10 top vps management panel” or “15 best cpanel alternatives”. All those articles refer to zpanel but do not mention about sentora. Anyway, after long time search, I finally found the awstats zpp package which is achieved on this website: But intalling this zpp package made me into troubles.

After downloading the awstats and installing in zpanel(module admin),  I got the following errors when trying to launch awstats:

Error: Plugin load for plugin ‘geoip’ failed with return code: Error: Can’t locate Geo/ in @INC …… Can’t locate Geo/IP/ in …. Error: Need Perl module Geo::IP or Geo::IP::PurePerl
Setup (‘/modules/awstats/cgi-bin/’ file, web server or permissions) may be wrong.
Check config file, permissions and AWStats documentation (in ‘docs’ directory).

This is because the Geo::IP and Geo::IP::PurePerl are not installed on the system. But trying to install the modules produced the following errors:

Can’t locate in @INC ….
BEGIN failed–compilation aborted.

This is caused by not installing cpan on the current CentOS. So we should install it first before installing the other software.

yum -y install perl-CPAN
perl -MCPAN -e “install Geo::IP::PurePerl”
perl -MCPAN -e “install Geo::IP”

After the dependent modules are installed, the awstats still failed to launch but with another error saying it cannot find the GeoIp.dat. You should modify the zpanel’s awstats configuration file:/etc/zpanel/panel/modules/awstats/cgi-bin/ to change the logfile from C:/AWServer/logs/domains/zadmin/ to /var/zpanel/logs/domains/zadmin/,and change LoadPlugin from “geoip GEOIP_STANDARD C:/AWServer/panel/modules/awstats/geo/GeoIP.dat” to “geoip GEOIP_STANDARD /etc/zpanel/panel/modules/awstats/geo/GeoIP.dat”. Then restart httpd, now awstats should be able to launch.

Sometimes you may find there is no log in the awstats report and you will see the message “Never updated (See ‘Build/Update’ on awstats_setup.html page)”. To handle this problem, you should check if the awstats config file is correct. The awstats configuration files are under the directory /etc/zpanel/panel/moudles/awstats/cgi-bin/. The form is This file specifies where awstats read the log file to generate the reports. The log file is usually under /var/zpanel/logs/domains/zadmin/ Make sure the log file name is correctly specified the configuraion file. And you may need to create the awstats database manually for the first time using the command:
perl -update

Although I finally got awstats installed and run, the GUI of awstats is embedded in a small frame of zpanel, which makes me hard to see the content of the awstats report. I am very disappointed. For days of installing and trying the so called best VPS panels, I must say I have not found one that is as good as CPanel. My ratings: kloxo-mr>zpanel>webmin/virtualmin.

Posted in tips of hosting

Leave a Reply