Single Listener Environments

To understand how Campaign Listener clustering and its use in failover work, you should first understand how the Campaign listener works in general. The following diagram depicts the basic setup of a single listener environment.

In a single Campaign listener setup, the listener receives requests from the Campaign J2EE deployment in the web application server for specific Campaign feature actions made in the Unica UI. For example, after a user logs into the Unica UI and clicks on a Campaign-related feature (such as the Campaign > Campaigns menu item), a request is sent to the Campaign listener. It will fork off a separate independent process called “unica_acsvr” that runs on the Campaign analytic server (the machine where the listener process is running). This unica_acsvr process becomes the user’s Campaign Login session. Each user has their own unica_acsvr process for their login session.

If the user then clicks on a Flowchart tab within a Campaign, the listener receives another request from the Campaign J2EE deployment to fork another separate unica_acsvr process that is exclusive to that flowchart. This unica_acsvr process loads into its memory the flowchart.ses file contents and any cell run results from prior executions of that flowchart if any (so green checkmarks and output cell counts can be displayed on each process box). Each flowchart accessed by users has its own unica_acsvr process started.

Even when automated flowchart tasks (such as those started by the Unica scheduler or the Campaign utility unica_svradm) are started to execute flowchart logic, a single unica_acsvr process for that flowchart is spawned by the listener.

Anytime a unica_acsvr process is spawned by the listener, the listener also adds a reference for that unica_acsvr into the Campaign_home/conf/unica_aclsnr.udb file. This file is the means of the listener understanding which unica_acsvr processes are running and which unica_acsvr processes to manage and communicate with. Unica_acsvr processes for flowcharts starts and remains “up” whenever a user is viewing or editing a flowchart or even when a flowchart is executing its logic.

If a user exits Edit mode or navigates from viewing a flowchart in the UI or when a flowchart run has completed its execution- a signal is sent to the listener to pass onto the respective unica_acsvr to have it shut down. Each time a unica_acsvr process starts, an entry is added to this unica_aclsnr.udb file by the Campaign listener, and each time a unica_acsvr process ends, an entry is removed from the unica_aclsnr.udb file by the Campaign listener, making this a dynamically changing file.

Overall the unica_acsvr processes require the listener to be available at all times to send/receive information to/from the J2EE side of Campaign. It enables the Unica UI to reflect the view, edit, or run results of the unica_acsvr process related to that flowchart. If the listener is down or unresponsive, the flowchart and user login sessions would also become unresponsive. It happens as the listener (or “middle man”) is no longer available to communicate to/from the Campaign J2EE deployment and, ultimately, the user workstations. The UI would become frozen, and the unica_acsvr processes would stop functioning properly. The only way to fix this is to have users close their browser, to disconnect from their Campaign login sessions, and the listener problem would need to be fixed. Users can then open a new browser, login again, and resume operations.

Therefore, in a single listener environment, should the listener become unavailable or unresponsive, it means downtime for the system until the listener is operational again. Learn more about Campaign Listeners in the second part of the blog- Understanding Campaign Listener Clustering and Listener Failover – Part 2 

To read more about the Clustered Listener setups, subscribe to the Unica blog and Stay Updated.

