Contact
Site: US UK AU |

Installing Revive Adserver on your site

How to install Revive Adserver v3.0.2 on your Nexcess server

Overview
This article provides instructions for installing Revive Adserver v3.0.2 on your Nexcess hosting account.

Definition

Revive Adserver, formerly known as OpenX Source Ad Server, is an open-source system that allows website owners to manage and optimize the advertising space on one or more websites. 

Prerequisites

  • Your FTP account log in and server information provided in the Nexcess Welcome Email.
  • An FTP client application installed on your local drive. For information about installing FTP client applications, refer to Using FTP Client Programs .
  • A file archiving and compression tool to extract the .zip installation file, such as, 7-Zip or WinZip.

Notes

  • As a courtesy, we try to provide the most up-to-date information involving third-party technologies; however, we cannot guarantee the accuracy of such content, nor can we guarantee the performance of the product. If the text or example screenshots do not match your version, refer to the documentation provided by the applicable third-party company
  • This article assumes that you are installing Revive for the first time. If you currently have an older version of Revive and wish to upgrade, please follow the instructions provided on the Upgrading Revive Adserver page on the Revive website.
  • The instructions provided in this article assume that you are installing the application to your primary domain name, and therefore refer to your document root directory, also known as web root, as home/examplec/example.com/html, where examplec is the first eight characters of your domain name. If you have multiple domains on your Nexcess account, and wish to install Revive to a domain other than your primary, be sure to select that domain's document root directory when following these instructions.

1: Create a MySQL database and a user

Before installing Revive, you will need to create a MySQL database, which Revive will use to store its data. For instructions on creating a MySQL database through your SiteWorx account, refer to Creating a MySQL Database. Keep the database and user information for use during the Revive installation.

2: Download the installation files

Follow the steps below to properly configure the files to ensure successful installation.

  1. Open your browser and navigate to the Revive Adserver Downloads page,  locate and click the Download Revive Adserver v3.0.2 as zip. The download should start immediately.
  2. When the download completes, proceed to the next section.

3: Configure the installation files

Now that you have downloaded the Revive Adserver installation files, follow the instructions below to extract and upload the files to the document root directory on your your hosting account.

Attention:  home/examplec/example.com /html is the document root directory for your primary domain. If you have multiple domains and wish to install OpenX to a domain other than your primary, be sure to select the appropriate document root directory.
The instructions below refer to using the FileZilla FTP client. You can use whatever method or FTP client that you want.

  1. On your local drive, navigate to the location where you downloaded the .zip file.
  2. Using your file compression tool, extract the revive-adserver-3.0.2.zip file to your local drive.
  3. Wait for the file extraction process to complete.
  4. Open your FTP client and then connect to your hosting account.
  5. Navigate to the location where you uploaded the revive-adserver-3.0.2.zip file.
    Example Screen Showing OpenX Files Displaying in FileZilla 
  6. Next, rename the revive-adserver-3.0.2 folder on the local drive to revive; then all of the Revive files will be uploaded at once. Also, the URL specifically for accessing your Revive Adserver instance, on the website, will automatically be defined. For example, if your domain name is example.com and revive is the directory name, the URL will be: http://example.com/revive.

Attention: If you want the URL for your Revive Adserver installation to be a different name than revive, simply change the name of the revive-adserver-3.0.2 folder to the name you want. For example, if you want the URL to be http://www.example.com/ads, rename the revive-adserver-3.0.2 folder on your local drive to "ads", then in your /html directory create a folder titled ads.

  1. Click the revive-adserver-3.0.2 subdirectory to expand it.  Result: Another subdirectory, also named revive-adserver-3.0.2, will display.
  2. Right-click on the second subdirectory and then select Rename.
    OpenX Folders on Local Drive (Displaying in FileZilla)
  3. Next, perform one of the following:
  4. If you want your Revive installation to be titled, "revive", click inside the folder and move the cursor to the end character and click the Backspace key to delete the "-2.8.9" qualifiers from the folder name, do not delete openx and press Enter.
    Example Screen Showing Renaming of the openx-2.8.9 Folder

  5. If you want your OpenX installation to have a different name instead of "revive", click inside the folder, type the name, and then click  Enter.
  6. Upload the installation to your hosting account by navigating to the Remote Files section of the window and click on the /html directory. Result: the destination for the upload is designated.
    Example Screen Showing Upload of 'openx' Folder to Document Root Directory 
  7. In the Local site section, right-click on the revive folder or the folder that you renamed in Step 8., and then click Upload.

