Migrate Storage Locations
You may want to migrate files from one local storage location to another, or from an existing storage location to an Amazon S3™ bucket or a compatible service.
- For steps to migrate data between two local storage locations, see Migrate Local Storage.
- For steps to configure and migrate to Amazon S3, see Set Up Amazon S3 Storage.
Migrating Email Attachments
The system cannot automatically migrate email attachments (as opposed to email template attachments). You upload these files when creating a custom email message, and they are transient.
- To avoid any inconsistencies when switching storage settings for email attachments, make certain that no admins are currently composing an email message with attachments.
- Email template attachments are a separate asset type that you can migrate automatically.
Manual Migration
Instead of using automated migration, you may opt to migrate your files manually and switch the relevant file type’s storage setting immediately.
- This will skip automatic migration. You assume responsibility for moving the files to the new location.
- WHMCS may store some file types in the same folder (for example, client files, email, ticket attachments, and project management files are in the
attachments
folder). If you decide to move all of the files away from that folder, you must move all relevant file types.
Manual Amazon S3 Migrations
For manual migrations, the system stores files in Amazon S3 with a prefix corresponding to the file asset type. For example, it will store file1.png
, a client file, as /client_files/file1.png
. Use the following subdirectory names:
File Type | Directory Name |
---|---|
Client Files | client_files |
Downloads | downloads |
Email Attachments | email_attachments |
Email Template Attachments | template_attachments |
Project Management Files | pm_files |
Ticket Attachments | ticket_attachments |
Common Errors
A File not found error indicates that a file is not present or is not accessible at the expected location.
Last modified: November 19, 2024