Information for: DEVELOPERS   PARTNERS

Importing your files

Importing manually

This page describes manually importing the files of an existing Drupal application into Acquia Cloud, as part of the process of manually importing the entire application. For information about other methods of importing an application, see Importing an existing application.

Acquia Cloud stores user-uploaded files of a Drupal application (the /files directory) on a network filesystem shared across web nodes. The network filesystem for your application is accessible as /mnt/gfs/[SITE].[ENV] (also accessible as /mnt/files/[SITE].[ENV]), where [SITE] is the name of your application on Acquia Cloud and [env] is the Acquia Cloud environment (such as prod, test, or dev). These files directories are subdirectories of the network filesystem, such as /mnt/files/[site].[env]/sites/[subsite]/files. For more information about the file system, see Working with files.

In your deployed Drupal docroot, which is on the local disk for performance, Acquia Cloud creates a symbolic link from the files directory to the actual files directory in the network filesystem. This symlink allows Drupal to access the files in the location it expects.

For example, [docroot]/sites/default/files is set up to be a symbolic link to /mnt/files/[site].[env]/sites/default/files. Acquia Cloud creates this symbolic link in any subdirectory of docroot/sites containing a file named settings.php. If you have a multisite configured with the file docroot/sites/example.com/settings.php, Acquia Cloud creates docroot/sites/example.com/files as a symbolic link to /mnt/files/[site].[env]/sites/example.com/files.

To import your user-uploaded files to your Acquia Cloud application, complete the following steps:

  1. Enable SSH access to your server.
  2. Upload your files to the user-uploaded files directory using the sftp, scp, or rsync command. This directory is /mnt/files/[SITE].[ENV]/sites/default/files or, for multisite installations, /mnt/files/[SITE].[ENV]/sites/[sitedir]/files. For more information, see Understanding files. For examples of using rsync, see rsyncing files on Acquia Cloud.