Home
Installation Guides
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 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.
Platform utilities
This section describes the Unica Platform utilities, with functional details, syntax, and examples.
quartzjobtool
Scheduler jobs created in version 11.1 or older versions require to be updated to run on version 12.0. Use the quartzjobtool utility to update the scheduler jobs when the installer has not done this automatically during installation or upgrade. This tool reads environment variables from the setenv_quartz script. The Unica Platform installer should have set this variable automatically, but it is a good practice to verify that the JAVA_HOME variable is set if you have a problem running a utility. The JDK must be the Sun version (not, for example, the JRockit JDK available with WebLogic).

Installation Guides
- 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 Platform installation
    When you plan your Unica Platform installation, you must ensure that you have set up your system correctly, and that you have configured your environment to deal with any failures.
  - Creating the Unica Platform data sources
    You must create Unica Platform data sources before you can install Unica Platform.
  - Installing Platform
    You must run the Unica installer to start the installation of Unica Platform. The Unica installer starts the Unica Platform installer during the installation process. Make sure that the Unica installer and the product installer are saved at the same location.
  - Deploying Platform
    You must follow a set of guidelines when you deploy Unica Platform in your web application server. There is a different set of guidelines for deploying Unica Platform on WebLogic and on WebSphere®.
  - Deploying Unica Contact Central
  - Configuring Platform after deployment
    For a basic installation of Unica Platform, you must configure Unica Platform after deployment if you use the Unica reporting feature, or if you want to use a password policy.
  - Installing Unica Platform in a cluster
  - Deploying Asset Picker
  - 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.
    - To set up Platform utilities on additional machines
      On the machine where the Unica Platform is installed, you can run the Unica Platform utilities without any additional configuration. However, you might want to run the utilities from another machine on the network. This procedure describes the steps required to do this.
    - Platform utilities
      This section describes the Unica Platform utilities, with functional details, syntax, and examples.
      - The alertConfigTool utility
        Notification types are specific to the various Unica products. Use the alertConfigTool utility to register the notification types when the installer has not done this automatically during installation or upgrade.
      - The configTool utility
        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.
      - Clientdetails
      - The datafilteringScriptTool utility
        The datafilteringScriptTool utility reads an XML file to populate the data filtering tables in the Unica Platform system table database.
      - The encryptPasswords utility
        The encryptPasswords utility is used to encrypt and store either of two passwords that Unica Platform uses internally.
      - The encryptTomcatDBPasswords utility
        The encryptTomcatDBPasswords utility is used to encrypt the database passwords that the Tomcat Application server uses internally. It is used to encrypt database passwords used in Campaign.xml and unica.xml. This utility can encrypt the Unica application database password. The utility prints the encrypted password in the command line.
      - The partitionTool utility
        Partitions are associated with Unica Campaign policies and roles. These policies and roles and their partition associations are stored in the Unica Platform system tables. The partitionTool utility seeds the Unica Platform system tables with basic policy and role information for partitions.
      - The populateDb utility
        The populateDb utility inserts default (seed) data in the Unica Platform system tables.
      - The restoreAccess utility
        The restoreAccess utility allows you to restore access to Unica Platform if all users with PlatformAdminRole privileges have been inadvertently locked out or if all ability to log in to the Unica Platform has been lost.
      - The scheduler_console_client utility
        Jobs configured in the Unica Scheduler can be listed and kicked off by this utility if they are set up to listen for a trigger.
      - quartzjobtool
        Scheduler jobs created in version 11.1 or older versions require to be updated to run on version 12.0. Use the quartzjobtool utility to update the scheduler jobs when the installer has not done this automatically during installation or upgrade. This tool reads environment variables from the setenv_quartz script. The Unica Platform installer should have set this variable automatically, but it is a good practice to verify that the JAVA_HOME variable is set if you have a problem running a utility. The JDK must be the Sun version (not, for example, the JRockit JDK available with WebLogic).
  - About Platform SQL scripts
    This section describes the SQL scripts provided with Unica Platform to perform various tasks relating to the Unica Platform system tables.
  - Uninstalling Unica Platform
    Run the Unica Platform uninstaller to uninstall Unica Platform. 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.

quartzjobtool

Scheduler jobs created in version 11.1 or older versions require to be updated to run on version 12.0. Use the quartzjobtool utility to update the scheduler jobs when the installer has not done this automatically during installation or upgrade. This tool reads environment variables from the setenv_quartz script. The Unica Platform installer should have set this variable automatically, but it is a good practice to verify that the JAVA_HOME variable is set if you have a problem running a utility. The JDK must be the Sun version (not, for example, the JRockit JDK available with WebLogic).

Syntax

quartzjobtool

Use the quartzjobtool to update scheduler jobs. This is a required step. If this upgrade tool is not run, any existing scheduled job will fail 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

Example

Update scheduler jobs quartzjobtool

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.