Home » Support » Documentation

Upgrading phpAdsNew

This guide covers the steps required to upgrade phpAdsNew and phpPgAds to the latest version of Openads 2.0. This is the first stage in upgrading phpAdsNew to the latest version of OpenX.

Here's the 7-step plan:

  1. Check the system requirements
  2. Download the Openads 2.0.11-pr1
  3. Step 3: Backup your files and database (optional)
  4. Extract new files to a temporary folder
  5. Copy over the config files
  6. Disable Maintenance
  7. Replace the old folder with the new one
  8. Appendix: Updating your inventory

Step 1: Check the system requirements

Using this upgrade process you can update all versions of phpAdsNew 2.0, phpPgAds 2.0 and Openads 2.0.

Note: Check the full list of OpenX 2.6 system requirements here. They are different than phpAdsnew/Openads 2.0 requirements.

Step 2: Download Openads 2.0.11-pr1

Download the latest version of Openads 2.0.11-pr1 for MySQL.

Note: phpPgAds users can follow this upgrade procedure using Openads 2.0.11-pr1 for PostgreSQL.

Note:: These instructions are not for MMM 0.1+ users. If you are using Max Media Manager, you do not need to first migrate to 2.0.11 -- you can upgrade directly to 2.6. Please see:
http://www.openx.org/docs/upgrading-openads

Step 3: Backup your files and database (optional)

We recommend that you backup your existing file system and database in case anything goes wrong during the upgrade.

Step 4: Extract new files to a temporary folder

Extract the new installation files to a temporary folder on your server. This temporary folder needs to be accessible from your browser in order to run the upgrade wizard. For example, if you use html_docs/phpadsnew, extract the new files to html_docs/phpadsnew_tmp.

Step 5: Copy over the config files

Copy the old config.inc.php file to the directory in your temporary folder.

Note: you must overwrite the supplied config.inc.php with your old version.

Step 6: Run the upgrade wizard

To start the upgrade wizard, open a web browser and point it to the temporary folder in which Openads was copied. This is exactly what you would do when logging into the administrator interface. Before the installer can start you must first enter your username and password.

After you login the Upgrade screen displays. Click the Proceed button to start the upgrade process. The installer will read the old config.inc.php and will attempt to upgrade the existing database. Once the database is up-to-date the installer will replace the old config.inc.php with a new one, containing the old settings.

Note: Depending on how many days' worth of statistics your old installation of Openads has - and from which version you are upgrading - this process can cause a high load on the database server. Please be patient as the upgrade can take up to a couple of minutes.

Step 7: Replace the old folder with the new one

The final step is to move the temporary folder so that it replaces the old one.

Note: if you save banner creatives on your file system you will need to copy these over, too.

Note: If you use the files delivery cache you need to make the cache directory writable again. Otherwise, Openads is not able to store or make changes to the delivery cache.

After you have replaced the old folder your ad server will be running Openads 2.0.11-pr1. The next step is to upgrade Openads to OpenX 2.6

Appendix: Updating your inventory

This information is only relevant to administrators using Openads 2.0 beta 6 or earlier.

After completing the upgrade all your existing advertisers should still be in your inventory. However, if you are updating from a version of phpAdsNew which doesn't yet support campaigns you will need to create a campaign for each advertiser before you can make changes to your banners.  If this is the case the Advertisers & Campaigns page won't list your banners; instead, there will be a line called "Banners" without a campaign. To make your existing banners usable click on the Move banners to a new campaign button.

If you are upgrading from a version that supports zones but doesn't yet support publishers, you need to convert your zones. If you go to the Publishers & Zones page you will see a line with the following text: Zones without a publisher. If you click on the Move zones to a new publisher button a new publisher will be created which holds all your existing zones.

Some older versions of phpAdsNew used a daily maintenance task. This is changed to an hourly scheduled task, so you might need to reconfigure your existing maintenance task. For more information about this subject, read the Maintenance chapter in the OpenX 2.0 user guide.