Information for: DEVELOPERS   PARTNERS

Installing Content Hub for Drupal 8

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

Note about Personalization support

Users of Personalization with Acquia Content Hub 2.x must use Personalization 8.x-4.1 or later to get the benefit of all features. Personalization 4 users may use Acquia Content Hub 1.x, but it does not support multilingual content.

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 8.8 or later
PHP Dependency manager Composer (installation instructions)
PHP version 7.2 or later
Other Drush 9 or later
Application Component
Drupal version Drupal 8.8 or later
PHP Dependency manager Composer (installation instructions)
PHP version 7.2 or later
Keys After you purchase Acquia Content Hub, Acquia will email you a set of keys, which are required to connect to the Acquia Content Hub content repository.
Other Acquia Content Hub assumes you are using clean URLs.

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 Acquia Cloud. 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 Acquia Cloud 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 check box next to Acquia Content Hub.

  9. Click Install to start the installation process.

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

  2. From a command prompt window, go to the directory that contains 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 commands to install the Content Hub module and its dependencies:

    composer config repositories.drupal
    composer https://packages.drupal.org/8
    composer require drupal/acquia_contenthub:~1.0
    
  4. Commit and push the changes to your codebase.

  5. Sign in to your Drupal website as an administrator, and then click Extend in the admin menu.

  6. Select the following check boxes in the Acquia Content Hub section:

    • Acquia Content Hub
    • Acquia Content Hub Subscriber
  7. Click Install to start the installation process.