Configuring AWStats for Sites

AWStats reports must be configured from the command line interface. You cannot configure AWStats using the control panel.

AWStats statistics is available in the directories:

• /home/virtual/<siteN>/fst/var/www/html/awstats/web - Web server statistics
• /home/virtual/<siteN>/fst/var/www/html/awstats/ftp - ftp server statistics

  Here, <siteN> is site number, for example, site 1, site 2, site 3 and so on.

AWStats reports are generated in accordance with the options set in the AWStats configuration file. AWStats configuration files are stored in the following directories inside the site's file system:

• /home/virtual/<siteN>/fst/etc/awstats/awstats.ftp.<siteN>.conf
• /home/virtual/<siteN>/fst/etc/awstats/awstats.<siteN>.conf
• /etc/httpd/conf/<siteN>/awstats

You can modify the configuration options to change the default behavior of AWStats reports.

AWStats directory is protected and by default the site administrator user has access to it:

• /home/virtual/<siteN>/fst/etc/awstats/.passwd
• /home/virtual/<siteN>/fst/var/www/html/awstats/.htaccess

To change the configuration options:

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. At the command prompt, type the following command to modify the configuration file.
   • To modify the configuration file of Web server

     vi /etc/awstats/awstats.<siteN>.conf

   • To modify the configuration file of FTP server

     vi /etc/awstats/awstats.ftp.<siteN>.conf  

     The configuration file opens. Each option is preceded by a detailed description of the option. Use the definitions in the configuration file to help you modify the file.

5. Change the configuration options as needed.
6. To save the changes and exit the configuration file, type the following command.

   :wq 

To view the report, run AWStats.