How to Install AWStats on HostRocket sites

This tutorial may work on other hosts as well, but please make sure that your host allows you to install AWStats first.

Get AWStats

The first step is to download the latest, stable version of AWStats from it's Sourceforge Page. Download the .zip file. Once the download is completed, you need to open the .zip file and extract all of the files - a program like WinZip or PowerArchiver can do this. You should now have a folder on your computer that is called awstats-6.4 (the numbers will be different depending on the version you download).

Config Settings

Find the file awstats.model.conf in the awstats-6.4\wwwroot\cgi-bin folder. Rename it to awstats.www.yourdomain.com.conf (replace www.yourdomain.com with your actual domain name - mine would look like awstats.www.rniccage.com.conf). On some hosts, the www might not be necessary.

Now open the awstats.www.yourdomain.com.conf file - any text editor will work, such as notepad or wordpad. Most of the configuration settings are very well explained in there, but I will talk about a few of them here.

The first section asks you where your log files are. Change LogFile="/var/log/httpd/mylog.log" to LogFile="/usr/local/apache/domlogs/yourdomain.com". For my site, it would be /usr/local/apache/domlogs/rniccage.com If you are on a different host, the logfile may be in a different directory and you will have to contact your host.

Next go down to where it says SiteDomain="" and change that to SiteDomain="yourdomain.com". For my site, it would be SiteDomain="rniccage.com"

Then find DirData=".". If you leave the ., the archives will be added to the same folder that awstats.pl is in. If you want to keep your archives in another folder, like awstats-archive, you will have to change the permissions of the folder (CHMOD) to 755. To do this, you can right click on the folder in your ftp program and click on properties or use the chmod function in the file manager.

Next find AllowToUpdateStatsFromBrowser=0. This allows you to click a link on your stats page to update it immediately. Unless you password protect your stats page, which is recommended, it is better to leave this at 0 for no.

Upload AWStats

Next, open up your FTP program or the File Manager in your control panel. Upload all of the files and subfolders from the awstats-6.4\wwwroot\cgi-bin\ folder on your computer to the /public_html/cgi-bin/ folder on your host.

Then upload everything in the awstats-6.4\wwwroot\icon\ and the awstats-6.4\wwwroot\css\ folders to the /public_html/ folder.

Change the permissions (CHMOD) of the awstats.www.yourdomain.com.conf and awstats.pl files to 755.

Go to your AWStats Page

Now point your browser to your awstats.pl file - http://www.yourdomain.com/cgi-bin/awstats.pl and you should see your stats page.