Written by The Jahia Team
 
Developers
Sysadmins
   Estimated reading time:

General information

  • It is possible to update from Marketing Factory 1.10.3 or 1.10.4 to jExperience 1.11
  • jExperience 1.11 is compatible with jCustomer 1.4.1 and DX 7.2.3.2+
  • Please read first these instructions entirely before you take any action.
  • Please run this migration in a sandbox environment first, then move to pre-production and production.
  • Ensure that a backup exists for both jCustomer/Apache Unomi data and Jahia data 
  • Check the Jahia logs at every steps
  • If Jahia is running as a cluster, these operations have to be done only on processing server.

Step by step instructions:

  1. Ensure that Marketing Factory core is running on your server
  2. Download, install and start the module "jExperience migrator" from Jahia store
    • Ensure this module is started and running on all Jahia nodes of the cluster
  3. Install the module jExperience, but make sure to uncheck "start automatically" JExperience, DO NOT START the module yet. Also install (but not start) the module jexperience-components or any other marketing factory module that you use
    • Ensure they are installed on all Jahia nodes of the cluster
  4. Stop and uninstall Marketing factory modules
    • Ensure they are uninstalled on all Jahia nodes of the cluster
  5. Start new jExperience and other jexperience modules that you might use (jexperience-components or others) 
    • Make sure they are started on all Jahia nodes of the cluster
  6. The migration of jExperience is now complete. You should now procede with upgrading your Unomi installation to jCustomer 1.4.1.

Upgrading Jahia Unomi 1.3.3 to jCustomer 1.4.1.

Important note: jCustomer is based on Apache Unomi, but is also the product that is fully supported and maintained by Jahia. We do not support customers that are directly using Apache Unomi distributions downloaded from the Apache website. This procedure is assuming you are upgrading from Unomi 1.3.3 which is a version provided by Jahia on our website.

Migration steps:

  1. Stop the existing instance of Unomi 1.3.3
  2. Download and install jCustomer 1.4.1 by uncompressing it into a new directory
  3. Make sure you copy the configuration over to the new instance of jCustomer 1.4.1 from Unomi 1.3.3
  4. Start jCustomer 1.4.1 using ./start command in the operating system shell.
  5. Connect to the jCustomer Karaf SSH Shell using an SSH client such as in the following example (default password karaf):
    ssh -p 8102 karaf@localhost
  6. Start jCustomer (only needed when running jCustomer 1.4.1 for the first time).
    unomi:start

You should now test your migrated jExperience and check that everythings is OK. Also you may now stop and uninstall the "jExperience migrator" module.