Attention: Due to the large number of files, the download may take five minutes or longer to complete.

4: Run the installation wizard

Follow the steps below to complete the installation.

  1. Open a browser window and type the URL for your domain name and the directory in which you installed Revive. For example, if your domain name was example.com and the directory that you created is revive, the URL would be:
    http://example.com/revive/.
  2. On the Welcome page, read the GNU General Public License, and click the "I Agree" check box to continue. Next, you will be prompted to either type your OpenX account log in information, or to create a new account. 

    OpenX Source Installation: Registration Page
  3. Select one of the following options:
    • If you registered during the download process, click the I have an OpenX.org account check box and then type your information.
    • If you did not register, or do not remember the information that you entered, click the I do not have an OpenX.org account check box. Type your information and then click the Create my account and continue >> button.
      OpenX Source Installation: Registration Complete
  4. Click Continue and type the details for the MySQL database that you created in Step 1. of this article.
    OpenX Source Installation: Enter Database Details
    Attention: When entering database information, be sure to enter the full name, the first eight characters of your domain name prefixed to the database and database username, such as examplec_openx.
  5. The details of the database that you created, are as follows:
    1. Database Name: The name that you assigned to the database prefixed with the first eight characters of your domain, followed by an underscore, such as, examplec_openx.
    2. Database Username: The username that you assigned to the database user account, such as, examplec_admin.
    3. Password: The password defined for the database user account.
    4. Database Hostname: localhost.
  6. Click Continue and then the installer prompts you to configure the administrator account for OpenX.
    OpenX Source Installation: Create Admin Account
  7. Type the information you want to use to define the OpenX admin account, as follows:
    1. Administrator Username: Username for the administrator account.
    2. Administrator Password and Repeat Password : Password for the administrator account.

Attention: You can use the Nexcess Password Generator to create a complex and secure password.

    1. Administrator email Address: This field should already be populated with the email address that you specified when you registered for an OpenX account. You can type a different email address where you want to receive OpenX correspondence.

8.  Click Continue and if no errors are detected, the installer displays a message indicating that installation is complete. Click Continue again.
OpenX Source Installation: Installation Complete

5: Secure your installation

Attention: For security reasons, you must make adjustments to select OpenX files. Follow the steps provided below:

  1. Open your FTP client and connect to your hosting account.
  2. Navigate to the /openx/www/admin directory.
  3. In the /admin subdirectory locate and delete, the install.php file.
  4. Navigate to the /openx/var directory. Two files with names which end with .conf.php should display.
  5. Right-click on the default.conf.php file and then select File permissions or whatever command your FTP client uses so you can chmod or modify file and directory permissions. All of the Read check boxes should be selected.
  6. If any of the permissions defaults have the Write and Execute check boxes selected, clear the check box; or you can type the numeric value, "444" . The following example screen displays permissions changed for the default.conf.php in FileZilla.
    Changing File Permissions of an OpenX File via FileZilla
  7. Repeat Steps 5-6 for the other .conf.php file. The file name will display with your domain, followed by conf.php. For example: example.com.conf.php.

 

For 24-hour assistance any day of the year, contact our Support Team by email or through the Client Portal.

Article Rating (No Votes)
Rate this article
  • Icon PDFExport to PDF
  • Icon MS-WordExport to MS Word
 
Attachments Attachments
There are no attachments for this article.
Related Articles RSS Feed
What is memcached?
Added on Tue, Jul 22, 2014
How to use TraceRoute
Added on Mon, Aug 5, 2013
How to use search engine robots
Added on Tue, Dec 31, 2013
How to change PHP versions in SiteWorx
Added on Wed, Oct 26, 2016
How to download backup files with SiteWorx
Added on Tue, Aug 6, 2013
Nexcess Acceptable Use Policy
Added on Thu, Jul 25, 2013
How to Install Joomla 3.2
Added on Tue, Mar 18, 2014
How to Install Drupal 7.2
Added on Thu, Mar 20, 2014
How to Install dotProject
Added on Thu, Mar 20, 2014