Frequently Asked Questions - Upgrading

OpenX 2.4+ does not allow for banners to be linked to zones by keyword. After upgrading from 2.0 you will still have all of your inventory but any banners linked to a zone by a keyword will need to be re-linked by campaign or banner ID.

We have a page of information devoted to upgrading. You can go to that page by clicking here.

Openads 2.4 now supports the full range of MaxMind geotargeting databases . As a result, some of the geotargeting options in Openads 2.0 are no longer compatible with the new targeting options. On upgrading to Openads 2.4, the following targeting options may need to be modified:

• US/CA State
• Region (Africa)
• Region (Asia)
• Region (Australia/Oceania)
• Region (Caribbean)
• Region (Europe)
• Region (North America)
• Region (South America)
• Region (Unknown)

Any banner using a delivery limitation of these types may have its delivery limitations modified on upgrade. A delivery limitation of the above type will only be modified in the event that the limitation targets the banner to more than one regions, and where there are at least two regions in different countries, within that single limitation. For example:

In this example, the single "Region (Europe)" geotargeting limitation targets regions in more than one country. As a result, this single delivery limitation would be updated to be two separate delivery limitations - one where "Region (Europe)" is equal to "Bosnia and Herzegovina, Federation of Bosnia and Herzegovina", and another where "Region (Europe)" is equal to "Belgium, Antwerpen OR Belgium, Brabant". These two delivery limitations will be joined together with an "OR" operator.

While this works in most situations, if you have a delivery limitation that needs to be converted, and it is combined with another limitation using the "AND" operator, then the delivery limitations for that banner after the upgrade may not be the same as before.

It is recommended that, if you receive the warning that some limitations may be modified, you check the "openads_upgrade_2.0.11_to_2.3.32_beta_XXXX_XX_XX_XX_XX.log" file (in the Openads var/ directory) after upgrading. It will contain the details of all banners (if any) that were modified which you should check to ensure the targeting is correct. (Simply search the log file for "Upgraded incompatible region geotargeting limitation." to find the appropriate section. If you can't find it, no banners needed modification, and your delivery limitations have been updated without modification.)

There are several possible error messages you might be seeing here depending on the type of geotargetting database you are using, these include:
MaxMind

• "A GeoIP database is not readable."
• "A GeoIP database malformed."
• "A GeoIP database was not found."

If you see any of these messages, for whatever reason, your MaxMind geotargeting database cannot be correctly read by Openads 2.4. You can safely proceed with the upgrade, however, once the upgrade is completed, you must log in as the admin user, and go to Settings, Main Settings, Geotargeting Settings, and re-configure the path(s) to your MaxMind geotargeting database(s).
Ip2Country

• "The Ip2Country geotargeting database is no longer supported."

Unfortunately, Openads 2.4 no longer supports the Ip2Country geotargeting database. You can safely proceed with the upgrade, however, once the upgrade is completed, you will not have any geotargeting support. If you wish to have geotargeting support, you will need to obtain a copy of the MaxMind country geotargeting database. MaxMind have both a free and paid for version of this database.

Please note that in both of the above cases, any banners that you have targeted to geotargeting data (for example, if you have a banner set to deliver only when the country is equal to the USA), will not deliver after you have upgraded until you re-configure the geotargeting database(s).