HCL SW Blogs
Select Page

As you may already be aware, the HCLSoftware New UNICA V12 is out with several new features, amongst them a major feature: The supports for JBoss. This is helping the Unica Marketing Software in maximum uptime. After a long period, HCLSoftware Unica Suite came up with the support of open-source application servers, and this will save a lot of cost of an enterprise.

What is JBOSS?

The JBoss Enterprise Application Platform (or JBoss EAP) is a subscription-based/open-source Java EE-based application server runtime platform used for building, deploying, and hosting highly-transactional Java applications and services. The JBoss Enterprise Application Platform is part of the JBoss Enterprise Middleware portfolio of software. As it is Java-based, the application server operates across platforms; it is usable on any operating system that supports Java. The JBoss Enterprise Application Platform was developed by JBoss, now a division of Red Hat.

Why JBOSS?

JBoss is Red Hat’s Application server, also known as Wildly. It is an open-source alternative to commercial offerings from IBM WebSphere and Oracle WebLogic. The application server is an open-source platform, used for implementing Java applications and a wide variety of other software applications. The Application Server is cross-platform, easy to install, and use on any operating system that supports Java. You can run the JBoss application server on Linux, Unix, OS X, and Windows.

UNICA with JBOSS

Benefits of JBOSS with UNICA

  • It’s an Open Source. Open-source is generally counted as a win. JBOSS is free and readily available to anyone willing to download it.
  • It’s a lightweight application. JBOSS is a lightweight application that offers the most basic functionality necessary to run a server, meaning it provides relatively quick load and redeploys times compared to others.
  • It’s More Flexible. There are very few steps to follow for the deployment of applications as well as the configuration after deployment as compared to others.
  • Compatibility. JBOSS is compatible with all Operating systems and databases.

Where we can get the JBOSS installer?

The installer is easily available on the internet and you can download it for free. To download you just need to create a new account which is free. You can download it from the link below.

https://developers.redhat.com/products/eap/download

Pre-Requisite

Before installing the Application Server you must have JAVA installed. Since JBoss is pure Java you can have it working on any Operating System / Platform that supports Java. For Version 12 you should have JDK 1.8 installed on the system and supported operating system.

We can now start with the installation of JBoss.

Steps to install JBoss

1. Run the jar file(jboss-eap-7.1.0-installer) on the window’s machine. It will start the installation. Run the command java -jar jboss-eap-7.1.0-installer.jar on Linux machine.
Make Sure you have JAVA installed on your machine and PATH is set in Environment Variables.

2. Click OK.

3. Give the installation Path.

4. Select the component.

UNICA with JBOSS

5. Create Admin User and click next.

UNICA with JBOSS

6. It will show the components installation as successful.

UNICA with JBOSS

7. It will then ask for Runtime Configuration.  Select the configurations as below.

UNICA with JBOSS

NOTE: You can also select Perform default configuration and add the data source afterward.

8. We have to then set up a JDBC driver. Select Driver Vendor as Oracle. Then provide the jar file path, if you have any additional jar just click on Add Additional jar.

UNICA with JBOSS

NOTE: We can add the jar files after installation also if we have selected the Perform default configuration in the above steps.

9. Now we have to set up the platform data source as we have checked install data source in step 7. Set the configurations as mentioned below. JNDI should start with java:/[JNDI NAME]. Change the Security type as Username and Password.

UNICA with JBOSS

After the successful data source connection, just click ok TEST DATASOURCE CONNECTION.

UNICA with JBOSS

10. You will get the below screen once the processing is finished.

UNICA with JBOSS

11. You just need to click on Done.

UNICA with JBOSS

How to test JBOSS installation is successful or not?

Navigate to JBOSS_HOME/bin folder and run standalone.bat to start the JBOSS console and check as below.

WFLYSRV0060: Http management interface listening on https://127.0.0.1:9990/management
WFLYSRV0051: Admin console listening on https://127.0.0.1:9990
WFLYSRV0026: JBoss EAP 7.1.0.GA (WildFly Core 3.0.10.Final-redhat-1) started in 98623ms – Started 2868 of 3104 services (364 services are lazy, passive or on-demand) Also, Admin console listening on https://127.0.0.1:9990.

