Information for: DEVELOPERS   PARTNERS   SUPPORT

Installing Content Hub for Drupal 9

This document explains how to install the Acquia Content Hub modules on your website.

Requirements

As you prepare to use Acquia Content Hub with your website, ensure that you plan for the following requirements:

Application

Component

Drupal version

Drupal 9 or later

PHP Dependency manager

Composer (installation instructions)

PHP version

7.2 or later

Other

Drush 9 or later

Before moving on to the installation procedure, we recommend that you take a look at the known issues.

Step 1: Obtain your Acquia Content Hub credentials

You need your Acquia Content Hub credentials to connect to the Acquia Content Hub content repository on Cloud Platform. Complete the following steps:

  1. Sign in to Personalization.

  2. In the administrative menu, click Configure > Users > Content Hub Admin User.

  3. Take a note of the following information on the page:

    • The Access Key ID (your API Key) and Secret Access Key (your Secret Key)

    • Your Acquia Content Hub hostname. The hostname varies based on the region where your website is hosted:

      Region

      Acquia Content Hub hostname

      Americas

      https://us-east-1.content-hub.acquia.com

      Europe, Middle East, and Africa

      https://eu-central-1.content-hub.acquia.com

      Asia-Pacific and Japan

      https://ap-southeast-2.content-hub.acquia.com

Step 2: Install Acquia Content Hub

Perform the following steps to install the Acquia Content Hub modules on your website:

  1. Clone the website repository locally. See Using your code repository.

  2. From a command prompt window, go to the directory containing your main composer.json file.

    Note for Cloud Platform users

    The main composer.json file is located in your website’s docroot directory.

  3. Run the following command to install the Content Hub module and its dependencies:

    composer require drupal/acquia_contenthub:^2
    

    Note

    If you receive an error Your requirements could not be resolved to an installable set of packages., ensure that zend-diactoros is using the correct version. See Drupal.org for more information.

  4. (If you don’t use Acquia’s recommended configuration, for example, your site is not hosted on Cloud Platform or you use different cache backends like Memcache) Set the cache backend for the Depcalc module to use the database. You can use Acquia’s recommended and downloadable default Memcached configuration.

    Note

    Content Hub 2.x requires the Depcalc module.

    $settings['cache']['bins']['depcalc'] = 'cache.backend.database';
    
  5. Commit and push the changes to your codebase.

  6. Sign in to your Drupal website as an administrator.

  7. In the Admin menu, click Extend.

  8. Select the checkbox next to Acquia Content Hub.

  9. Click Install to start the installation process.

Next step

Configure the Content Hub client