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.
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.
Deploying Campaign on WebSphere Application Server
You can deploy the product runtime environment on supported versions of WebSphere® Application Server (WAS) from a WAR file or EAR file. The design time environment is deployed automatically with the product EAR or WAR file.
Deploying Campaign on WebSphere Application Server from a WAR file
You can deploy the product application from a WAR file on WAS.

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.
  - Optional: Setting the web application session timeout
    Session timeout determines how long an inactive HTTP session can remain open before the session expires. If required, you can set the web application session timeout for Unica Campaign by using the WebSphere® console or the WebLogic console to adjust the value of session timeout in seconds or minutes.
  - Deploying Campaign on WebSphere Application Server
    You can deploy the product runtime environment on supported versions of WebSphere® Application Server (WAS) from a WAR file or EAR file. The design time environment is deployed automatically with the product EAR or WAR file.
    - Deploying Campaign on WebSphere Application Server from a WAR file
      You can deploy the product application from a WAR file on WAS.
    - Deploying Campaign on WebSphere Application Server from an EAR file
      You can deploy the product by using an EAR file if you included Campaign.
  - Deploying Campaign on WebLogic
    You can deploy Unica products on WebLogic. If a console is not accessible or does not exist, you can emulate a console using VNC or Exceed kind of applications. Contact your technical administrator to enable GUI mode display on Linux environments.
  - Deploying Campaign on JBoss Application Server
    You can deploy Unica products on Jboss application server.
  - Deploying Campaign on Tomcat Application Server
    You can deploy Unica products on Tomcat application server.
  - Starting the Unica Campaign server
    Make sure that Unica Platform and Unica Campaign web applications are deployed and running when you start the Unica Campaign server.
- 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.
- 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.

Deploying Campaign on WAS from a WAR file

You can deploy the product application from a WAR file on WAS.

Before you begin

Complete the following tasks before you deploy the product:

• Confirm that your version of WebSphere meets the requirements in the Recommended Software Environments and Minimum System Requirements document, including any necessary fix packs or upgrades.

• Confirm that you created the data sources and database provider in WebSphere.

Procedure

Go to the WebSphere® Integrated Solutions Console.
Go to Applications > Application Types > WebSphere enterprise applications and click Install.
In the Preparing for the application installation window, select the Detailed - Show all options and parameters check box and click Next.
Click Continue to see the Install New Application wizard.
Accept the default settings on the windows of the Install New Application wizard except the following windows:
- In step 1 of the Install New Application wizard, select the Precompile JavaServer Pages files check box.
- In step 3 of the installation wizard, set the JDK Source Level to 18.
- In step 9 of the installation wizard, set the Context Root to /Campaign.
In the left navigation panel of WebSphere® Integrated Solutions Console, navigate to Applications > Application Types > WebSphere enterprise applications.
In the Enterprise Applications window, click the Campaign.war file.
In the Web Module Properties section, click Session Management and select the following check boxes.
- Override session management
- Enable Cookies
Click Enable Cookies, and in the Cookie name field, enter a unique cookie name.
In the Applications > Enterprise Applications section of the server, select the WAR file that you deployed.
In the Detail Properties section, select Class loading and update detection.
In the Class loader order section, select the Classes loaded with local class loader first (parent last) option. In the WAR class loader policy section, select the Single class loader for application option.
Enter the context root for the application as /Campaign.
Go to Application Servers > your server > Process definition > Java Virtual Machine.
Users can add the following JVM arguments to enable unicode support with this JVM.
- -Dfile.encoding=UTF-8
- -Dclient.encoding.override=UTF-8
Start your deployment.

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.