Introduction
This guide describes how to install Adhere Ad Server. The guide is intentionally brief and describes the most typical installation. The Adhere
Ad Server Operation Guide provides more detailed information about how to operate the Ad Server.
Installation Prerequisites
Make sure the server includes:
- Apache 2.2.8 or newer
- PHP 5.2.4 or newer
- MySQL 5.0 or newer
- SSL enabled on Apache (required for secure log in)
- Sendmail on Apache
Tested on Redhat Enterprise Linux, Cent OS Linux, and Ubuntu Linux
During installation, the installation wizard will ask you for the following details in order to connect to your database:
- Database hostname or IP address
- Database port number
- Database name (you can use any name you didn't use before)
- Database username
- Database password
In addition, the installation wizard will ask you for the following details for advanced settings:
- Table type (MyISAM or InnoDB)
- Table names prefix (e.g. “adhere_”)
Download Adhere Ad Server
Download the latest installation archive from
here, unpack the compressed file, and rename the folder as 'adserver'.
Upload Adhere Ad Server to your Web Server
Upload the adserver folder to a location on your web server which you can access from a web browser. For example: http://www.yoursite.com/adserver.
Make the Folder Writable
The Ad Server needs to be able to write to the files in the adserver/var folder and adserver/www folder to complete the installation successfully. If those folders are not writable then please update those folders permissions. In case of Linux, set permissions in the program menu or use the following command:
chmod -R a+w <folder path>/adserver
Install Adhere Ad Server
When all files are uploaded and the folder permissions are set, open the following URL: http://www.yoursite.com/adserver and follow the instructions.
When the installation is complete, Adhere Ad Server will log you in.
A configuration file is necessary to enable access to your ad server. This file is located in <folder path>/adserver/var. This file must be named after your web server's domain name or IP address. During insallation, this file is created by default after the domain name or IP address you use to install the Adhere Ad Server. For example, if you install the ad server using the path http://www.yoursite.com/adserver, the configuration file created will be named www.yoursite.com.conf.php. Upon completion of the installation, the ad server can only be accessed via http://www.yoursite.com/adserver.
If it is desired to make the ad server accessible via multiple domain names and/or IP addresses, a separate configuration file must be created manually for each domain name or IP address. However, note that only one configuration file contains the real configuration for Adhere Ad Server - the delivery domain configuration file. All other configuration files are place holders that will redirect to the real configuration file.
Example: It is desired to make an Adhere Ad Server accessible via the delivery domain name www.yoursite.com, also via domain name yoursite.com, and through IP address 123.123.123.1. In this case, the administrator must manually create two configuration files named as following:
- yoursite.com.conf.php
- 123.123.123.1.conf.php
These two files are place holders that redirect to the real configuration file, www.yoursite.com.conf.php.
If the Adhere Ad Server runs on Linux, then yoursite.com.conf.php and 123.123.123.1.conf.php are two symbolic links pointing to the real configuration file www.yoursite.com.conf.php. They can be created using the commands:
[var]# ln -s www.yoursite.com.conf.php yoursite.com.conf.php
[var]# ln -s www.yoursite.com.conf.php 123.123.123.1.conf.php
[var]# ls -l
...
-rw-r--r-- 1 root root 6205 Nov 18 13:33 www.yoursite.com.conf.php
lrwxrwxrwx 1 root root 22 Nov 18 13:37 yoursite.conf.php -> www.yoursite.com.conf.php
lrwxrwxrwx 1 root root 22 Nov 18 13:37 123.123.123.1.conf.php -> www.yoursite.com.conf.php
...
[var]#
You are now ready to use the Adhere Ad Server to manage your advertisers and operators. Please refer to Adhere
Ad Server Operation Guide for more information.