How to Install AWStats on OpenBSD

In this tutorial, we will guide you on how to install AWStats on OpenBSD.

Prerequisites

Before we begin, ensure the following:

• You have access to the OpenBSD server with root privileges.
• You have a web server installed.

Step 1: Update OpenBSD

It is always good to ensure that the system packages are updated.

As root, update the OpenBSD system packages:

# pkg_add -u

Step 2: Install AWStats

As root, install AWStats with the following command:

# pkg_add awstats

Once installed, you can verify its installation by running the following command:

# awstats -version

This should output the version of AWStats installed on your system.

Step 3: Configure AWStats

Next, we need to configure AWStats to monitor our web server logs.

By default, AWStats configuration file is located at /etc/awstats/awstats.conf, but we recommend copying it to a separate directory location so you have a backup.

# cp /etc/awstats/awstats.conf /etc/awstats/my-awstats.conf

Edit the configuration file and update the following sections:

Log File Location

Update the LogFile path to where the log files are stored, e.g., the Apache logs:

LogFile="/var/log/httpd/access_log"

DNS Lookup

If you want to perform DNS lookups, uncomment the following line:

DNSLookup=1

Site Domain and Name

Update the site domain and name with the following parameters:

SiteDomain="www.example.com"
HostAliases="localhost 127.0.0.1 REGEX[^.*$]"

Step 4: Generate Reports

With the configuration done, you can now generate AWStats reports.

Generate the reports for the configured logs with the following command:

# awstats -config=my-awstats -update

This generates the reports for the my-awstats configuration we created.

Next, access the reports by browsing to http://example.com/cgi-bin/awstats.pl?config=my-awstats.

Congratulation! You have successfully installed AWStats on OpenBSD.