Difference between revisions of "Moving Storage Locations"
From WHMCS Documentation
| Line 3: | Line 3: | ||
When you move WHMCS, especially to a new server, it is very likely that your current storage locations will no longer be valid. It is important to update these immediately after moving WHMCS to ensure that your file storage and retrieval continues to function normally. | When you move WHMCS, especially to a new server, it is very likely that your current storage locations will no longer be valid. It is important to update these immediately after moving WHMCS to ensure that your file storage and retrieval continues to function normally. | ||
| − | == Move to New Storage Locations == | + | ===AWS S3 Locations=== |
| + | |||
| + | You should not need to move AWS S3 storage locations because their location has not changed. | ||
| + | |||
| + | Make certain that you update your S3 bucket security policy with your new server IP address if you have IP address restrictions. | ||
| + | |||
| + | == Move to New Local Storage Locations == | ||
To complete this process, you will need to create new storage locations and then migrate your files to them. | To complete this process, you will need to create new storage locations and then migrate your files to them. | ||
| Line 12: | Line 18: | ||
# In the WHMCS Admin Area, go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Storage Settings''' or, prior to WHMCS 8.0, '''Setup > Storage Settings'''. | # In the WHMCS Admin Area, go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Storage Settings''' or, prior to WHMCS 8.0, '''Setup > Storage Settings'''. | ||
# Perform the steps for the desired location type: | # Perform the steps for the desired location type: | ||
| − | # | + | ## Select the '''Configuration''' tab. |
| − | + | ## Under '''Add New Configuration''', choose ''Local Storage''. | |
| − | # | + | ## Click '''Add'''. |
| − | # | + | ## Enter path to the new storage location. The directory must exist and be writable. |
| − | # | + | ## Click "Save". |
| − | # | ||
| − | |||
# Repeat these steps for each location until you have added all of the necessary locations. | # Repeat these steps for each location until you have added all of the necessary locations. | ||
# Select the "Settings" tab. | # Select the "Settings" tab. | ||
# Select your new storage location from the menu. | # Select your new storage location from the menu. | ||
| − | # Click "Switch | + | # Click '''Switch'''. <div class="docs-alert-warning"><span class="title">Why can't I select "Migrate"?</span><br />Because the previous storage location does not exist on the server to which WHMCS has been moved, you cannot migrate the files automatically. For this reason, you must manually copy all files to the new location. Clicking '''Switch''' instructs WHMCS to switch the location without performing any automatic attempts to transfer files.</div> |
# Manually copy all files from the previous location to your newly-selected location. | # Manually copy all files from the previous location to your newly-selected location. | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
Revision as of 20:26, 21 January 2022
When you move WHMCS, especially to a new server, it is very likely that your current storage locations will no longer be valid. It is important to update these immediately after moving WHMCS to ensure that your file storage and retrieval continues to function normally.
AWS S3 Locations
You should not need to move AWS S3 storage locations because their location has not changed.
Make certain that you update your S3 bucket security policy with your new server IP address if you have IP address restrictions.
Move to New Local Storage Locations
To complete this process, you will need to create new storage locations and then migrate your files to them.
To do this:
- Create the attachments and downloads directories on the new server in the desired locations.
- In the WHMCS Admin Area, go to Configuration () > System Settings > Storage Settings or, prior to WHMCS 8.0, Setup > Storage Settings.
- Perform the steps for the desired location type:
- Select the Configuration tab.
- Under Add New Configuration, choose Local Storage.
- Click Add.
- Enter path to the new storage location. The directory must exist and be writable.
- Click "Save".
- Repeat these steps for each location until you have added all of the necessary locations.
- Select the "Settings" tab.
- Select your new storage location from the menu.
- Click Switch. Why can't I select "Migrate"?
Because the previous storage location does not exist on the server to which WHMCS has been moved, you cannot migrate the files automatically. For this reason, you must manually copy all files to the new location. Clicking Switch instructs WHMCS to switch the location without performing any automatic attempts to transfer files. - Manually copy all files from the previous location to your newly-selected location.