Evaluating Acquia Content Hub 8.x-1.x deployment before upgrading to Acquia Content Hub 8.x-2.x
Overview
Content Hub Upgrade Console (CHUC) is a console-based tool, which helps Acquia
Content Hub 8.x-1.x customers to upgrade to the latest version 8.x-2.x.
Apart from upgrading, it also provides auditing, troubleshooting and fleet-wide
commands to Acquia Content Hub customers.
Before you proceed to upgrade your Acquia Content Hub 8.x-1.x deployment to
Acquia Content Hub 8.x-2.x, we recommend that you evaluate your requirements
based on the following steps.
Determine the use cases
We strongly recommend using CHUC to upgrade your Acquia Content Hub modules to
version 8.x-2.x if you employ syndication as a use case. For purely Acquia
Personalization use cases, Acquia Content Hub 8.x-1.x continues to be
compatible with Acquia Personalization. In order to determine your use case,
check if you have subscribers enabled on any Acquia Content Hub installation
and use syndication to re-use published content from a
publisher site in your site fleet.
Determine level of activity
Are you an active customer or have you installed Acquia Content Hub but never
went live in production?
Understand differences between Acquia Content Hub 8.x-1.x and Acquia Content Hub 8.x-2.x
See Content Hub for differences between the two versions.
Review and evaluate the considerations
Since Acquia Content Hub 8.x-2.x is a complete rewrite of the product and is
re-architected to optimize and enhance its syndication capabilities, there are
several considerations you need to make and plan for prior to upgrade. These
include:
- Review content architecture that is, types of entities, complexity and level
of dependencies.
- Review your needs for configuration and user entity syndication. With Acquia
Content Hub 8.x-2.x, all data from publishers is syndicated to subscribing
sites.
- Review your needs for exporting and importing entities. With Acquia Content
Hub 8.x-2.x, you need to set up Drupal queues for syndication.
- Review your use of filters. With Acquia Content Hub 8.x-2.x, Publisher
syndicates all content and subscribers can select via filters the content to
ingest.
- Review your custom modules, third-party integration and deployment workflows
if they depend on a Acquia Content Hub 8.x-1.x feature that has changed in
Acquia Content Hub 8.x-2.x.
- Review your development and deployment workflows and ensure that they are set
up for success.
- Ensure that you have a dedicated Acquia Content Hub account per environment.
Use the following questionnaire to evaluate your readiness for the upgrade
- Do you have this Acquia Content Hub account unique for every environment?
- How will you approach configuration management?
- Are you registering this Acquia Content Hub client to a site with a fresh
database or was the database copied from another site?
- Does this site have a valid SSL certificate?
- If this is a subscribing site, does it match the multilingual setup of the
publisher?
- Have you applied all database updates for your sites?
- Do you have any null config UUIDs?
- Are you using paragraphs and is any paragraph data orphaned in the database?
- Are you using private filestream wrappers?
- Are you using Views?
- Are you using Layout Builder?
- How many publishing sites are you planning on implementing?
- Do you plan on syndicating users to sites with existing users?
- How will you handle running the export and import queues?
- What is your strategy for site stage down?
- Do you plan to update and persist content on subscribers?
- Do you have a need for selective exporting of content?
