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

Application	Component
Drupal version	Drupal 9 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.

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

Sign in to Personalization.
In the administrative menu, click Configure > Users > Content Hub Admin User.

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`

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

Clone the website repository locally. See Using your code repository.
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.
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.
(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';
```
Commit and push the changes to your codebase.
Sign in to your Drupal website as an administrator.
In the Admin menu, click Extend.
Select the checkbox next to Acquia Content Hub.
Click Install to start the installation process.

Clone the website repository locally. See Using your code repository.
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.

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

Commit and push the changes to your codebase.
Sign in to your Drupal website as an administrator, and then click Extend in the admin menu.
Select the following checkboxes in the Acquia Content Hub section:
- Acquia Content Hub
- Acquia Content Hub Subscriber
Click Install to start the installation process.