Install

Last updated on
11 April 2021

1. Setup a files directory

  • You need to create a "files" directory for Drupal:
    e.g. mkdir -p /var/www/html/web/sites/default/files
    Note: Usually the permission should be chmod 757 or chmod 777. Try chmod 777 if  chmod 757 or chmod 775 doesn't work.

2. Setup a private directory

  • You need to create a "private" directory to store AWS access credentials and Google Apps client secrets:
    e.g. mkdir -p /var/www/html/web/sites/default/files/private
    Note: Usually the permission should be chmod 757 or chmod 775.
  • The sites/default/files/private directory will be represented as private:// in Drupal.
    Note: Drupal represents a private directory as private://.
  • The AWS access credentials are stored into the location at private://aws_cloud/.aws/.
  • The Google Apps client_secrets.json file is stored into the location at private://aws_cloud/.gapp/.

3. Run command

  • Cloud Orchestrator (Drupal Distribution) (Recommended):
    composer create-project docomoinnovations/cloud_orchestrator --stability=dev cloud_orchestrator

  • Or, Cloud module:
    composer require drupal/cloud

4. Setup Cron Job

  • Setup your cron job by calling https://example.com/cron/<CRON_SIGNATURE> to refresh AWS data in your system.  You can find that URL at Home | Administration | Configuration | System | Cron (https://example.com/admin/config/system/cron) in your Drupal site.  We recommend the 5 min interval. The example cron setting is like this:

    */5 * * * *   root wget -q --no-check-certificate --output-document=/dev/null https://example.com/cron/<CRON_SIGNATURE>

4. Download and Install Bootstrap Cloud (Optional)

  • Cloud module is tested with a sub-theme of Bootstrap.  If you want to install Bootstrap Cloud theme independently to install, run:
    1. composer require drupal/bootstrap_cloud
    2. Enable bootstrap_cloud from Home | AdministrationAppearance on your web site

Help improve this page

Page status: No known problems

You can: