+---------------------------------------------------------------------------+
| Revive Adserver                                                           |
| http://www.revive-adserver.com                                            |
|                                                                           |
| Copyright: See the COPYRIGHT.txt file.                                    |
| License: GPLv2 or later, see the LICENSE.txt file.                        |
+---------------------------------------------------------------------------+

Release Notes: Revive Adserver 4.2.0
====================================

These release notes cover what's new, system requirements, download and
installation instructions, known issues and frequently asked questions for
Revive Adserver. Please read these notes before reporting any bugs.


What's New in Revive Adserver 4.2.0
-----------------------------------

 * Release date: 23 April 2019


 Security Updates
 ----------------

 * Fixed multiple vulnerabilities, for more information, visit:
   https://www.revive-adserver.com/security/revive-sa-2019-001


 New Features
 ------------

 * Updated the definition of "Active" Advertisers and Campaigns in the UI
   to also include Advertisers and Campaigns which will become active in
   the future (i.e. in the "Awaiting" state), to help with their management.

 * Renamed the "Legacy" Browser and Operating System delivery rules, which
   have been retained so far for compatibility for users upgrading from
   earlier versions, to "Deprecated", in preparation for removing these
   delivery rules in a future major release.

 * Improved how the user/account management permission is named in the UI.

 * The Zone Probability screen now includes a link to the parent campaign
   for each banner.

 * Replaced the old "weight" measure on the Zone Probability screen with
   the actual Campaign and Banner weights, to improve clarity around
   probabilities of banner display in a zone.

 * Added support for hourly statistics to the XML-RPC API.

 * IP anonymisation enabled and targeting OAID cookie disabled by default
   on new installations.


 Bug Fixes
 ---------

  * Fixed PHP 7.3 incompatible usage of continue statements within switch
    constructs.

  * Fixed incorrect text for the "Site - Delivery Rule Set" delivery rule.

  * Fixed JS error when using the resizable iframe invocation type and no
    banner is delivered.

  * The background row highlighting on the Zone Probability screen has
    been fixed.

  * Restored english US translation, in order to have the "month/day" date
    format as an option.

  * Fixed issue with manually rebuilding banner cache when using the user
    language preferences are not set to english.
    
  * Fixed an issue saving the User Interface Preferences under some
    circumstances.


 Non-Backwards Compatible Changes
 --------------------------------

 * Revive Adserver now requires at least PHP 7.0.8.

 * Revive Adserver now requires the zip extension, whose presence was
   already needed by the HTML5 banner support, but previously not
   enforced.

 * XML-RPC invocation is deprecated and requires manually renaming
   www/delivery/axmlrpc.txt to www/delivery/axmlrpc.php in order to
   restore XML-RPC invocation functionality. However, this is not
   recommended, and users are advised to move to another form of delivery
   and remove the axmlrpc.php file again as soon as practicable.

 * Removed an unnecessary and undocumented XML-RPC delivery script,
   called www/delivery/dxmlrpc.php.


System Requirements
-------------------

Before installing, please make sure your server meets the system
requirements, which can be found at https://www.revive-adserver.com/.


Downloading and Installing
--------------------------

 * Downloading Revive Adserver

   You can always find the latest version of Revive Adserver at
   https://www.revive-adserver.com.

 * Installing Revive Adserver

   Installing Revive Adserver is a straightforward process. Follow the steps at
   https://www.revive-adserver.com/support/installation/.

 * Upgrading Revive Adserver

   Upgrading Revive Adserver is a straightforward process. Follow the steps at
   https://www.revive-adserver.com/support/upgrading/.

   Please note: The upgrade process will update your Revive Adserver database,
   and the database may no longer be compatible with your old installation.
   You *must* create a backup of your database before you upgrade, just in case.

   The upgrade wizard supports upgrading from:

   ---------------------------------------------------------------
   | Product                             | Version(s)            |
   ---------------------------------------------------------------
   | Revive Adserver 4.x                 | All previous versions |
   ---------------------------------------------------------------
   | Revive Adserver 3.x                 | All versions          |
   ---------------------------------------------------------------
   | OpenX 2.x                           | All versions          |
   ---------------------------------------------------------------
   | Openads 2.4                         | All versions          |
   ---------------------------------------------------------------
   | Openads 2.0 for MySQL               | 2.0.11-pr1            |
   |   (formerly phpAdsNew)              |                       |
   ---------------------------------------------------------------
   | Openads 2.3 alpha                   | 2.3.31-alpha-pr3      |
   |   (formerly Max Media Manager v0.3) |   (v0.3.31-alpha-pr3) |
   ---------------------------------------------------------------
   | Openads 2.3 beta                    | All versions          |
   ---------------------------------------------------------------
   | Max Media Manager v0.1              | v0.1.29-rc            |
   ---------------------------------------------------------------
   | Openads 2.0 for PostgreSQL          | 2.0.11-pr1            |
   |  (formerly phpPgAds)                |                       |
   ---------------------------------------------------------------

   If you are not running one of these versions, you will need to upgrade
   your existing installation before you will be able to upgrade to
   Revive Adserver.

 * Uninstalling Revive Adserver

   To uninstall Revive Adserver, delete the installed files and database tables.


Known Issues
------------

This list covers some of the known problems with Revive Adserver. Please read
this before reporting any new bugs.

 * The upgrade process may time out with very large databases. See
   https://www.revive-adserver.com/docs/faq for more information if you
   have a large database.

 * If you want to run Revive Adserver with MySQL, please note that MySQL 4.1 or
   higher is required. If you are using an older version of MySQL, you will
   need to update you database software before upgrading.

 * If you want to run Revive Adserver with PostgreSQL, please note that
   PostgreSQL 8.1 or higher is required. If you are using an older version of
   PostgreSQL, you will need to update your database software before
   upgrading.

 * Some of the PEAR libraries used are not compatible with database prefix
   names with double "_" characters (e.g. "rv__"). You should NOT install
   Revive Adserver with a prefix of this format.

 * Some users have reported issues of being logged out when viewing
   statistics. This can be worked around by ensuring that the timezone is
   correctly set in PHP.

 * See https://www.revive-adserver.com/support/bugs/ for the latest bug reports.


FAQ
---

 1. Can I upgrade from OpenX Source?

    Yes. OpenX Source has rebranded as Revive Adserver. You will be able to
    upgrade from any version of OpenX Source.

 2. Where can I get help?

    You can ask for help at the Revive Adserver community forums:
    https://forum.revive-adserver.com/

 3. What can I do to help?

    We need help from both developers and users to provide as much feedback
    as possible to make Revive Adserver even better. You can contribute
    feedback, bug reports, submit patches or help with documentation by
    visiting https://www.revive-adserver.com/.
