Information for: DEVELOPERS   PARTNERS

Known issues in Acquia Cloud Site Factory

This page describes any known issues with Acquia Cloud Site Factory.

If you encounter any difficulties with your Acquia Cloud Site Factory subscription, contact Acquia Support for assistance.

Known compatibility issues

Upgrading to the latest version of the Acquia Cloud Site Factory Connector module can cause issues with website staging.

Staging code that includes versions 8.x-2.52 or 7.x-1.52 of the Acquia Cloud Site Factory Connector module to any non-production environment can cause errors to display unless all non-production environments are upgraded to the same version of the module.

The Acquia Cloud pipelines feature is not available for Acquia Cloud Site Factory.

Live Development is not available for Acquia Cloud Site Factory.

Acquia Cloud Site Factory does not yet support PHP 7.2.

Drush 9 requires the 2.x version of the Acquia Cloud Site Factory Connector.

To use Drush 9 with your Acquia Cloud Site Factory websites, you must use the 2.x version of the Acquia Cloud Site Factory Connector module.

Drush 8.1.16 requires Acquia Cloud Site Factory Connector version 1.44 or greater.

To use Drush 8.1.16 or greater with your websites, you must use version 1.44 or greater of the Acquia Cloud Site Factory Connector module for your version of Drupal.

PHP 7.1 requires Acquia Cloud Site Factory Connector version 1.40 or greater.

To use PHP 7.1 with your websites, you must use version 1.40 or greater of the Acquia Cloud Site Factory Connector module for your version of Drupal.

Known issues with the Site Factory Management Console

The website management console displays fields with incorrect data.

The Users and Posts fields in the table display of the Site Factory Management Console do not display correct data, and will be removed in an upcoming Acquia Cloud Site Factory release.

Adding a path-based domain completes with an error message.

Adding path-based domains to a website will succeed, but the domain name server (DNS) lookup failure will display an error.

Incorrect concurrency values are displayed for task logs.

The Task log webpage displays incorrect values for Concurrency when users attempt to view detailed task information.

The Export Site feature is visible but unavailable.

The Export site feature from the Gardens distribution is still visible in the Site actions and organization menu for certain websites.

Known issues with version control and deployments

The Acquia Cloud Site Factory Connector module must be enabled.

Multiple features of the Site Factory Management Console will fail if the Acquia Cloud Site Factory Connector module is disabled, or not included in the codebase.

The acsf-init command must be executed when updating your codebase.

Multiple features of the Site Factory Management Console will fail if the acsf-init command is not executed before pushing changes, including upgrading the Acquia Cloud Site Factory Connector module, to your Acquia version control repository. For more information, see Updating with the acsf-init command.

Update the code distribution provided in your repository before beginning development.

The code distribution provided when a new Acquia Cloud Site Factory account is provisioned should be replaced with the distribution of your choice before development begins.

Unicode characters and emoji are not supported in branch names.

If a branch name contains a Unicode character, such as an emoji, Acquia Cloud Site Factory will display a Failure due to fatal system error message when users attempt to switch to that branch. This error affects all Acquia Cloud-related products.

Path-based domains display incorrectly during code deployments.

If your production deployments include database update tasks which alter production data, path-based domains may temporarily display incorrectly, until Acquia Cloud Site Factory applies the updates.

Known issues with custom code and hooks

Drush 8 and 9 cache clears can cause deployment failures.

When drush cache clear is included in a db-update hook in Acquia Cloud Site Factory, multiple website deployments fail due to race conditions.

Workarounds – Use the master branch of Drush. In the db-update hook, export the following environment variable, which forces Drush to move its cache directory into a site-specific directory:

export DRUSH_PATHS_CACHE_DIRECTORY=/tmp/.drush/${db_role}

Known issues with local development

Acquia Dev Desktop overwrites settings.php.

The acsf-init command in Acquia Cloud Site Factory removes lines in settings.php inserted by Acquia Dev Desktop.

Workaround - Remove the changes made by Acquia Dev Desktop to your settings.php file with git stash before executing the acsf-init command, unstashing the changes afterward.

Customizations to php.ini unavailable to command-line applications.

Unlike other Acquia Cloud-hosted websites, Acquia Cloud Site Factory does not allow you to bypass the inclusion of your environment’s php.ini by clearing the PHPRC environment variable.