Home
Installation Guide
An installation of HCL Unica products is complete when you install, configure, and deploy the HCL Unica products . The Installation Guide provides detailed information about installing, configuring, and deploying the products.
Unica Campaign web application clustering
You can configure the Unica Campaign web application (J2EE application) in a cluster by completing additional tasks during the Unica Campaign installation.
Jboss clustering guidelines
For Installing Unica Campaign on Jboss cluster refer (Installation/Clusters_campaign/Clustering_intro_campaign.html).

Installation Guide
An installation of HCL Unica products is complete when you install, configure, and deploy the HCL Unica products . The Installation Guide provides detailed information about installing, configuring, and deploying the products.
- Installation overview
  An installation of HCL Unica products is complete when you install, configure, and deploy the HCL Unica products . The Installation Guide provides detailed information about installing, configuring, and deploying the products.
- Planning the Unica Campaign Installation
  When you plan your Unica Campaign and Unica Optimize installation, you must ensure that you have set up your system correctly, and that you have configured your environment to deal with any failures.
- Preparing data sources for Unica Campaign
  The Unica Campaign runtime environment uses data sources to store user and interaction data.
- Installing Unica Campaign and Unica Optimize
  You must run the Unica installer to start the installation of Unica Campaign and Unica Optimize. The Unica installer starts the product installer during the installation process. Make sure that the Unica installer and the product installer are saved at the same location.
- Configuring Unica Campaign and Unica Optimize before deployment
  Before you deploy, create and populate the Unica Campaign , Unica Optimize, and IBM eMessage system tables and register Unica Campaign, Unica Optimize, and IBM eMessage manually.
- Deploying the Unica Campaign web application
  You can deploy the Unica Campaign web application by using an EAR file or you can deploy the individual WAR files.
- Configuring Unica Campaign and Unica Optimize after deployment
  After you deploy Unica Campaign, you must verify that the Unica Campaign listener is running, set up the Unica Campaign system user, set Unica Campaign configuration properties, and verify the Unica Campaign installation.
- Configuring multiple partitions for Unica Campaign
  In the Unica family of products, partitions provide a way to secure the data that is associated with different groups of users. When you configure Unica Campaign or a related Unica application to operate with multiple partitions, users can see each partition as a separate instance of the application. There is no indication that other partitions exist on the same computer.
- Configuring multiple partitions for Unica Optimize
  In the Unica family of products, partitions provide a way to secure the data that is associated with different groups of users. When you configure Unica Campaign or a related Unica application to operate with multiple partitions, users can see each partition as a separate instance of the application. There is no indication that other partitions exist on the same computer.
- Configuring multiple partitions in eMessage
  Configure multiple partitions in IBM eMessage to isolate and secure data for different groups of IBM eMessage users. As each partition has its own set of configuration properties, you can customize IBM eMessage for each group of users.
- Unica Unica Platform utilities
  This section provides an overview of the Unica Platform utilities, including some details that apply to all the utilities and which are not included in the individual utility descriptions.
- Uninstalling Unica Campaign and Unica Optimize
  Run the Unica Campaign and Unica Optimize uninstaller to uninstall Unica Campaign and Unica Optimize. When you run the uninstaller, the files that were created during the installation process are removed. For example, files such as configuration files, installer registry information, and user data are removed from the computer.
- Unica Campaign web application clustering
  You can configure the Unica Campaign web application (J2EE application) in a cluster by completing additional tasks during the Unica Campaign installation.
  - Websphere clustering guidelines
    If you are installing Unica Campaign on a cluster in WebSphere®, complete these extra steps in addition to the steps for installing Unica Campaign on WebSphere.
  - Jboss clustering guidelines
    For Installing Unica Campaign on Jboss cluster refer (Installation/Clusters_campaign/Clustering_intro_campaign.html).
  - Configure ehcache
    The ehcache is an open source Java™ distributed cache for caching, Java EE, and light-weight containers. Every node in the cluster can use the same campaign_ehcache.xml file or you can set a different campaign_ehcache.xml file for each node. For installations in a cluster, edit the campaign_ehcache.xml file so you do not have to restart the computer if you change any templates or offer folders.
- Installing a clustered listener environment
  Follow these instructions if you want to install a clustered listener configuration. A listener cluster is a set of two or more listeners that act as a unit to provide load balancing and high availability. Unica Campaign listener clusters are Active-Active; meaning each node serves requests using the load-balanced approach. Each Unica Campaign listener provides an interface between front-end clients (such as the Unica Campaign web application) and back-end analytical server processes.

Jboss clustering guidelines

For Installing Unica Campaign on Jboss cluster refer (Unica Campaign web application clustering).

Preparing the data sources

You will need to add/create JNDI in the same JBOSS domain which you are planning to use in cluster. Please follow below steps to create JNDI.

Add required database modules in JBOSS. For example, oracle database -


jboss-cli.bat --connect --controller=JBOSS_DOMAIN_MASTER:MASTER_PORT --
commands="module add --name= oracle.jdbc --resources=<Database_Driver_Path\ojdbc8.jar> --
dependencies=javax.api,javax.transaction.api"

JNDI’s can be added by modifying domain.xml of both master and slave.

Deployment steps

In addition to the instructions in the deployment chapter (Deploying Unica Campaign on JBoss Application Server), complete the following tasks:

Launch JBOSS management console.
Navigate to “Deployments" tab. Select the ServerGroup.
Click on Add button under Deployments section
A pop up will be shown, browse the application WAR/EAR and complete the deployment process.

Tomcat Clustering Guidelines

For Installing Unica Campaign on Tomcat cluster refer (Unica Campaign web application clustering).

Note: EAR file is not supported for Tomcat cluster.

For Deployment Steps, you can refer (Deploying Unica Campaign on Tomcat Application Server)

Post deployment, JNDI name should be prefixed with "java:/comp/env/" for example: campaignPartition1DS should be mentioned as "java:/comp/env/campaignPartition1DS" while creating Unica Campaign UA_SYSTEM_TABLE Data Source.

Configure a load Balancer like nginx for redirecting request to all the nodes of Tomcat cluster.

Have feedback?
Google Analytics is used to store comments and ratings. To provide a comment or rating for a topic, click Accept All Cookies or Allow All in Cookie Preferences in the footer of this page.