Migrating a journal archive to Enterprise Vault
This section outlines the steps that are required in order to complete the migration of a single journal archive within Enterprise Vault to a new Vault Store.
The first section explains how to perform the migration using a single container mapping. It is necessary to perform these steps if the migration is from a version of Enterprise Vault prior to 10.0.4. In Enterprise Vault 10.0.4, changes were made to the Enterprise Vault API meaning that a new way can be used to extract and ingest data. The second part of this topic explains how to perform a journal archive migration if Enterprise Vault 10.0.4 or later is the source.
Pre-Enterprise Vault 10.0.0.4 source
Prerequisites
It is essential that the following steps have been completed prior to beginning the migration:
·All Modules are enabled
·Appropriate Active Directory Domains are enabled for scanning
·An Enterprise Vault Environment has been added for migration
·A Link Database has been created for the source archive
·Module Mappings are configured for the source Vault Store and also the target Vault Store
The target for the journal archive migration must also:
·Be a user and be setup with a mailbox
·Have a journal archive created for it, in an appropriate Vault Store
·Be listed as a Journal Target in the Vault Administration Console
|
|
NOTE: The Enterprise Vault journal task is used to ingest the data in to the target journal archive container. |
Map containers - For the journal archive
The first thing to do when migrating a journal archive to a new vault store is to do a container mapping. This is slightly different to the process followed earlier in the document since Archive Shuttle must do a single container mapping. To setup the mapping, follow these steps:
1.Click Manual Mapping.
You will now see two lists of containers.
2.Locate the source journal archive in the left hand list, and select the radio button next to the archive.
3.Locate the target journal archive in the right hand list, and select the radio button next to the archive.
|
|
NOTE: All the normal filtering and searching is available on the Single Container Mapping screen, which can help identify the correct archives when there are many journal archives displayed on screen. |
4.Click Add Mapping.
Set policies and enable migration
Once the container mapping has been selected, it is necessary to add two more components to the link, before the migration can be enabled. To setup the migration, follow these steps:
1.Click Existing Mappings.
|
|
NOTE: All the normal filtering and searching is available on the Existing Mapping screen, which can help identify the mapping. |
2.Locate the mapping that was created in the previous step.
3.Select the checkbox next to the mapping.
4.From the toolbar, select Set Workflow Policy and choose the Journal Workflow.
5.From the toolbar, select Set Filter Policy and choose a filter if one is required.
6.Finally, from the toolbar select Enable for Migration, and Enable Item Gathering.
|
|
NOTE: The container mapping will now look much like other mappings that may have been created. Ensure that the Item Gathering and Migration Enabled flags are displayed before moving on to monitoring the migration. |
Monitoring the migration
Monitoring the Stage 1 synch process for a journal archive is the same as with other types of archive migration. A few minutes after setting the policies and enabling migration (see previous section), the container will appear on the Stage 1 (Sync Data) screen in the administration console.
Performing Stage 2 and extra steps
Migrating a journal archive is slightly different than migrating an ordinary Enterprise Vault archive. There are a few additional steps, as outlined below:
1.Stop the Enterprise Vault Journal Task, and set the startup of the task to Disabled.
|
|
NOTE: The journal mailbox that the task was targeting will now start to grow in size because Enterprise Vault is no longer processing items from it. |
2.Go to the Stage 1 (Sync Data) screen.
3.Locate the container mapping for the journal archive, and select the check box next to it.
4.From the toolbar, select Enable Stage 2.
5.After a few minutes, observe the Stage 2 (Switch User) screen and ensure that after a few more minutes the migration is marked as complete.
The Journal Archive has now been moved to a new Vault Store, and a new archive. The final step is to change the journaling process in Enterprise Vault. Usually this is a matter of changing the journal target to be the new archive, and restarting the journal task after setting the task startup back to Automatic.
|
|
NOTE: Depending on the migration being performed, it may also be necessary to reconfigure the Exchange journaling configuration to journal to the new mailbox. |
Enterprise Vault 10.0.0.4 or later source
Prerequisites
It is essential that the following steps have been completed prior to beginning the migration:
·All Modules are enabled
·Appropriate Active Directory Domains is enabled for scanning
·An Enterprise Vault Environment has been added for migration
·A Link Database has been created for the source archive
·Module Mappings are configured for the source Vault Store and also the target Vault Store
Map containers - For the Journal Archive
The first thing to do when migrating a journal archive to a new vault store is to do a container mapping. This is slightly different than the process followed earlier in the document since Archive Shuttle must do a single container mapping.
To setup the mapping, follow these steps:
1.Navigate to the Bulk Mapping or Manual Mapping page.
2.Type the beginning of the archive name in the Name filter. Click the Apply button at the right of the filter row.
3.Select the checkbox next to the archive, and click Add Mappings from the navigation bar.
|
|
NOTE: A short wizard will start, which gathers information relating to the mapping for the archive. |
4.The destination of the migration can then be chosen from the available list and then subsequent pages of the wizard will prompt for further information.
|
|
NOTE: It is recommended that a workflow policy is created that suits the requirements, or the Journal Archive workflow is chosen. |
Set Policies and Enable Migration
Once the container mapping has been selected, it is necessary to add two more components to the link, before the migration can be enabled.
To setup the migration, follow these steps:
1.Click Existing Mappings.
|
|
NOTE: All the normal filtering and searching is available on the Existing Mapping screen, which can help identify the mapping. |
2.Locate the mapping that was created in the previous step.
3.Select the checkbox next to the mapping.
4.From the toolbar, select Set Workflow Policy and choose the Journal Workflow.
5.From the toolbar, select Set Filter Policy and choose a filter if one is required.
6.Finally, from the toolbar select Enable for Migration and Enable Item Gathering.
|
|
NOTE: The container mapping will now look much like other mappings that may have been created. Ensure that the Item Gathering and Migration Enabled flags are displayed before moving on to monitoring the migration. |
Monitoring the Migration
Monitoring the Stage 1 synch process for a journal archive is the same as with other types of archive migration. A few minutes after setting the policies and enabling migration (see previous section), the container will appear on the Stage 1 (Sync Data) screen in the administration console.
Performing Stage 2 and Extra Steps
Migrating a journal archive is slightly different to migrating an ordinary Enterprise Vault archive. There are a few additional steps, as outlined below:
1.Stop the Enterprise Vault Journal Task, and set the startup of the task to Disabled.
|
|
NOTE: The journal mailbox that the task was targeting will now start to grow in size because Enterprise Vault is no longer processing items from it. |
2.Go to the Stage 1 (Sync Data) screen.
3.Locate the container mapping for the journal archive, and select the check box next to it.
4.From the toolbar, select Enable Stage 2.
5.After a few minutes, observe the Stage 2 (Switch User) screen and ensure that after a few more minutes the migration is marked as complete.
The Journal Archive has now been moved to a new Vault Store, and a new archive. The final step is to change the journaling process in Enterprise Vault. Usually this is a matter of changing the journal target to be the new archive, and restarting the journal task after setting the task startup back to Automatic.
|
|
NOTE: Depending on the migration being performed, it may also be necessary to reconfigure the Exchange journaling configuration to journal to the new mailbox. |
Migrating a shared mailbox archive
This section outines the steps that are necessary to complete the migration of an archive shared amongst a group of users. The migration will be from one Enterprise Vault environment to another.
In Enterprise Vault, this may simply be a regular mailbox archive so that is maintains the structure from the mailbox where the data comes from. The mailbox itself will ultimately have one true owner in Active Directory, but a number of other users and/or groups may also have access to both the mailbox and the archive.
Capture Permissions on the Source
There a number of ways in which the permissions can be shown for an archive, including the following:
·Open the properties of the archive in the Vault Administration Console, and check the entries on the permissions tab
·Use a script similar to the one provided on the Symantec Connect web site:
Build an EVPM File
From the list of permissions on the source archive an EVPM file should be built. There are details about the way to use EVPM in the Enterprise Vault Utilities Guide. At a high level the steps are:
·Directory section should contain information about the Enterprise Vault Directory computer and Enterprise Vault site name.
·A section should be added called ArchivePermissions
·The Archive Name property should be added to this section with the name of the archive.
·The Grant Access property should be added to this section with a list of people to grant access to the archive. This should be listed one per line.
Perform the Migration
The migration of the archive/container can then be performed. Particular care should be taken in relation to migrating these types of archives/containers because the migration has an impact on a number of people.
Apply the EVPM File
Following the successful migration of the Shared Mailbox / Archive, the EVPM file that was created previously should be run to grant permissions on to the target/new archive.