Overview
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. This article provides instructions on installing OpenX Source Ad Server v2.8.9 to your Nexcess hosting account.

• Your FTP account login and server information provided in your Nexcess Welcome Email.
• An FTP client application installed on your local drive. For information about installing FTP client applications, refer to How to Use FTP Client Programs.
• A file archiving and compression tool to extract the .zip installation file; for example, 7-Zip and WinZip.

• 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, please refer to the documentation provided by the applicable third-party company.
• This article assumes you are installing OpenX for the first time. If you currently have an older version of OpenX and wish to upgrade, please follow the instructions provided on the Upgrading OpenX page on the OpenX 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, or 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 OpenX to a domain other than your primary,  select that domain's document root directory when following these instructions.

Procedure

Create a MySQL database and user

Before installing OpenX, you will need to create a MySQL database, which OpenX will use to store its data. For instructions on creating a MySQL database through your SiteWorx account, refer to How to create a MySQL database. Make note of the database and user information so that you can input it during the OpenX installation.

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

1. Open your browser and navigate to the OpenX Downloads page and then click DOWNLOAD NOW. 
   A pop-up window appears, prompting you to read the limitations of using OpenX Source. 
   
2. If you accept the limitations and wish to proceed, click the check box and click DOWNLOAD.
3. The next page requires you to register. Fill in all required fields, and click Submit.
4. Click the appropriate .zip file download option. 
   
5. Wait for the download to complete and then proceed to Step 3.

Now that you have downloaded and extracted the OpenX installation files, follow the instructions below to upload the files to the document root directory on your your hosting account. Your primary domain uses home/examplec/example.com/html as the root directory. If you have multiple domains and wish to install OpenX to a domain other than your primary, select the appropriate document root directory.

There are various ways in which you can upload files to your hosting account. The instructions below refer to using the FileZilla FTP client. You can use whatever method or FTP client that you wish. 

1. On you local drive, go to the location where you downloaded the .zip file.
2. Using your preferred file compression tool, extract the openx-2.8.9.zip  file to a destination on your local drive.
3. Wait for the file extraction process to complete. Open your preferred FTP client and then connect to your hosting account.
   • 
4. Navigate to the location where you extracted the openx-2.8.9 file. 
5. Rename the openx-2.8.9 folder on the local drive to openx so all OpenX files will be uploaded at once. Also, since the openx folder will be uploaded to your document root directory /html, the URL for accessing OpenX on the website will automatically be defined. For example, if your domain name is example.com and openx is the directory name, the URL will be http://example.com/openx.
6. If you want the URL for your OpenX installation to be something other than openx, change the name of the openx-2.8.9 to the desired name. For example, if you want the URL to be http://www.example.com/ads, rename the openx-2.8.9  folder on your local drive to be ads, then in your /html directory, create a folder named ads.
7. Click to expand the openx-2.8.9 subdirectory.
8. There will be another subdirectory, also named openx-2.8.9.
9. Right-click on the second subdirectory and then select Rename.
   • 
10. Do one of the following:
    1. If you want your OpenX installation to be named openx, click inside the box and move the cursor to the end of the file extention.
    2. Press Backspace to delete the -2.8.9 part of the folder name, but do not delete the openx. Press Enter.
    • 
11. If you want your OpenX installation to be named something other than openx, click inside the field and type your name, and press Enter.
12. From the Remote site window, click on the /html directory to upload to your hosting account..
13. From Local site, right-click on the openx folder or the folder that you renamed in Step 8., and select the Upload option.
14. Wait for the upload to complete. Due to the large number of files, it may take a few minutes.

Follow the steps below to complete the installation:

1. Open a browser window and enter the URL according to your domain name and the directory in which you installed OpenX. For example, if your domain name was example.com and the directory that you created is openx, the URL would be http://example.com/openx/.
2. On the Welcome page, read the GNU General Public License. If you agree to the terms, click I Agree.
3. You will be prompted to either enter your OpenX account login information, or to create a new account.
4. Do one of the following:
   1. If you registered during the download process, select I have an OpenX.org account  and enter your information.
   2. If you did not register, or cannot remember your information, select I do not have an OpenX.org account. Enter your information and click Create my account and Continue.
      • 
5. Click Continue. Enter the details for the MySQL database that you created as outlines in the Create a MySQL database and user section of this article.
6. When entering database information, enter the complete name, include the first eight characters of your domain name prefixed to the database/database username; for example, examplec_openx.
7. Enter details of the database that you created as follows:

1. 1. Database Name: The name that you assigned to the database, prefixed with the first eight characters of your domain, followed by an underscore (_); for example, examplec_openx.
   2. Database Username: The username that you assigned to the database user account ; for example, "examplec_admin."
   3. Password: The password defined for the database user account.
   4. Database Hostname: Enter localhost.

      8.  Click Continue. The installer prompts you to configure the administrator account for OpenX.  

1. 1. Administrator Username: Enter your desired user name for the administrator account.
   2. Administrator Password, Repeat Password: Enter your desired password for the administrator account. If necessary, use the Nexcess Password Generator to have a complex and secure password created for you, then copy and paste it into these fields.
   3. Administrator email Address: This field should already be populated with the email address that you specified when you registered for an OpenX account. If needed, you can enter a different e-mail address where you want to receive OpenX correspondence.

   10. Click Continue. If no errors were detected, the installer displays a message indicating that installation is complete: 

Attention: For security reasons, you must make adjustments to select OpenX files using the following procedure:

1. Open your FTP client and connect to your hosting account.
2. Navigate to the /openx/www/admin directory. 
   
3. Within the /admin subdirectory, delete the install.php file.
4. Navigate to the /openx/var directory. You should see two files whose names end with .conf.php. 
   
5. Right-click on the default.conf.php  file and select File permissions, or use whatever command in your FTP client that allows you to modify file and directory permissions. Only the Read check box should be selected.
6. If any of the permissions shows with Write or Execute selected, clear the check box. Alternatively, you can simply enter numeric value, "444." The following example screen shows permissions being changed for the default.conf.php in FileZilla. 
   
7. Repeat Steps 5-6 for the other .conf.php file. The file name will show with your domain, followed by conf.php. For example: example.com.conf.php.
8. You have successfully installed OpenX Source to your domain. If you would like to begin customizing it, open your preferred browser and enter the web address for your domain name in the address bar followed by /. Finally, enter the name of the folder within your domain's document root directory where you installed OpenX; for example, http://example.com/openx.

For additional help with installation and configuration, contact the Nexcess Support Team or visit the OpenX website.