Comment wrap
Further Reading
Marketing & Commerce | December 9, 2020
Unica 12.1 – Licensing – Quick Start for Customers
Unica V12.1 has been released to power the next generation goal-based marketing, and Unica v12.1 is the first release to enable an HCL Licensing portal called FlexNet. Once the user deploys the HCL Unica products, they will need to configure required licenses with HCL Unica products to start using them. Without applying for a valid license, the user would not be able to login into Unica environments. Licensing in Unica is to validate products' entitlement and measure the product consumptions based on various units. HCL Unica products support the below license models. Term based licenses Perpetual licenses If you are upgrading from earlier versions of Unica products to version 12.1, you can have the option to take a Perpetual type license for the existing products you are entitled to use. And for new product licenses, you can take the option of Term based licenses. This is flexible as per your entitlement plan. In the upgrade scenario, you could have Term and Perpetual licenses in your entitlements. While you upgrade to 12.1, you should have default entitlements with Perpetual type licenses in your FlexNet account. HCL supports the below type of counting mechanism for products in the HCL Unica suite. Configuring Unica 12.1 – Licenses Once you perform a clean install or upgrade install and tries to login to the Unica application, you would be prompted to enter the license details. Below are the high-level steps to configure the licenses for Unica 12.1. Pre-requisites: Before you start with license configuration you will need to fulfill the below perquisites: Make sure you have FlexNet (HCL Licensing Portal) login details. Login to FlexNet portal. Check if you can see entitlements for the products they are entitled to. Please raise a support ticket if you do see the products in entitlements. You will need...
Marketing & Commerce | November 17, 2020
Unica Named a November 2020 Gartner Peer Insights Customers’ Choice for Multichannel Marketing Hub.
HCL Software is excited to announce that Unica, a leading enterprise marketing solution, has been recognized as a November 2020 Gartner Peer Insights Customers’ Choice for Multichannel Marketing Hub (MMH). Our team at Unica takes great pride in this distinction, as customer feedback continues to shape our products and services. In its announcement, Gartner explains, “The Gartner Peer Insights Customers’ Choice is a recognition of vendors in this market by verified end-user professionals, taking into account both the number of reviews and the overall user ratings.” To ensure fair evaluation, Gartner maintains rigorous criteria for recognizing vendors with a high customer satisfaction rate. Here are some excerpts from customers that contributed to the distinction: “A solid product with deep user community and good integrator expertise in region.”- Head Of Marketing Data & Analytics in the Finance Industry “HCL Unica is a great Campaign Management tool which generate good revenue for organisation.”- Senior Manager in the Services Industry "HCL Unica is a great ROI Marketing Automation tool.”- Associate Director in the Manufacturing Industry Read more reviews for Unica here. Everyone at Unica is deeply proud to be honored as a November 2020 Customers’ Choice for Multichannel Marketing Hub. To learn more about this distinction, or to read the reviews written about our products by the IT professionals who use them, please visit the Customers’ Choice announcement. To all of our customers who submitted reviews, thank you! These reviews mold our products and our customer journey, and we look forward to building on the experience that earned us this distinction! If you have a Unica story to share, we encourage you to join the Gartner Peer Insights crowd and weigh in. The GARTNER PEER INSIGHTS CUSTOMERS’ CHOICE badge is a trademark and service mark of Gartner, Inc., and/or its affiliates, and is used...
Marketing & Commerce | November 12, 2020
Manage TVC-Grid Validation in Unica Plan – A Systematic Way
Marketers are always looking for tools and processes to manage their marketing operations, streamline workflows, optimize the budget spend, resources, and manage other marketing assets. MRM is a single solution that can take care of all your needs, from strategic planning to executing a certain marketing activity and ensuring that consistency binds the team together. Unica Plan is the solution that Unica Suite offers to manage all your marketing needs and activities. HCL Unica Plan (Formerly known as Marketing Operations) supports the feature called Tabular View Control (TVC) Grid, where the marketer can choose and arrange the different attributes like Text, Numeric, Date, etc. which they want to use for tracking their business activities. Grids are mainly used for collecting data, in the user interface, it appears like a table or a list. You can enter data into the cells of the grid according to the selected attributes and their data type. Apart from this, the product supports the customization of grid attribute(s) with validation; for example, the attribute should start with a specific character/word OR attribute should not allow entering beyond a certain limit OR attribute should only allow data between a certain range, etc. “com.unicacorp.uap.grid.validation.plugin.GridValidatorPluginImpl” validator is delivered with HCL Unica Plan which can help you to define the validations on-grid attribute(s). This validation plug-in supports two types of rules. ROW: row-level rules are executed first. GRID: grid-level rules are executed after row-level rules. HCL Unica Plan ships with the following sample rules. BeginsWithRule DateCheckRule RangeCheckRule UniqueCheckRule This article will help you to understand the grid validation, data validation rules, and how to implement the ROW level validation using the "BeginsWithRule" rule with the Text Single Line Type attribute. Let’s follow the step by step approach to learning the validation. Create the new grid frame using the Form...
a/icon/common/search Created with Sketch.