rssHomeContactSite Map

Installation Guide

The installation and configuration of Advanced Web Stats requires some technical knowledge and might seem elaborate, but this tutorial will help you to quickly get it up and running in order to start analyzing your website.

Advanced Web Stats Installation

1. Getting started

Before starting the installation, it is recommended to follow the steps outlined below:

  • It is important to have your Operating System up to date, so please run a Software Update first.
  • Check the minimum system requirements and make sure that your system meets them.

2. Install JDK (Java Development Kit)

ImportantJava Development Kit required!
Advanced Web Stats requires a 1.5 version or later of Java Development Kit to be installed on your machine. JRE (Java Runtime Environment) is not enough for Advanced Web Stats.

To check what version of Java you have installed, open the command prompt and type the following:

java -version

If nothing is displayed on your command prompt/terminal or you do not see anything related with the version of java it means that you do not have it installed on your machine and you need to install it.

Note For more information about installing JDK and setting the JAVA_HOME variable on Mac OS X check our guide with detailed installation instructions: Install Java and set JAVA_HOME

3. Install Advanced Web Stats

To download the latest version of Advanced Web Stats please visit the Download section from our website.

When the download finishes, you will need to follow, depending on your Operating System certain steps in order to have a successful and straight forward installation. For comprehensive installation guides follow the links below:

Install the Advanced Web Stats tracker script

To install the Advanced Web Stats script please follow the steps below:

  1. Download the AWS tracker script aws.js and copy it to the main directory of your website content.
  2. Reference the script (<script type="text/javascript" src="/aws.js"></script>) in your HTML. Enter the following line in all of your HTML pages. Although it can go anywhere in the pages, we recommend putting it in the <head> section. If you use a common include or template, you can enter it there.
  3. Setup your profile. In the AWS Administration interface, edit the profile in question and click on the General Settings tab. Set the Visitor Tracking Method to AWS Session ID and click the Apply button

Advanced Web Stats Post Installation

Once you have installed and run Advanced Web Stats, your browser will open a new window and an intuitive and friendly wizard will guide you through the post-installation process.

1. License information

First, AWS will provide you the license information, like the type for the licence and if it's a trial when it will expire. In the following steps you will be asked to configure the database that will be used for Advanced Web Stats and the SMTP settings that will be used to send emails.

2. Database setup

Next, you will be asked to provide database server connection information by selecting the database engine that you want to use. If you are using a trial of Advanced Web Stats it is recommended to use the Hypersonic embedded database because this option will also install a Demo profile to get you up and running as quickly as possible. Later, you can upgrade to another type of database.

Once you have decided to use Advanced Web Stats for production we strongly recommend to use an external database engine, such as MySQL or PostgreSQL. You can find more details about setting up an external database in our External Database configuration guide.

3. Email settings

A click on the next button will take you to the next step where you can configure the SMTP settings that will be used by Advanced Web Stats to send confirmation and password retrieval emails. If you use secure connection or secure authentication, make sure that you will select "TLS" or "SSL" on the Connection security and then select the option "User authentication" and fill the required fields.

4. Administrator setup

Finally, you need to configure the system administrator account for Advanced Web Stats, by setting the username and password. The email address will be used only for notifications and lost password information. Press the "Next" button to access Advanced Web Stats.

By following the steps outlined in this tutorial you should be able to finish the installation process of Advanced Web Stats and start setting up profiles and customizing them.