Moving Storage Locations - Revision history

SarahK: Redirected page to Migrating Between Storage Locations

2022-07-07T14:41:36Z

Redirected page to Migrating Between Storage Locations

SarahK at 19:54, 26 April 2022

2022-04-26T19:54:55Z

SarahK: /* AWS S3 Locations */

2022-01-21T20:26:43Z

‎AWS S3 Locations

SarahK at 20:26, 21 January 2022

2022-01-21T20:26:11Z

SarahK at 20:23, 21 January 2022

2022-01-21T20:23:48Z

SarahK: /* Create New Storage Locations */

2021-09-30T20:09:35Z

‎Create New Storage Locations

SarahK at 18:19, 5 August 2020

2020-08-05T18:19:39Z

John: /* Create New Storage Locations */

2019-02-20T15:32:27Z

‎Create New Storage Locations

John: /* Create New Storage Locations */

2019-02-20T15:30:08Z

‎Create New Storage Locations

PeterB: DOCS-6799

2019-02-20T14:56:14Z

DOCS-6799

New page

__TOC__

When moving 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.
Performing the following steps will allow you to update your locations to new, valid locations.

== Create New Storage Locations ==
The first step is creating new storage locations. Create the attachments and download directories on the new server in the desired location (usually above the web-root).

Now login to the WHMCS Administration area and navigate to Setup > Storage Settings

=== Local Storage ===
#Click "Configuration" tab.
#In "Add New Configuration" tile, choose "Local Storage" or and click "Add".
#Enter path to the new storage location. The directory must exist and be writable. Click "Save".
#Repeat these steps as many times as required until all locations have been created.

=== AWS S3 ===
For AWS S3 locations, you should not need to move your storage locations. This is because their location has not changed.

You must ensure that your new server IP is updated in your S3 bucket security policy if this has changed and you have IP restrictions in place.

== Migrate to new Storage Locations ==
#Click the "Settings" tab
#Using the dropdown provided, select your new storage location. 3 buttons will appear next to the dropdown.
#Select "Switch"
#Manually copy all files from the previous location to your newly selected location.

<div class="docs-alert-warning">
<span class="title">Why can I not select "Migrate"?</span><br />
The previous storage location does not exist on the server to which WHMCS has been moved, so the files cannot be migrated automatically. For this reason, you must manually copy all files to the new location. By selecting "Switch", you are instructing WHMCS to switch the location without performing any automatic attempts to transfer files.
</div>

← Older revision		Revision as of 14:41, 7 July 2022
Line 1:		Line 1:
−	~~__TOC__~~	+	#REDIRECT [[Migrating_Between_Storage_Locations]]
−
−	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 (<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:~~
−	~~## 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'''. <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.~~

@@ Line 16: / Line 16: @@
 # Create the ''attachments'' and ''downloads'' directories on the new server in the desired locations.
-# 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:
 ## Select the '''Configuration''' tab.

@@ 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.
-===AWS S3 Locations===
+==AWS S3 Locations==
 You should not need to move AWS S3 storage locations because their location has not changed.

@@ 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.
-== Move to New Storage Locations ==
+===AWS S3 Locations===
 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'''.
 # Perform the steps for the desired location type:
-#* For local storage locations:
+## Select the '''Configuration''' tab.
-#*# Select the '''Configuration''' tab.
+## Under '''Add New Configuration''', choose ''Local Storage''.
-#*# Under '''Add New Configuration''', choose ''Local Storage''.
+## Click '''Add'''.
-#*# Click '''Add'''.
+## Enter path to the new storage location. The directory must exist and be writable.
-#*# 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"
+# 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.

@@ Line 1: / Line 1: @@
 __TOC__
-When moving 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.
-== Create New Storage Locations ==
+== Move to New Storage Locations ==
-# Create the ''attachments'' and ''downloads'' directories on the new server in the desired location.
+To complete this process, you will need to create new storage locations and then migrate your files to them.
-# Log in to 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'''.
+To do this:
 # Perform the steps for the desired location type:
-## For local storage locations:
+#* For local storage locations:
-### Select the '''Configuration''' tab.
+#*# Select the '''Configuration''' tab.
-### Under '''Add New Configuration''', choose ''Local Storage''.
+#*# Under '''Add New Configuration''', choose ''Local Storage''.
-### Click '''Add'''.
+#*# Click '''Add'''.
-### Enter path to the new storage location. The directory must exist and be writable.
+#*# Enter path to the new storage location. The directory must exist and be writable.
-### Click "Save".
+#*# Click "Save".
-## For AWS S3 locations:
+#* For AWS S3 locations, you should not need to move 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.
-### You should not need to move storage locations because their location has not changed.
+# Repeat these steps for each location until you have added all of the necessary locations.
-### Make certain that you update your S3 bucket security policy with your new server IP address if you have IP address restrictions.
+# Select the "Settings" tab.
-# Repeat these steps as many times as required until all locations have been created.
+# Select your new storage location from the menu.
+# Click "Switch"
-== Migrate to new Storage Locations ==
+# Manually copy all files from the previous location to your newly-selected location.
 <div class="docs-alert-warning">
 <span class="title">Why can't I select "Migrate"?</span><br />
-The previous storage location does not exist on the server to which WHMCS has been moved, so the files cannot be migrated automatically. For this reason, you must manually copy all files to the new location. By selecting "Switch", you are instructing WHMCS to switch the location without performing any automatic attempts to transfer files.
+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>

@@ Line 7: / Line 7: @@
 The first step is creating new storage locations. Create the ''attachments'' and ''downloads'' directories on the new server in the desired location (usually above the web-root).
-Now login to the WHMCS Administration area and navigate to '''Setup > Storage Settings'''
+Now login to the WHMCS Administration area and navigate to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Storage Settings''' or, prior to WHMCS 8.0, '''Setup > Storage Settings'''.
 === Local Storage ===
@@ Line 27: / Line 27: @@
 <div class="docs-alert-warning">
-<span class="title">Why can I not select "Migrate"?</span><br />
+<span class="title">Why can't I select "Migrate"?</span><br />
 The previous storage location does not exist on the server to which WHMCS has been moved, so the files cannot be migrated automatically. For this reason, you must manually copy all files to the new location. By selecting "Switch", you are instructing WHMCS to switch the location without performing any automatic attempts to transfer files.
 </div>

@@ Line 5: / Line 5: @@
 == Create New Storage Locations ==
-The first step is creating new storage locations. Create the attachments and download directories on the new server in the desired location (usually above the web-root).
+The first step is creating new storage locations. Create the ''attachments'' and ''downloads'' directories on the new server in the desired location (usually above the web-root).
 Now login to the WHMCS Administration area and navigate to Setup > Storage Settings