ÃÛ¶¹ÊÓƵ

DocumentationCampaignCampaign Classic v7 Documentation

[On-premise/hybrid only]{class="badge yellow" title="Applies to on-premise and hybrid deployments only"}

Integration into a Web server for Linux integration-into-a-web-server-for-linux

Last update: Mon Jun 17 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

ÃÛ¶¹ÊÓƵ Campaign includes Apache Tomcat which acts as the entry point in the application server via HTTP (and SOAP).

You can use this integrated Tomcat server to serve HTTP requests.

In this case:

  • the default listening port is 8080. To change it, refer to this section.

  • The client consoles then connect using a URL such as:

    code language-none 
    https://<computer>:8080

However, for security and administration reasons, we recommend using a dedicated Web server as the main entry point for HTTP traffic when the computer that is running ÃÛ¶¹ÊÓƵ Campaign is exposed on the Internet and you wish to open access to the console outside of your network.

A Web server also lets you guarantee data confidentiality with the HTTPs protocol.

Likewise, you must use a Web server when you wish to use the tracking functionality, which is only available as an extension module to a Web server.

NOTE
If you do not use the tracking functionality, you can perform a standard installation of Apache or IIS with a redirection to Campaign. The tracking Web server extension module is not required.

Configuring the Apache Web server with Debian configuring-the-apache-web-server-with-debian

This process applies if you have installed Apache under a distribution based on APT.

Apply the following steps:

  1. Disable the modules loaded by default using the following command:

    code language-none 
    a2dismod auth_basic authn_file authz_default authz_user autoindex cgi dir env negotiation userdir

    Ensure that the alias, authz_host and mime modules are still enabled. To do this, use the following command:

    code language-none 
    a2enmod  alias authz_host mime

  2. Create the file nlsrv.load in /etc/apache2/mods-available and insert the following content:

    In Debian 8:

    code language-none 
    LoadModule requesthandler24_module /usr/local/[INSTALL]/nl6/lib/libnlsrvmod.so

  3. Create the file nlsrv.conf in /etc/apache2/mods-available using the following command:

    code language-none 
    ln -s /usr/local/[INSTALL]/nl6/conf/apache_neolane.conf /etc/apache2/mods-available/nlsrv.conf

  4. Activate this module with the following command:

    code language-none 
     a2enmod nlsrv

    If you are using the mod_rewrite module for ÃÛ¶¹ÊÓƵ Campaign pages, you need to rename the nlsrv.load and nlsrv.conf files to zz-nlsrv.load and zz-nlsrv.conf. To activate the module, run the following command:

    code language-none 
    a2enmod zz-nlsrv

  5. Edit the /etc/apache2/envvars file, add the following lines:

    code language-none 
    # Added Neolane
if [ "$LD_LIBRARY_PATH" != "" ]; then export LD_LIBRARY_PATH="/usr/local/neolane/nl6/lib:$LD_LIBRARY_PATH"; else export LD_LIBRARY_PATH=/usr/local/neolane/nl6/lib; fi
export USERPATH=/usr/local/neolane

    Save the changes.

  6. Then add ÃÛ¶¹ÊÓƵ Campaign users to the Apache user group and vice versa using the following type of command:

    code language-none 
    usermod neolane -G www-data
usermod www-data -G neolane

  7. Restart Apache:

    code language-none 
    invoke-rc.d apache2 restart

Configuring Apache web server in RHEL configuring-apache-web-server-in-rhel

This procedure applies if you have installed and secured Apache under a RPM (RHEL, CentOS and Suse) based package.

Apply the following steps:

  1. In the httpd.conf file, activate the following Apache modules:

    code language-none 
    alias
authz_host
mime

  2. Deactivate the following modules:

    code language-none 
    auth_basic
authn_file
authz_default
authz_user
autoindex
cgi
dir
env
negotiation
userdir

    Comment the functions linked to deactivated modules:

    code language-none 
    DirectoryIndex
IndexOptions
AddIconByEncoding
AddIconByType
AddIcon
DefaultIcon
ReadmeName
HeaderName
IndexIgnore
LanguagePriority
ForceLanguagePriority

  3. Create an ÃÛ¶¹ÊÓƵ Campaign specific configuration file in the /etc/httpd/conf.d/ folder. For example CampaignApache.conf

  4. For RHEL7, add the following instructions in the file:

    code language-none 
    LoadModule requesthandler24_module /usr/local/neolane/nl6/lib/libnlsrvmod.so
Include /usr/local/neolane/nl6/conf/apache_neolane.conf

  5. For RHEL7:

    Add the /etc/systemd/system/httpd.service file with the following content:

    code language-none 
    .include /usr/lib/systemd/system/httpd.service

[Service]
Environment=USERPATH=/usr/local/neolane LD_LIBRARY_PATH=/usr/local/neolane/nl6/lib

    Update the module used by systemd:

    code language-none 
    systemctl daemon-reload

  6. Then add ÃÛ¶¹ÊÓƵ Campaign operators into the Apache operators group and vice-versa, by running the command:

    code language-none 
    usermod -a -G neolane apache
usermod -a -G apache neolane

    The group names to use depend on the way Apache is configured.

  7. Run Apache and the ÃÛ¶¹ÊÓƵ Campaign server.

    For RHEL7:

    code language-none 
    systemctl start httpd
systemctl start nlserver

Launching the Web server and testing the configuration launching-the-web-server-and-testing-the-configuration

You can now test the configuration by starting Apache. The ÃÛ¶¹ÊÓƵ Campaign module should now display its banner on the console (two banners on certain operating systems):

 /etc/init.d/apache start

The following information is displayed:

12:26:28 >   Application server for ÃÛ¶¹ÊÓƵ Campaign Classic (7.X YY.R build XXX@SHA1) of DD/MM/YYYY
12:26:28 >   Web server start (pid=29698, tid=-1212463424)...
12:26:28 >   Server started
12:26:28 >   Application server for ÃÛ¶¹ÊÓƵ Campaign Classic (7.X YY.R build XXX@SHA1) of DD/MM/YYYY
12:26:28 >   Web server start (pid=29698, tid=-1212463424)...
12:26:28 >   Server started

Next check that it responds by submitting a test URL.

You can test this from the command line by executing:

 telnet localhost 80

You should obtain:

Trying 127.0.0.1...
Connected to localhost.localdomain.
Escape character is '^]'.

Then enter:

GET /r/test

The following information is displayed:

<redir status='OK' date='YYYY/MM/DD HH:MM:SS' build='XXXX' host='' localHost='XXXX'/>
Connection closed by foreign host.

You can also request the URL https://myserver.adobe.com/r/test from a Web browser.

recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1