The instructions below are not intended to be complete for every possible scenario, server operating system, or database software. If you don’t understand part or all of these installation instructions, please consider asking a colleague, friend, or anyone else you know who has more technical expertise to assist you with the installation. The instructions below should be sufficiently clear for them to complete the installation successfully.
Before proceeding, please study the Technical requirements for Revive Adserver, to make sure your server is compatible.
If you are currently using OpenX Source, the predecessor of Revive Adserver, you should not be looking at these installation instructions, but rather at our page about upgrading from OpenX Source to Revive Adserver.
Here are the steps to install a new instance of Revive Adserver on your server:
1. Download the most recent version of the Revive Adserver software
To obtain the most recent version of the Revive Adserver software, visit the Downloads page on this website and click the button of the compressed file format of your choice. We have both .zip and .tar.gz files available. Store the downloaded file on your computer in a location where you can easily find it later.
2. Create a folder on your web server and upload the software
This installation procedure assumes you are going to install the Revive Adserver software in a sub directory of your website’s main address. For example, if your website is www.example.com, you could install in www.example.com/revive or www.example.com/adserver. Select a sub directory name and make a note of the name you decided on.
A word of advise: do NOT include a version number in the folder name! Once you have installed the software, this folder name will be used for all future versions and upgrades. Having a version number in the folder name will quickly become confusing. Have a look at this article about selecting a location for your ad server installation.
Using your FTP program, log in on your server and navigate to the directory of your web site’s main folder. Then create a new folder just below it with the name you selected.
Finally, you need to upload the software onto your web server, in one of these two ways:
- decompress the file you downloaded on your local disk (making sure that folder names inside the archive are retained) and upload all of the resulting files and folder from your local disk to your web server, or
- upload the compressed file to your web server, and unpack it there (from the command line), again making sure the folder names are retained.
3. Prepare a new database
Revive Adserver can work with either MySQL or PostgreSQL database software. The best option is to create a new database that will be used just for the data related to the Revive Adserver.
Create a new database using the tools available on your server. We recommend using a database name that makes it very clear what the purpose of the database is. Something like “revive_adserver” will do nicely. However, you might want to consider adding something to the name to indicate which software version the database is for, like “revive_adserver_3” if you are installing version 3 software. In the future, when it is time to upgrade to the next version, this will make things a lot easier (trust us, you will thank us later).
Create a new database user name, for example “revive_adserver”, and give this user the “all privileges” permissions on the database you created earlier. At this stage, you will have to decided on a password for the database user. Please make sure to create a safe, random password of sufficient length. The Random.org website offers a free tool to generate an entirely random, safe password.
Keep a note of the database name, database username and password you used, you will need it during the next steps. You will also need the ‘host name’ of the database server. In many cases, this is ‘localhost’, but you may need to consult the support pages or support staff of your hosting provider.
Many hosting providers provided web based tools for the creation of new databases and the associated security details. It is of vital importance that the database user has ‘all privileges’ on the newly created database. If not, the installation script (see below) will notify you and refuse to continue.
4. Open a web browser and start the installation process
To get started with the actual installation process, open your favorite web browser and navigate to the web address (URL) that corresponds with the folder you created on the web server.
For example, if you’ve decided to use the folder name ‘adserver’, enter the address www.example.com/adserver in the address bar of your browser and press Enter.
The installation wizard will start automatically and present the Welcome screen.
5. Follow the instructions on the screen to complete the installation
Just follow the instructions and recommendations displayed on the screen to move through the steps of the installation.
In one of the first screens to be displayed, you will be instructed to modify the ‘permissions’ of several of the folders that were created in step 3 above. Each folder you will need to modify will be clearly indicated. The permissions needed are ‘777’. Do NOT set all of the folders and files to these permissions, just the few files and folders indicated on the screen.
At some point in the process, you will be asked to enter the username, password and e-mail address of the person who will become the technical administrator of the ad server. Here are some tips and recommendations:
- Do not use the user name ‘admin’ out of habit. Your ad server (like any application on the internet) will become the target of hacking attempts as soon as it’s online, and the first username that will be tried is ‘admin’. Use a longer username. Do not use your e-mail address as your username. In general, do not use anything that can be guessed or constructed easily by an outsider.
- Do not use the same username and password you used for the database.
- Use a safe, random password that is sufficiently long. Like with the database password in one of the steps above, you can use the free tool at Random.org to generate a safe password. Do NOT use the same password that you already used for the database user.
6. Final steps: securing your installation
After the installation process has completed successfully, you will have one final task:
- Using your FTP program, navigate to the ‘var’ folder that’s part of the Revive Adserver folders. If you’ve setup the application in the ‘adserver’ folder, then you will need to navigate to the ‘adserver/var’ folder.
- In this folder, you will see a file with a name that starts with the web address of your site and ending in ‘conf.php’. For example, if you’ve setup your ad server in www.example.com/adserver, than the configuration file will be named ‘www.example.com.conf.php’.
- Using your FTP program, change the permissions of this file from ‘777’ to ‘644’.
This will ensure that your new ad server system is ‘locked’ so that nobody can make changes to the configuration without your consent. If you want to make changes to the system configuration and settings at a later stage, just change the permissions to ‘777’ temporarily, and don’t forget to change them to ‘644’ again after you’re done.