Just open https://127.0.0.1:9990 or https://localhost:8080

Provide the User Name and Password which we have created while installation.

UNICA with JBOSS

This is how the JBoss Admin Console looks like.

UNICA with JBOSS

Configuration of JBOSS

1. Navigate to Configuration->Subsystem->Data source->Non-XA. You will get the Platform data source already present as we have created while installation.

UNICA with JBOSS

If you want to change the configurations of Data source you can click on Platform Data source.

UNICA with JBOSS

2. Now to add the Campaign Data source,

a. Navigate to Configurations->Sub system->data sources->Non-XA->Add
b. Select Oracle.

UNICA with JBOSS

c. Give the JNDI name for Campaign
    NOTE: JNDI=java:/[JNDI]

UNICA with JBOSS

d. To select a JDBC Driver, Click on detected and Select ojdbc8.jar
NOTE-Detected Driver will only display if you have jar file under Deployment.

UNICA with JBOSS

e. Now give the user name and password. Make sure your JDBC URL is correct

UNICA with JBOSS

f. Test the connection now. It should be successful.

UNICA with JBOSS

3. Steps to configure JVM.

How to set the heap size and JVM arguments?

In Windows

set "JAVA_OPTS=-Xms1G -Xmx1G -XX:MetaspaceSize=4096M -XX:MaxMetaspaceSize=8192M -Dcampign.ehcache.path=D:\JBOSSUnica\Campaign\conf\ 
-DCAMPAIGN_HOME=D:\JBOSSUnica\Campaign
-DOFFER_HOME=D:\HCL\JBOSSUnica\CentralizedOffers 
-Doffer.ehcache.path=D:\JBOSSUnica\CentralizedOffer\conf\"

In Linux

# Specify options to pass to the Java VM.

if [ "x$JAVA_OPTS" = "x" ];

then JAVA_OPTS="-Xms1303m -Xmx1303m -XX:MetaspaceSize=2048M - XX:MaxMetaspaceSize=4096m -Dcampign.ehcache.path=D:\JBOSSUnica\Campaign\conf\
-DCAMPAIGN_HOME=D:\JBOSSUnica\Campaign 
-DOFFER_HOME=D:\HCL\JBOSSUnica\CentralizedOffers
-Doffer.ehcache.path=D:\JBOSSUnica\CentralizedOffer\conf\"

Installation of EMM Suite

While installing the EMM Suite make sure to do the following changes.

UNICA with JBOSS

UNICA with JBOSS

How to Deploy War files in JBOSS?

1. Open the console

2. Navigate to Deployment->Add

3. Select Upload a new deployment option and click on Next.

UNICA with JBOSS

4. Choose file and click next.

UNICA with JBOSS

5. Click Finish and it will start the deployment

UNICA with JBOSS

After deployment, if you check under Deployment you can get the unica.war file.

Follow the same steps for all war files.

UNICA with JBOSS

To check the UNICA Application is up or not. Make sure your JBOSS is up and running. Below is the Application URL.

https://localhost:8080/unica

UNICA with JBOSS

And, you have successfully deployed the war files using JBoss.

You can always reach out to our support community, for any Unica related questions, at any time Contact Us

Comment wrap
Further Reading
Unica 12.1.1 Summer Release
Marketing & Commerce | July 30, 2021
Releasing the new feature pack – Unica 12.1.1 Summer Release
HCL Unica is the marketing automation platform that helps customers achieve personalization at scale. Unica 12.1.1., also available as a cloud native-as-a-service.
Traditional MRM vs Collaborative Work Management
Marketing & Commerce | May 5, 2021
Traditional MRM vs Collaborative Work Management
MRM exists to save time and marketing resources. The list of activities includes the coordination between your marketers, graphic designers, copywriters, and others involved.
Close
Filters result by
Sort:
|