Prerequisites

The following pre-requsites must be fulfilled before you begin the HCL® Marketing Software Director installation:

  1. Apache ActiveMQ -5.15.7 is configured in the customer environment. HCL Marketing Software Director does not bundle or provide Apache ActiveMQ. You must download, install and configure it. Before beginning the HCL Marketing Software Director installation you should have the ActiveMQ - Broker URL, port and credentials. You are required to provide this information while installing HCL Marketing Software Director.
  2. You should install the HCL Marketing Software Director agent on the Campaign systems (Web application and listener machines) - You must have the required information or access to install Marketing Software Director on these machines. Example - Operating system details like - hostname, login details, installation location and so on.
  3. Please identify ports that could be used for Server component and Agent components. These ports should not be in use by any other service or application on the machine.

  4. Add Campaign Listener Hostname in application:

    Note: The Listener Hostname cannot be an IP address.

    1. Login to Unica.

    2. Go to Settings ->Configuration.

    3. Got to Campaign ->unicaACListener.

    4. Update the ServerHost to Hostname.

    Add the following Active MQ Setting for Campaign:

    1. Go to Settings -> Configuration.

    2. Go to FlowchartEvents . set “enableEvents" to yes.

    3. Go to FlowhcartEvents-> ActiveMQ . Fil in all ActiveMQ details.

    For example:

    url tcp://zebra39.nonprod.hclpnp.com:61616
    Marketing Platform User with Data Sources for ActiveMQ Credentials asm_Admin
    Data Source For ActiveMQ message broker credentials ACTIVEMQ_CRED_DS
    queueName flowchartInfo-campaign_rb

    4. Go to Setting -> Users -> Select respective User -> Edit data sources -> Add New.

    For example:

    Data source ACTIVEMQ_CRED_DS
    Data source login admin
    Data source password admin
    Confirm password admin
  5. Assign all the data sources to the Marketing Platform user who is logged on to the HCL Director server. He can only then be able to perform a Test connection of Data sources within the HCL Marketing Software Director.
  6. Install HCL Marketing Software Director Agent with the same user using which Campaign Listener or Campaign application was installed, so that it will have access to all the Campaign directories to access logs or start / stop / restart campaign listener.
  7. A separate database schema/user are required to create and maintain system tables for Director. This database schema/user can be used once as the same as Campaign/Marketing Platform product but it can be a separate one.
  8. Applicable only to the Windows OS - The Marketing Software Director - Agent system (on the computer where the Campaign Listener is installed):

    Please make sure that the following performance counters are available. You can check this by launching the Performance Monitor:
    • Processor Time
    • Working Set
    These counters help the HCL Marketing Software Director - Agent application to gather the statistics of the Campaign listener or server processes on memory and CPU utilization.
    Note: If the performance counters are not available, open the command prompt as an administrator on the target server and enter the following commands to rebuild the performance counters. Otherwise you will not be able to see the data in the System Usage Graph on the Windows Operating System.
    • For 32 bit machine:
      • cd %windir%\system32\
      • lodctr /R
    • For 64 bit machine:
      • cd C:\Windows\SysWOW64\
      • lodctr /R