Running AWStats

AWStats is scheduled to run daily at 4.02 AM. You can override this schedule to generate reports as and when you need to generate them.

To run AWStats manually, follow these steps:

1. Log on to the server using the Telnet or SSH remote login service.
   • If you are using the SSH service, type the following at the command prompt.

     ssh <server_name> 

     For example, if you have a server by the host name example, then type ssh example

   • If you are using Telnet, type the following:

     telnet <server_name>

2. To assume root privileges for the site, using the following command.

   su

3. Change your working directory to the home directory of the site using the following command.

   /usr/sbin/chroot /home/virtual/<siteN>

   where:

   /usr/sbin/chroot is the command to change your working directory to the home directory of the site

   /home/virtual/<siteN> is the absolute path to the site's home directory

   Important: When you use this command, you must leave a space between the command /usr/sbin/chroot and the directory path /home/virtual/<siteN>, otherwise it will result in an error.

4. Run AWStats by typing the following at the command prompt:
   • for gathering statistics:

     /usr/bin/perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=$<siteN> -update

   • for generating html files:

     /usr/bin/perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=$<siteN> -output -staticlinks > /var/www/html/awstats/web/index.html

     /usr/bin/perl /usr/local/awstats/tools/awstats_buildstaticpages.pl -awstatsprog=/usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=$<siteN> -output -staticlinks -dir=/var/www/html/awstats/web

     Here $<siteN> is

   • <siteN> for Web server
   • ftp.<siteN> for ftp server.

If successful, AWStats generates the reports in the respective output directories.

• The output directory for Web server reports is:

  /var/www/html/awstats/web

• The output directory for FTP server reports is:

  /var/www/html/awstats/ftp

To view the reports, log into the site and in the shortcuts section of the Home page, click on AWStats reports (Reports section).