Overview
This article describes the process to move binary files (databases and indexing files) in the archive stores from one location to another. You may want to do this when moving the archive stores to a different drive or disk.
Information
Follow the steps mentioned below to move the binary files of an archive store from one file location to a new location:
Moving individual archive stores
- From the Archiver web interface, select Configuration > Mail Servers to Archive > highlight the Journal Mailbox > select Deactivate.
- Wait some time, approximately 15 minutes, to ensure that the archiving process has finished. It is recommended to check the following directories and ensure they are empty before proceeding:
..\GFI\Archiver\Core\Pickup
..\GFI\Archiver\Core\Queue
..\GFI\Archiver\MAIS\Pickup
..\GFI\Archiver\MAIS\Queue
- Navigate to Configuration > Archive Stores > highlight the Archive Store being moved > select Summary.
- Note the paths listed (best to take a screenshot).
- Click Detach to detach the Archive Store.
- Back up the Binary folders (this is optional but always a safe step to take).
- Copy/move the binary folders from old location to new location.
- Navigate to Configuration > Archive Stores > Attach to attach the store pointing to the new binary location.
Moving archive stores in bulk
- Deactivate Journaling for affected mailboxes (don't activate it again until the migration completes - step 9c below).
- Launch the Services Management Console by navigating to Start > Run and type
services.msc
. - Stop all GFI Archiver services.
- If there are existing index folders on the new location with the same name, please take a backup and subsequently delete them.
- Move the desired binary and index folders to the new location.
- IMPORTANT: Make a backup of the
marcsettings.xml
from...\GFI\Archiver\Core\Data
- Edit the
marcsettings.xml
file for the database tags (2 locations for each database) and index tag (1 location for each index)- Database example:
- Under the <Databases> tag you should find a <Database> tag for each
- You will see the 2 lines for <BinPath>
- Use a text editor to replace all locations; for example, replace
<BinPath>E:\Archiver\Databases\
(the old path) with<BinPath>G:\Databases\
(the new path)<BinPath>E:\Archiver\Databases\2021 Jul - Aug\Binary</BinPath>
(the old path) becomes<BinPath>G:\Databases\2021 Jul - Aug\Binary</BinPath>
(the new path).
- Index example:
- Under the <Indexes> tag, you should find <RootPath> tags for each
- Use a text editor to replace all locations; for example for moving from E: drive to G: drive
<RootPath>E:\Archiver\Indexes\2021 Jul - Aug</RootPath>
(the old path) becomes<RootPath>G:\Indexes\2021 Jul - Aug</RootPath>
(the new path).
- Database example:
- Launch the Services Management Console by navigating to Start > Run and type
services.msc
. - Start the GFI services and check for the index and database health.
- From the WebUI > Configuration > Archive Store Settings, see the 2 icons for a green checkmark for each entry.
- It can take more than 10 minutes to reload and sync all files per store and in the meanwhile, all indexes can appear as X (red), but it's not an issue, wait for 30 minutes and refresh the page before checking the status. This is because when reloading broken indexes, the search service will try to rebuild and may take a fail-safe 10 minutes per store.
- Only after confirming everything is showing green checkmarks, start the journaling process
IMPORTANT: If you don't see green for everything, please stop and raise a support ticket for assistance.
- Rebuild from the WebUI if you deleted any index folders in step 4 above (for safe measures)
- In case the stores were already moved to the new location before these steps were followed, this may cause some issues, and it is strongly encouraged to rebuild from the WebUI using Method 1 in Rebuild an Archive Store Index.
Additionally, you may want to permanently use the new location to save the new data. If the databases and index should be created in a new location, please refer to Configuring New Archive Store Settings article.