This chapter covers the configuration of main features of Apache Unomi.
Before doing other modifications, please ensure that you set your own cluster name (section 3.2).
If you want to change the default configuration, you can perform any modification you want in the <cxs-install-dir>/etc directory.
Apache Unomi configuration is kept in the <cxs-install-dir>/etc/org.apache.unomi.cluster.cfg file. It defines the addresses and ports where it can be found:
group=default
contextserver.publicAddress=https://localhost:9443
contextserver.internalAddress=http://127.0.0.1:8181
Apache Unomi requires an IP database to resolve IP addresses to user location. The GeoLite2 database can be downloaded at MaxMind from the following location:
http://dev.maxmind.com/geoip/geoip2/geolite2/
Simply download the GeoLite2-City.mmdb file and copy it into the <cxs-install-dir>/etc directory.
Apache Unomi includes a geocoding service based on the geonames database (http://www.geonames.org/). It can be used to create conditions based on countries or cities. In order to use it, you need to install the Geonames database. Get the "allCountries.zip" database from here:
http://downloads.jahia.com/downloads/jahia/marketingfactory1.0/package/allCountries.zip
Download it and put it in the <cxs-install-dir>/etc directory
, without unzipping it.
Edit <cxs-install-dir>/etc/org.apache.unomi.geonames.cfg
file (this file will be created after the first start of Apache Unomi) and set request.geonamesDatabase.forceImport to true. The data import should start right away. Otherwise, import should start at the next startup. Import runs in background, but can take about 15 minutes.
At the end, you should have about 4 million entries in the "geonames" ElasticSearch index.
Jahia Marketing Factory is fully compatible with a remote publishing architecture. Though a precise method must be applied. Here are the steps: - Start ElasticSearch - Start Apache Unomi - Start DX: both contribution / remote server in "development mode" (jahia.properties) On the contribution server:
In Marketing Factory Rules, an action is available to send email. The emails will be sent using an SMTP server that needs to be configured in the following Apache Unomi file :
mail.server.hostname=<smtp server host name>
mail.server.port=<smtp server port>
mail.server.username=<smtp server username>
mail.server.password=<smtp server password>
mail.server.sslOnConnect=<use ssl>
In the email template, you can use the following pattern to display any profile property value in the email that will be sent: $profile.properties.("propertyId")$