Home
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.

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 WebSphere® Application Server, or on WebLogic. 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
      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. The Interact design time environment is deployed automatically with the Campaign EAR or WAR file.
    - 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.

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

An in-place upgrade is one where you overwrite your existing installation. You can complete in-place upgrades for Unica Interact version 12.1.4.

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.

When in-place upgrades are not possible, you must install Unica Interact in a new location. Because of the architectural changes between Unica Interact version 8.5.0 and previous versions of Unica Interact, there is no upgrade path from earlier versions of Unica Interact.

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

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.