Written by The Jahia Team
 
Developers
Sysadmins
   Estimated reading time:

Please:

  • Read all of the instructions on this page carefully before proceeding with the upgrade process.
  • Run a pre-production test first.
Note: Marketing Factory Version 1.10.0 will be removed from downloads, to facilitate future updates of Marketing Factory and Unomi. 
This procedure is working to update to MF1.10.1 and Apache Unomi 1.3.3 from:
  • Marketing Factory 1.10.0 (working with Unomi 1.3.2) 
  • Marketing Factory 1.9.2  (working with Unomi 1.3.1)
  • Marketing Factory 1.9.0  (working with Apache Unomi 1.3.0) 

1. Stop the existing module of Marketing Marketing Factory core (1.9.0, 1.9.2 or 1.10)
2. Stop the existing instance of Apache Unomi (1.3.0, 1.3.1 or 1.3.2)
3. Download and install Apache Unomi Jahia 1.3.3

NEW:
4. Starting in Unomi 1.3.3 jahia,  Unomi can be configured using only one configuration file unomi.custom.system.properties .  Create this file in the <unomi-install-dir/etc folder . Add in this file all the properties that you previously changed  in the cfg files.

5. Start Apache Unomi 1.3.3 using ./start command in the operating system shell
6. Connect to the Apache Unomi Karaf SSH Shell using an SSH client such as in the following example (default password karaf):
ssh -p 8102 karaf@localhost
8. Start Unomi (only needed when running unomi 1.3.3 for the first time)
unomi:start
9. Update DX module "Marketing Factory core" to version 1.10.1, ensure that the module is started

NEW:

10. Once the Marketing Factory module is started, it will create the following configuration file in your DX installation folders: /digital-factory-data/karaf/etc/org.jahia.modules.marketingfactory.settings-sample.cfg
Rename the file name to org.jahia.modules.marketingfactory.settings-global.cfg (replace "-sample" by "-global")
Configure this file as described in the section 3.2. of the installation, configuration fine tuning guide. (please make sure that you read this section carefuly).

Here is an example for a local installation (not secure for production):

# Mandatory connection properties are:
mf.unomiURL=https://localhost:9443/
mf.unomiPassword=karaf
mf.unomiUsername=karaf

# Optional properties and there default value:
# Trust all certificate
mf.unomiTrustAllCertificates=true

# Use public addresses for admin
mf.unomiUsePublicAddressesForAdmin=false

# Unomi KEY
mf.unomiKey=670c26d1cc413346c3b2fd9ce65dab41

The configuration will be reloaded without restarting the DX server., but ensure that you do it for each DX cluster node.