Content Hub

Upgrading from Content Hub 1.x to 3.x

 

Important

Content Hub 1.x will reach end-of-life on September 30, 2024. Acquia recommends you to upgrade to Content Hub 3.x.

This page provides information about upgrading Content Hub from 1.x to 3.x.

Note

If your use case for Content Hub 1.x involves only support for Personalization and not for content syndication, Acquia recommends you to upgrade to the latest Acquia Personalization module and uninstall Content Hub. For more information, see Installing the Acquia Personalization module.

Enhancements in Content Hub 3.x

Content Hub 3.x offers a more robust and reliable architecture that facilitates content syndication across a broad range of applications using the current Drupal version.

Content Hub 3.x provides the following technical improvements:

  • A comprehensive content dependency calculation to ensure that each piece of content includes all necessary components for successful syndication from one site to another. As a result, users neither experience missing content nor misaligned configurations between sites.
  • Enforced queueing systems for export and import processes to reduce the load on the Drupal application and enhance support for bulk content operations.
  • Streamlined configuration for publisher and subscriber sites to make the process of setting up new sites simple and convenient. This configuration helps you to:
    • Connect to new sites by completing a single-page configuration form.
    • Manage existing sites through the user interface.
  • The Event Subscriber system facilitates customer-specific customizations without the need to modify the base modules of Content Hub.
  • Filters are stored in the Cloud and can be shared across multiple sites, eliminating the need to duplicate the same filter for every site.

Prerequisites 

  • Review the content architecture, including the types of entities, complexity, and level of dependencies.

    Content Hub 3.x performs a comprehensive content dependency calculation that might export and import more entities because of parent-child relationships.

  • Review the content architecture, including the types of entities, complexity, and level of dependencies. your requirements for configuration and user entity syndication.
    By default, Content Hub 3.x syndicates all data from publisher sites to subscriber sites. For information about altering this behavior, see Syndicating configuration and Syndicating users.
  • Set up scheduled jobs to process export and import queues in the background.

    For more information, see Configuring scheduled jobs.

  • Review your custom modules, third-party integrations, and deployment workflows to determine if they rely on a feature of Content Hub 1.x that has changed in Content Hub 3.x.
  • Review your development and deployment workflows to ensure that they are configured correctly.
  • Ensure that you have a dedicated Content Hub account per environment.
  • Provision new Content Hub accounts for each environment for installing Content Hub 3.x. To request new accounts, contact Acquia Support.

Upgrade process

Uninstalling Content Hub 1.x

  1. Perform a complete backup of the environment or site.

    For more information, see Taking backups.

  2. On your publisher, review and delete each of your Content Hub filters.
    You will recreate them after installing Content Hub 3.x.
  3. On each subscriber, disconnect the site from Content Hub.
  4. On your publisher, disconnect the site from Content Hub.
    Ensure that you disconnect the publisher site after disconnecting all subscriber sites to avoid losing any last minute syndication events flowing through the service.
  5. On each subscriber, disable and uninstall the Content Hub 1.x modules.
  6. On your publisher, disable and uninstall the Content Hub 1.x modules.

Installing Content Hub 3.x

Before installing Content Hub 3.x in the production environment, you must install it in lower environments such as develop and stage environments.

  1. On your publisher, install Content Hub 3.x by following the instructions in Installing Content Hub.
    Ensure that you have the credentials associated with your new Content Hub account.
  2. On your publisher, enable the acquia_contenthub_publisher module.
  3. On your publisher, enable the acquia_contenthub_dashboard module.
    This module provides the Content Hub Publisher's Dashboard interface.
  4. Using the Publisher's Dashboard, recreate your filters.
    For more information, see Publisher’s Dashboard.
  5. On each subscriber, install Content Hub 3.x by following the instructions in Installing Content Hub.
  6. Set up scheduled jobs to process export and import queues.
    For more information, see Configuring scheduled jobs.
Important

After completing the installation on a lower environment, verify that the syndication process functions correctly. To verify the syndication process, you can create and edit content, and then monitor the progress using the Publisher's Dashboard.