Upgrading to MF 1.9.0

November 11, 2022

To upgrade from Marketing Factory 1.8.3 to Marketing Factory 1.9.0:


  • 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 Marketing Factory 1.8.x :  
1. Stop module Marketing Marketing Factory core 1.8.x
2. Stop Apache Unomi 1.2.x
3. Download and install Apache Unomi 1.3.0
4. Apply any custom changes that you made in the configuration of Apache Unomi 1.2.x (files in the <unomi-install-dir>/etc folder) to Apache Unomi 1.3.0
5. Start Apache Unomi 1.3.0 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.0 for the first time)
9. Update DX module "Marketing Factory core" to version 1.9.0, ensure that the module is started
10. Also update the following modules to the latest version if you're using them: form factory bridge, marketing factory components 
11. For each DX website where Marketing Factory core is deployed, update the Marketing Factory "Connection to Apache Unomi" with: 

  • Apache Unomi cookie name: context-profile-id
  • Apache Unomi cookie domain: Set the same value as the "contextserver.domain" defined in the Apache Unomi configuration file etc/org.apache.unomi.web.cfg