III.Change processed Source Data to point to the new location

I.Move Collection Tasks and Sets

NOTE: This section can be skipped for environments that do not include the Collection module. 

Description: The ‘Move’ feature in the Collection module updates the data location pointers within the ICP tables.  The 'Move' will copy the Task data from Point A (original location) to Point B (the new location) and delete the Task data from the original location.  The Collection Set data will not be touched by this feature. 
IMPORTANT: If the Collection data is manually copied prior to executing the 'Move' feature.  It is important to delete the data from the original location before executing the 'Move' feature.  The feature will update the location pointers within the database and attempt to copy the Task data again.  If Task data exists, the 'Move' feature will overwrite the Task data that was copied prior to its execution.


1.  Add the new server locations.  Duplicate the folder hierarchy at the new location.

2. Ensure there are no running Collection Tasks
 

3.  Delete or Process any unprocessed data.
NOTE: If there is a Trash Can icon on the right, the data has only been discovered and not processed.
NOTE: If there is yellow in the glyph To Process, the pointers will no longer be able to locate the unprocessed data after the move.
 

4. Open the All Collection home page and select the ‘Move’ icon.
 

5. Select the new location.
 

Once the Select button is chosen the Collection Tasks will be moved to the new location.
The 'Move' feature copies only the Collection Tasks and does not copy the Sets.  Collection Sets must be manually RoboCopied to the new location, followed by the use of the Collection Locator Modifier (as described in Section II)
NOTE: The ‘Move’ action, will set the new location as the default Data Location for that Collection only.


6. Inspect the job Status logs for a successful completion:
03/17/2020 12:03:04 Collection move job finished
03/17/2020 12:03:04 Progress: 100%

Note: Usually within an hour, the Collection Tasks will be deleted from the original location.  Remaining Tasks are rogue and must be manually deleted.

II.Change processed Collection Sets to point to the new location

1.  Add the new server locations.  Duplicate the folder hierarchy at the new location.

2. Robo copy the source data to the new location.

3. Enable the feature 'Collection Locator Modifier' by setting the ESA property esa.support.destinationmodifier.restricted to 'false'.

How to modify the ESA property
a. Log into the user interface.
b. Navigate to System > Support Features
c. Choose Property Browser
d. In the text box for 'Name of property to change' enter the ESA property
esa.support.destinationmodifier.restricted

e. In the text box for 'New value (leave blank to remove)' enter the new value
false
f. Check the box for 'Confirm change. Are you sure?*'
g. Click the Submit button

4. Determine the current location of the collection Sets within a case.
a. Select the case > Processing > Sources & Pre-Processing
b. Expand the Collection Set source.
c. Click on the 'i' information bubble under the Processing Status column and note the server name.  As long as the folder structure remains the same on the new server as it was on the old server, the only information that needs to be changed will be the server name.

5. Open the 'Collection Locator Modifier' tool under Support Features
System > Support Features > Collection Locator Modifier.
NOTE:  If the tool is not visible, go to step 3 of this section

a. Select the appropriate Server and either All cases or select a specific case.
b. Select Verify for the Operation
c. Insert the original location for the Old Location
d. Insert the new server location for the New Location
e. Select Submit

6. An important message will be displayed on the screen, please read and comply, then select OK.

7. Open the Job Status log for the ‘Move collection locators’ job.
NOTE:  There will be four rows for the Evidence_Repo database as well as for each case selected.  The number at the end of that row will contain the number of records per table that indicate how many records contain the ‘Old Location’.  These records will be modified to point to the ‘New Location’.
  If all rows end in – 0, then either the ‘Old Location’ was enter incorrectly or the tool has already been executed.

8. Once you have verified the number appear to be correct, change the Operation from Verify to Execute and press Submit.
NOTE:  Once again the important message concerning data handling will appear (same as Step 6).  Verify the data has been moved and click on OK.
 

9. Open the Job Status log for the ‘Move collection locators’ job.
Each case selected will have the updated record count.

And a corresponding section under Verification, which will indicate the number of remaining records with the ‘Old Location’ ( - 0 ).

10.  Verify the change was made as required by opening the case > Processing > Sources & Pre-Processing page.  Expand the Collection Set source.
  Click on the 'i' information bubble under the Processing Status column and note the server name.  The server name will display as the ‘New Location’