04-jexperience

jExperience tutorial

Building on top of the previous tutorial, we're going to:

• Install jCustomer (Apache Unomi)
• Configure jCustomer with Jahia and Elasticsearch

Instructions

To get started, execute the following commands:

cd ~
git clone https://github.com/Jahia/provisioning-tutorials.git
cd provisioning-tutorials/04-jexperience

This tutorial is a bit more cumbersome when compared to the previous ones as it requires you to obtain a GeoLite license key from maxmind. This is used by Unomi to associate IP addresses with their geolocation.

Once done, update the variable JCUSTOMER_MAXMIND_GEOIP2_CITY_DATABASE_URL , by replacing CHANGEME with the license key, in the .env file fetched earlier.

You can find a list of all available environment variables on this Academy page.

JCUSTOMER_MAXMIND_GEOIP2_CITY_DATABASE_URL=https://download.maxmind.com/app/geoip_download?edition_id=GeoLite2-City&license_key=CHANGEME&suffix=tar.gz
JAHIA_IMAGE=jahia/jahia-ee:8.1
UNOMI_IMAGE=jahia/jcustomer:1.6.0
ELASTICSEARCH_IMAGE=docker.elastic.co/elasticsearch/elasticsearch:7.17.14
MARIADB_IMAGE=library/mariadb:10-focal

You might have noticed that we're introducing another layer of flexibility with the .env file. You can use it to easily modify the docker images (and their versions) used for the environment.

We can now start the environment:

docker-compose up --renew-anon-volumes

After startup

At the end of startup (give it a minute or two), open a browser to Digitall's home page at http://localhost:8080.

You can also validate that the connection between jExperience and Unomi is operating operational.

What did we learn ?

We added one level of complexity by adding another container (Unomi) requiring a specific configuration to be stored in Jahia.

This provisioning script uses one new commands when compared to the previous tutorial:

• editConfiguration Create (or update) a configuration file in jahia karaf/etc.

That's it !

These tutorials should have provided you with a starting point for better understanding how to use Jahia's provisioning API.

Back to index