Upgrading to MF 1.8.1

March 6, 2023

To upgrade from Marketing Factory 1.8.0 to Marketing Factory 1.8.1:


  • Read all of the instructions on this page carefully before proceeding with the upgrade process.
  • Run a pre-production test first.

This procedure is working to update any version of Marketing Factory 1.8.0 or 1.8.1 :  
1. Stop module Marketing Marketing Factory core 1.8.0
2. Stop Apache Unomi 1.2.1
3. Download and install Apache Unomi 1.2.2
4. Apply any custom changes that you made in the configuration of Apache Unomi 1.2.1 (files in the <unomi-install-dir>/etc folder) to Apache Unomi 1.2.2
5. Start Apache Unomi 1.2.2 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
7. Migrate your ElasticSearch database using Apache Unomi command tools:
unomi:migrate 1.2.1
8. Start Unomi (only needed when running unomi 1.2.2 for the first time)
9. Update Marketing Factory core to 1.8.1 and ensure the module is started