Welcome
Upgrade Guide
Upgrade Guide
Upgrading Unica Interact
You can upgrade Unica Interact by overwriting your existing Unica Interact installation. If you cannot upgrade your current version of Unica Interact directly, you must install Unica Interact in a new location.

Unica Interact
Release Notes
System Requirements
Installation Guides
Upgrade Guide
- Upgrade Guide
  - Upgrade overview
    An upgrade of Unica Interact is complete when you upgrade, configure, and deploy Unica Interact. The Unica Interact Upgrade Guide provides detailed information about upgrading, configuring, and deploying Unica Interact.
  - Planning the Unica Interact upgrade
    Upgrade your installation of Unica Interact after understanding the guidelines that are specific to your current version of Unica Interact.
  - Upgrading Unica Interact
    You can upgrade Unica Interact by overwriting your existing Unica Interact installation. If you cannot upgrade your current version of Unica Interact directly, you must install Unica Interact in a new location.
    - Backing up the Interact runtime environment
      Before you upgrade Unica Interact, back up all the files, system table database, and configuration settings that are used by the Unica Interact runtime environment to prevent loss of data and configuration settings.
    - Undeploying the Interact runtime server
      Before you upgrade Unica Interact, you must undeploy the Unica Interact runtime server so that the Unica Interact installer can complete a clean and error-free upgrade.
    - Running the installer
      You must run the Unica installer to upgrade Unica Interact. The Unica installer starts the Unica Interact installer during the process.
    - Reviewing and modifying the SQL upgrade script
      If your Unica Interact runtime environment includes customizations to the runtime system tables that modified the default Data Definition Language (DDL) included with Unica Interact, you must modify the default SQL upgrade script for your database to match your customizations.
    - Setting environment variables
      Set environment variables in the setenv file to upgrade the Unica Interact design time and runtime environment.
    - Running the upgrade tool for the design time environment
      Run the upgrade tool for the design time environment to update the Unica Interact tables in the Unica Campaign system tables. Run the upgrade tools for the runtime environment to update the Unica Interact run time, learning, contact history, response history, and user profile tables.
    - Redeploying the Interact runtime server in the web application server
      After you finish upgrading Unica Interact, redeploy the newly installed version of the Unica Interact runtime server in the application server. NOTE: After upgrade, it is observed that configuration Node treatmentStore is displayed under :Affinium|Interact|services|contactHist| Removal of this configuration can be done using the Platform configTool.sh/configTool.bat
    - Upgrade log
      When you upgrade Unica Interact, the Unica Interact upgrade tools write processing details, warnings, and errors to the aci_upgrade.log file. Check the log file to verify that you have an error-free and clean upgrade.
    - Upgrading partitions
      For the design time environment, if you have multiple partitions, you must run the upgrade tool once for each partition. For the runtime environment, if you have multiple partitions, run the upgrade tool once on each runtime server.
    - Creating and populating the Unica Interact system tables
      This is applicable in case of a Manual Database setup. If you have not created and populated the system tables during the installation process, use your database client to run the Unica Interact SQL scripts against the appropriate database or to create and populate the Unica Interact runtime environment, design time environment, learning, user profile, and contact and response tracking data sources.
    - Deploying Unica Interact
      You must deploy the Unica Interact runtime environment for every instance of the runtime server that you install. You can deploy Interact Design time environment on the same machine or a different machine as runtime environment using the InteractDT EAR or InteractDT WAR.
    - Additional configuration for enhanced security
      The procedures in this section describe some additional configurations in the web application server. They are optional, but you might want to perform them for enhanced security.
  - Uninstalling Unica Interact
    Run the Unica Interact uninstallers to uninstall Unica Interact. When you run the Unica Interact 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.
  - configTool
    The properties and values on the Configuration page are stored in the Unica Platform system tables. You can use the configTool utility to import and export configuration settings to and from the system tables.
- Fast Upgrade Guide
Administrator Guide
Unica Interact provides documentation and help for users, administrators, and developers.
User Guide
Unica Interact provides documentation and help for users, administrators, and developers.
Tuning Guide
An installation of Unica Interact consists of several components including third-party tools (such as web application servers, databases, and load balancers) and components such as Unica Platform and Unica Campaign. All of these components have several properties, features, and settings you can configure to improve performance.
System Tables
Reports
Macros for HCL Unica
Macros can be used in Unica Campaign and Unica Interact to enhance your flowcharts.
GDPR Guide
Unica Interact provides documentation and help for users, administrators, and developers.
Rest API Guide
Licensing Guide
PDFs
Glossary
Notices

Upgrading Unica Interact

You can upgrade Unica Interact by overwriting your existing Unica Interact installation. If you cannot upgrade your current version of Unica Interact directly, you must install Unica Interact in a new location.

About this task

To ensure that the installer automatically upgrades your existing Unica Interact design time and runtime environment, select the same location as your old Unica Interact design time and runtime location.

Complete the following steps to upgrade Unica Interact:

Procedure

Back up the Unica Interact runtime environment.
Undeploy the Unica Interact runtime server.
Run the Unica installer.
Review and modify the SQL upgrade script.
Set environment variables.
Run the upgrade tool for the Unica Interact design time environment.
Run the upgrade tools for the Unica Interact runtime environment
Redeploy the Unica Interact runtime server in the web application server
Check the upgrade log