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.
The populateDb utility
The populateDb utility inserts default (seed) data in the Unica Platform system tables.

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
  - Deploying AI-ML
    After the installation of Unica Platform is complete, if you selected the component AI-ML for installation, you must deploy the AI-ML component post installation. The deployment steps differ for Microsoft Windows and Unix-based operating systems. There are some common procedures that you must implement for both operating systems.
  - 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.

populateDb

The populateDb utility inserts default (seed) data in the Unica Platform system tables.

The Unica installer can populate the Unica Platform system tables with default data for Unica Platform and for Unica Campaign. However, if your company policy does not permit the installer to change the database, or if the installer is unable to connect with the Unica Platform system tables, you must insert default data in the Unica Platform system tables using this utility.

For Unica Campaign, this data includes security roles and permissions for the default partition. For Unica Platform, this data includes default users and groups, and security roles and permissions for the default partition.

Syntax

populateDb -n productName

Commands

-n productName

Insert default data into the Unica Platform system tables. Valid product names are Manager (for Unica Platform) and Campaign (for Unica Campaign).

Examples

Insert Unica Platform default data manually.
populateDb -n Manager
Insert Unica Campaign default data manually.
populateDb -n Campaign

Rate this topic

5 stars 4 stars 3 stars 2 stars 1 star

Comment on this topic.

By clicking this box, you acknowledge that you are NOT a U.S. Federal Government employee or agency, nor are you submitting information with respect to or on behalf of one. HCL provides software and services to U.S. Federal Government customers through its partners immixGroup, Inc. Contact this team at https://hcltechsw.com/resources/us-government-contact. Do not include any personal data in this Comment box.