Home
Upgrade Guide
Deploying Unica Audience Central
There are general guidelines for deploying Unica Audience Central.
Deploying Unica Audience Central on JBoss
You can deploy Unica products on JBoss application server. Use the following guidelines when you deploy Unica Audience Central on JBoss:

Upgrade Guide
- Installation overview
  The installation of HCL Unica products is complete when you install, deploy, and configure the HCL Unica products.
- Planning the Unica Audience Central installation
  When you plan your Unica Audience Central installation, ensure the following:
- Configuring the web application server for your JDBC driver
  The web application server where you plan to deploy Unica Audience Central must contain the correct JAR file to support JDBC connections. This enables your web application to connect to the system tables. The location of the JAR file must be included in the class path of the web application server.
- Installing Unica Audience Central
  You must run the Unica installer to start the installation of Audience Central. The Unica installer starts the product installer during the installation process. Make sure that the Unica installer and the product installer are saved at the same location.
- Deploying Unica Audience Central
  There are general guidelines for deploying Unica Audience Central.
  - Configuration of JVM parameters for Unica products
    You must configure the following JVM parameters in the Unica porducts.
  - Deploying Unica Audience Central on WebSphere
    You can deploy the Unica Audience Central application from a WAR file or an EAR file on the WebSphere�� Application Server (WAS).
  - Deploying Unica Audience Central on WebLogic
    Use the following guidelines for deploying Unica Audience Central on WebLogic.
  - Deploying Unica Audience Central on JBoss
    You can deploy Unica products on JBoss application server. Use the following guidelines when you deploy Unica Audience Central on JBoss:
  - Deploying Unica Audience Central on Tomcat
    You must follow a set of guidelines when you deploy Unica Audience Central on Apache Tomcat.
- Configuration of Unica Audience Central after Deployment
  After you deploy and start the Unica Audience Central application, log in and verify the installation. There are some basic configuration steps you must perform.
- Administration of Unica Audience Central
  After installing Unica Audience Central, the administrator must complete a few procedures to activate and use Unica Audience Central.
- Uninstalling Unica Audience Central
  To uninstall Unica Audience Central, run the uninstaller. 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.

Deploying Unica Audience Central on JBoss

You can deploy Unica products on JBoss application server. Use the following guidelines when you deploy Unica Audience Central on JBoss:

Procedure

Verify that your version of JBoss meets the requirements that are described in the Recommended Software Environments and Minimum System Requirements guide, including any necessary fix packs or upgrades.
HCL Marketing Software products customizes the JVM used by JBoss. You might need to create a JBoss instance that is dedicated to HCL Marketing Software products, if you encounter JVM-related errors.
If you are deploying in a production environment, set the JVM memory heap size parameters to at least 1024 by adding the following line to the standalone.conf file in the JBOSS_EAP_HOME/bin:
```
JAVA_OPTS="-Xms1024m -Xmx1024m -XX:MetaspaceSize=96M - XX:MaxMetaspaceSize=256m "
```
These are the suggested minimum values. Analyze your sizing requirements to determine correct values for your needs. Depending upon system load -Xmx and MaxMetaspaceSize value should be adjusted.
Note: A 64-bit application server and JVM are usually required for values greater than 2048.

Modify the JAVA_OPTIONS parameter to add the following value in setenv.bat/sh:

set "JAVA_OPTS=%JAVA_OPTS% -DUNICA_PLATFORM_CACHE_ENABLED=true 
-Dclient.encoding.override=UTF-8 -DAUDIENCE_HOME=<UNICA_HOME>\<Audience_Home>"

Navigate to the JBoss Enterprise Application Management Console, for example http://<Jboss_Host_IP>:<Port>/management.
Deploy AudienceCentral.war on JBoss.
You can also deploy AudienceCentral.war using jboss-cli.bat/sh. Run the following command:
```
jboss-cli.bat/sh
```
and connect to the JBoss instance using the following command:
```
connect <Jboss_Host_IP>:<JBOSS management Port>
deploy <UNICA_HOME>/AudienceCentral/AudienceCentral.war
```
After making the changes, restart the JBoss application server.