Guidelines for deploying Unica Journey on JBoss

Make sure that the version of JBoss meets the requirements that are described in the HCL Enterprise Products Recommended Software Environments and Minimum System Requirements document. Use the following guidelines when you deploy Unica Journey on JBoss:

Use the following guidelines when you deploy the Unica Journey products on any supported version of JBoss:

1. Deploy unica.war file as an enterprise application.

   For example: deploy <Journey_Install>\unica.war

   See https://docs.jboss.org/jbossweb/3.0.x/deployer-howto.html for instructions on Deploying Web Server Application in JBoss.

2. Complete the following tasks if your installation must support non-ASCII characters, for example for Portuguese or for locales that require multi-byte characters:
   1. Edit the standalone.conf script in the bin directory under your JBOSS /bin directory to add

      -Dfile.encoding=UTF-8

      -Dclient.encoding.override=UTF-8

      -Djourney.web.home=C:/WAS_FEDFP4/Journeys/Web/

      -Djboss.as.management.blocking.timeout=3600

      to JAVA_VENDOR.

      In case of a production setup, this Java option must be removed or set to false.

   2. Restart JBoss server.
3. To ensure that the Scheduler works correctly, complete the following substeps.
   • Take a backup of <JBOSS_HOME>/standalone/configuration/standalone.xml file.
   • In <JBOSS_HOME>/standalone/configuration/standalone.xml, search the module name for driver.

     <driver name="oracledriver" module="oracle.jdbc">
     <xa-datasource-class>oracle.jdbc.OracleDriver</xa-datasource-class>
     </driver>

   • Installer will not update the datasources, so you need to manually configure the datasources.
   • Add the following statement underneath <subsystem xmlns="urn:jboss:domain:ee:4.0"> to make the module name global.

     <global-modules>
     <module name="oracle.jdbc"/>
     </global-modules>

   • Restart JBOSS server.
   Cleaning the JBOSS application server cache

   1. Go to JBOSS install location location used for Journey installation. For example, /jboss-eap-7.1/standalone
   2. There you will see two folders tmp and deployments.
   3. Delete the contents of these two folders
   Note: Journey Web component reads configurations from application.properties file. Users are required to update the Journey Web application properties file and Journey Engine Application properties file before the deployment of journey.war. Please refer Configuring Unica Journey