Upgrading from version 10.0 and higher with automatic migration

Automatic migration allows the installer to run the SQL script and insert the configuration properties that are required to upgrade your Unica Platform system tables. If your company policy does not allow automated updates to your system table database, you must use manual migration, described elsewhere in this guide.

Before you begin

Important: If you are upgrading from a version prior to 10.1, you must first upgrade to version 10.1 and upgrade to version 11.0.1 and then upgrade to version 11.1. For information about upgrading to version 10.1, 11.0.1, and 11.1 see the IBM Marketing Platform 10.1 Upgrade Guide and the IBM Marketing Platform 11.0.1 Upgrade Guide.

The supported upgrade path via installer is 11.0.1 to 11.1.0. Users on version 11.0 can move to 11.0.1 by doing manual upgrade or fast upgrade only.

Ensure that you have the following installers in the same directory.

  • The Unica master installer
  • The Unica Platform installer

Use the following guidelines as a best practice.

  • Place the installers in the same directory where you originally placed the installers for the earlier versions of your products.
  • Remove any earlier versions of the Unica product installers from the directory to avoid having the master installer attempt to install the earlier versions.

About this task

Upgrading from version 11.1 and higher is an in-place upgrade. In an in-place upgrade, you install the upgraded version of Unica Platform to the directory where your current Unica Platform is installed.

See Unica Platform upgrade scenarios for information about upgrading from earlier versions.


  1. Create a back-up copy of your Unica Platform system table database.
    Important: Do not skip this step. If the upgrade operation fails, you cannot roll back your database and your data is corrupted.
  2. Undeploy your Unica Platform deployment.
  3. Run the Unica master installer.
    The Unica master installer starts. Use the following instructions after theUnica master installer starts.
    • When the Unica master installer prompts you to choose an installation directory, choose the root installation directory, not the Unica Platform installation directory, which is under this root directory.
    • When the Unica master installer prompts you to enter Unica Platform database connection information, enter the information that pertains to your current Unica Platform system tables.

    The Unica master installer pauses and launches the Unica Platform installer.

  4. Complete the following steps while the Unica Platform installer is running.
    1. When the Unica Platform installer prompts you for an installation directory, select the directory of your current Unica Platform installation, usually named Platform.
    2. Select Automatic database setup.
    3. If Contact Central is selected in component selection during installation, select database type.
    4. Provide Contact Central database connection details. Notes. By default only automatic database setup will be executed for Control Center.
    5. Follow the remaining steps in the installation wizard and enter the requested information.
  5. Use the quartzjobtool to update scheduler jobs. This is a required step. If this upgrade tool is not run, any existing scheduled job fails to start. The quartzjobtool is in the tools\bin directory under Unica Platform installation. Run this utility from the tools\bin directory. Example command (Windows): quartzjobtool.bat Example command (Unix): ./quartzjobtool.sh
  6. Deploy your installation.
    Note: Pay close attention to the installation summary windows. If errors are reported, check the installer log files and contact Unica technical support if necessary.