Managing Revive Adserver's configuration files.
Most configuration of Revive Adserver should be done via the administrative UI, but adding support for additional domain name access needs to be done outside of Revive Adserver.
Single Installation, Multiple Delivery/Image Domains
As an administrator user under Configuration > Global Settings > Banner Delivery Settings, it is possible to edit the Revive Adserver "Server Access Paths":
These are the main URLs that need to be used to access the admin interface, delivery scripts and locally stored images. While these can be edited via the Revive Adserver UI, only one domain can be set for each option.
However, it is possible to configure additional delivery/image domains manually.
For example, to extend the above configuration so that the same installation of Revive Adserver also works on "foo.com":
Step 1: Set up the required domain & web server hosting
Before changing anything in Revive Adserver, configure the necessary domain name and DNS settings, and set up your web server so that it responds to the new domain (e.g. "foo.com") and that it has the same hosting configuration as your existing Revive Adserver host (e.g. "example.com").
If this is working correctly, you should be able to go to, for example, http://foo.com/www/admin, and your webserver will end up serving the same content in the same way as if you had loaded http://example.com/www/admin - and, because your Revive Adserver installation's var directory has a file called default.conf.php in it, access to the Revive Adserver installation via any domain that it doesn't recognise will be treated as if it came from the domain listed in the realConfig entry of that default.conf.php file - which in this case, will be "example.com" - so, your Revive Adserver installation should still work (using the example.com domain).
Step 2: Copy the default config file to a domain config file
Make a copy of the default.conf.php file in your Revive Adserver's var directory, named according to the domain you want to use, in this case: foo.com.conf.php.
Now, when you access your Revive Adserver installation via the foo.com domain (instead of example.com), you'll still get the same outcome as in Step 1 above - but this time, instead of access doing via the default configuration file (which informs Revive Adserver to use the configuration located in the example.com.conf.php file), access will now happen via the foo.com.conf.php file (which does the same thing - it informs Revive Adserver that the real configuration to use can be found in the example.com.conf.php file).
Step 3: Extend the new domain config file to override the "default" domain settings
The magic that allows this type of setup to be enabled is that Revive Adserver configuration files can contain a realConfig entry, to inform Revive Adserver that the "real" configuration for how it should operate is located in another file, but it is also possible to add regular configuration directives to the same file, which then "override" the configuration directives of the realConfig file.
So, to enable the new foo.com.conf.php file to instruct Revive Adserver that when the service is accessed via the foo.com domain, it should operate using a set of server access paths that are specific to the domain, but otherwise, all other configuration items should be used as configured via the example.com domain configuration file, the foo.com.conf.php file should be extended to be:
;<?php exit; ?> ;*** DO NOT REMOVE THE LINE ABOVE *** realConfig="revive-dev.fornax.net" [webpath] admin="foo.com/www/admin" delivery="foo.com/www/delivery" deliverySSL="foo.com/www/delivery" images="foo.com/www/images" imagesSSL="foo.com/www/images"
Single Code Base, Multiple Installations
To be documented.