 |  | HomeContactSite Map |
 | Advanced Web Stats | |
User Guide |
The following instructions will help you to install Advanced Web Stats on Linux Operating Systems.
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.
![[Note]](../icons/note.png){kind=icon} | Note |
|---|---|
|
The installation of Advanced Web Stats requires [root] privileges. In this case you can either use [sudo] before your commands and enter the password when required, either switch users using the [su] command. |
2. Unzip the downloaded Advanced Web Stats Installation file
To download the latest version of Advanced Web Stats please visit the Download section from our website.
After downloading the Advanced Web Stats Installation file, unzip it to a local directory.
3. Select the username and home directory for Advanced Web Stats (optional)
The default path for Advanced Web Stats to be installed is: /usr/local/aws and the default username: aws.
When installing services on Linux Systems, it is recommended to run them as a dedicated user, in order to have only the required permissions. Advanced Web Stats will install the service [aws], which will run as [aws] user.
If you want to change the path or the user please navigate to the directory where you unzipped Advanced Web Stats and edit the file [install.sh].
In the [install.sh] edit [USER] to change the username and [AWS_HOME] to change the home directory:
USER=aws AWS_HOME=/usr/local/aws
When this is done, the next step would be to configure the server and listen ports.
4. Install Advanced Web Stats
To install Advanced Web Stats open a terminal window and navigate to the Installation directory. Now type the following command:
sudo ./install.sh
The installation script will make Advanced Web Stats start automatically, each time you start your computer.
A successful installation will display in the terminal this message:
[user@host aws-version]$ sudo ./install.sh
Advanced Web Stats installation started...
Creating user "aws"... Done.
Creating the Advanced Web Stats folder... Done.
Creating script /etc/init.d/aws... Done.
Extracting the contents of Advanced Web Stats package... Done.
Adding the script to be executed when the system restarts... Done.
Starting Advanced Web Stats:
Using CATALINA_BASE: /usr/local/aws/current
Using CATALINA_HOME: /usr/local/aws/current
Using CATALINA_TMPDIR: /usr/local/aws/current/temp
Using JRE_HOME: /usr
done.
Advanced Web Stats installation is now complete.
To continue, please open the following URL in a browser:
http://localhost:8888/
5. Configure the listen port (optional)
Advanced Web Stats uses as default ports [8888] as listen port and [8006] as server port. But if another application uses one or both ports used by Advanced Web Stats as default you need to change the ports that Advanced Web Stats will use. To change the ports please follow these instructions:
-
Open the file [server.xml], located in the [conf] folder, under the Installation directory (the location where you have unzipped the application) and edit the following lines with your preferred text editor.
The beginning of [server.xml] should look like this:
<Server port="8006" shutdown="password"> <Service name="Catalina"> <Executor name="awsThreadPool" namePrefix="aws-exec-" maxThreads="500" minSpareThreads="4" maxIdleTime="20000"/> <Connector executor="tomcatThreadPool" port="8888" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443"/> <Engine name="Catalina" defaultHost="localhost">
-
Change the server shutdown port and the listen port with two free ports. To see the free ports on your machine use [netstat]
For example, after changing the default ports with "8010" and "8889", the file [server.xml] should look like this:
<Server port="8010" shutdown="password"> <Service name="Catalina"> <Executor name="awsThreadPool" namePrefix="aws-exec-" maxThreads="500" minSpareThreads="4" maxIdleTime="20000"/> <Connector executor="tomcatThreadPool" port="8889" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443"/> <Engine name="Catalina" defaultHost="localhost">
Please note that these changes are optional, and you need make them only if the ports specified above are used by other programs.
| Note |
|---|---|
|
The first line of the [server.xml] file contains also the server shutdown password that can be used when shutting down the server remotely. You can use the default one, or easily set your own password. |
6. Start Advanced Web Stats
Once the Advanced Web Stats service is started, open your favourite browser and in the address bar type: http://localhost:8888. This direct you to the Post-Installation process.
| Note |
|---|---|
|
If you changed the port at the step 5, then use the port you specified above. |
7. Stop/Start Advanced Web Stats service
If you want to stop the [aws] server use the following command in your terminal:
service aws stop
Later you can start the service again using the following command in your terminal:
service aws start
8. Follow Post-installation process
On the Post-installation wizard you need to select the database, configure the email setting and the system administrator account. For more details and instructions about the post-installation process please read the Post-installation Guide.