Difference between revisions of "How to Configure a Web Ad Manager Server"

Revision as of 12:14, 5 May 2021

Web Ad Manager consists of the following parts:

• the Ad Manager desktop application components: these include the ActiveX components which expose the Ad Manager data and business logic to the web application;
• the Ad Manager Web Host service: it provides the context in which the web application loads the Ad Manager ActiveX components;
• the Apache HTTP Server with a PHP preprocessor: it makes the web application accessible on the Internet;
• the web application files: the HTML, CSS, Javascript, PHP and other files which make up the web application.

Please note that the Web Ad Manager Server components cannot be installed on a machine that has IIS currently installed on it, as this is incompatible with the server components used.

Install Ad Manager

Install Ad Manager (including any add-ins) as if you're setting up another client workstation.

Install and configure the Ad Manager Web Host service

Set up a Windows user account for the Web Host service

The Web Host service needs to run as a Windows user who:

• can run Ad Manager if logged on interactively;
• belongs to the local machine's "Administrators" group.

1. Pick or create a user account; make sure the account belongs to the local "Administrators" group.

2. Log on as that user, run Ad Manager and import the Ad Manager serial number and license into the user profile.

3. Make sure you can access all Ad Manager databases that will be exposed through the web application.

Install and register the Web Host service

1. Run the Ad Manager Web Host installer (Amwh.msi); install for "Everyone".

2. Register the service: run cmd.exe as an administrator and execute the following commands:

cd "C:\Program Files (x86)\Dot2Dot\Ad Manager Web Host"
cpwh.exe -service

3. Use the "Services" management console to configure the "Dot2Dot Ad Manager Web Host Service" to log on as the user account you configured earler.

4. Test the configuration by starting and stopping the service.

5. Launch the "Component Services" management console; create a COM+ server application called "Web Ad Manager" running as "Local Service"; import the "Cpwh.DateTime" coponent from the 32-bit registry into the application.

Configure the Web Host database connections

Select the "Configure" shortcut in "Start : All Programs : Dot2Dot Ad Manager Web Host" and add a connection for each database that will be exposed through the web application.

Set Up the Web Server

Install WampServer

Follow the instructions at the WampServer download page. The latest Microsoft Visual C++ Redistributable components are a pre-requisite.

See SSL/TLS Strong Encryption: How-To for instructions on configuring HTTPS.

Allow incoming connections to the web server port

Use the "Windows Firewall with Advanced Security" management console to allow the incoming connections.

Select the appropriate PHP version

The highest PHP version the Ad Manager web applications are compatible with is 7.3.x.

Tweak the PHP configuration

Edit the "php.ini" file.

1. Disable the script execution timeout:

max_execution_time = 0

2. Increase the memory limit:

memory_limit = 1024M

Create the Ad Manager web applications

Extract the web application archives into sub-directories of the Apache document root directory (usually C:\wamp64\www). Your directory structure should look like this:

C:\wamp64\www
- wam
  + api
  + fonts
  + img
  + js
    app.xml
    index.html
- wam-pub
  + api
  + fonts
  + img
  + js
    app.xml
    index.html

Edit the "httpd-vhosts.conf" file to enable remote access to the new directories.

# Virtual Hosts
#
<VirtualHost *:80>
  ServerName localhost
  ServerAlias localhost
  DocumentRoot "${INSTALL_DIR}/www"
  <Directory "${INSTALL_DIR}/www/">
    Options +Indexes +Includes +FollowSymLinks +MultiViews
    AllowOverride All
    Require local
  </Directory>
  <Directory "${INSTALL_DIR}/www/wam">
    Options +Indexes +Includes +FollowSymLinks +MultiViews
    AllowOverride All
    Require all granted
  </Directory>
  <Directory "${INSTALL_DIR}/www/wam-pub">
    Options +Indexes +Includes +FollowSymLinks +MultiViews
    AllowOverride All
    Require all granted
  </Directory>
</VirtualHost>

Configure the Ad Manager web features

1. Edit the online sharing options: "Tools : Options : Online Sharing".

2. Import the web application roles: "Tools : Import Web App : From URL...".

3. Create Web Users.

Configure SSL/TLS

Purchase an SSL certificate

1. Create a server key and a certificate signing request (CSR).

E.g. using OpenSSL:

openssl genrsa -out host.example.com.key 2048
openssl req -new -key host.example.com.key -out host.example.com.csr

2. Use the CSR to purchase an SSL certificate from a certificate issuing authority.

E.g. Digicert, GoDaddy, etc.

Configure Apache for SLL