Completing a migration
In this section well review some of the things that need to take place at the end of a migration using Archive Shuttle.
Progress & Performance
The summary information at the top of the Progress & Performance gives a good indicator of what has progressed in the migration.
Failures
Failures during the migration are inevitable.
Assuming that the source environment is fairly healthy the actual result in most migration is just a tiny fraction of a percentage, but a small fraction can still appear to be tens of thousands of items:
In this example 140,000 failed items is actually 0.069% within the migration.
Further, with this example, most items failed to export from the source meaning that source integrity was a possible issue.
Troubleshooting
Archive Shuttle Troubleshooting can be broken down in to a number of different areas, as outlined below.
EV export issues
EV exports not working
If Archive Shuttle is unable to export data from Enterprise Vault, the following steps and information will help Support investigate the issue:
General information
EV version
Location of the EV Export Module (is it on an EV Server)
Archive Shuttle Core version
Archive Shuttle modules version
Steps to follow
Is it all items for all mappings? Yes/No. If Yes, go to step 1. If no, go to step 2.
Step 1
1.Check the staging area is configured for the links which are required.
a.Some links may not have the default staging area.
b.Check the staging area is accessible from the location where the export modules are installed
c.Collect a screenshot
2.Check modules are associated with the links
a.Some links may not have had any modules configured for them
b.Collect a screenshot
3.Check the modules are enabled
a.This is on the Modules page
b.Collect a screenshot
4.Check the modules are scheduled appropriately
a.This is on the Modules page
b.Collect a screenshot
Step 2
Is it some items for all mappings? Yes/No. If Yes continue with this step. If No, go to Step 3.
1.Check the Failed Items screen for the mappings
a.Remember to select the link when entering the Failed Items screen for the first time
b.Collect a screenshot
2.Check the error that has been presented on the Failed Items Screen
a.Often the error will indicate what the problem is, or where to check
b.Collect a screenshot
3.Check that the items can be downloaded
a.Click on the Download link. This will call download.asp for the item, from Enterprise Vault
b.Does the item download successfully? Yes/No
c.Does the item open correctly in Outlook? Yes/No
4.Try reprocessing the items from the failed items screen which will submit them to the export module again.
a.It may take a few minutes for the items to actually get reprocessed
b.Check the Failed items screen afterwards
c.Indicate whether the errors are the same and collect a screenshot. Same error? Yes/No
5.Try reprocessing the items by clicking on Failed Exports on the Stage 1 screen
a.It may take a few minutes for the items to actually get reprocessed
b.Check the Failed Items screen afterwards
c.Indicate whether the errors are the same and collect a screenshot. Same error? Yes/No
6.Check the license has not expired
a.Take a screenshot of the license page. Note: The license is month/day/year format.
Step 3
Did export start, and then just stop? Yes/No. If Yes continue with this step.
1.Check that the module doesnt have a scheduled defined
a.This is on the Modules page
b.Collect a screenshot
2.Check the Health Dashboard and ensure that the link is not used up (ie watermarks and exported but not imported)
a.Collect a screenshot
3.Check the disk space thresholds on the Health Dashboard
a.Collect a screenshot
4.Select Hanging Exports on the Stage 1 screen
a.Describe what happens
b.Wait 1-2 minutes, and refresh the Stage 1 screen to see if the exports start again
5.Check the ItemRoutingErrorCount in the ItemRouting table in SQL
a.If the error count is 10 or higher, the items will not be automatically reprocessed
b.They can be manually reprocessed by changing the Error Count in SQL, or from the Failed Items screen
6.Check the license has not expired
a.Take a screenshot of the license page. Note: The license is month/day/year format.
Step 4
a.Ensure that the module is configured for TRACE level logging
b.This is done on the Modules page
c.Reprocess the item(s), or click on Failed Exports, or click on Hanging Exports on Stage1 screen
d.Wait one to five minutes
e.Generate a Support Bundle for review by Support
EV import issues
EV Imports not working
If Archive Shuttle is unable to import data into Enterprise Vault, the following steps and information will help Support investigate the issue.
General information
·EV version
·Location of the EV Import Module (is it on an EV Server)
·Archive Shuttle Core version
·Archive Shuttle modules version
Steps to follow
Is it all items for all mappings? Yes/No. If yes, go to step 1, if no, go to step 2.
Step 1
1.Check that the retention categories are mapped.
a.Unmapped categories can be seen on the System Health page
b.This is required for intra or inter site migrations
c.Take a screenshot of the Retention Category mappings
2.Check that the EV Import modules are scheduled
a.This is on the Modules page
b.Take a screenshot of the schedule
3.Check that the EV Import module is enabled, and the Core is able to communicate with it
a.The module should not show as red on the Modules page
b.Take a screenshot of the Modules page
4.Check that the link containing the target vault store has an Import Module which is mapped
a.This is on the Links Page
b.Take a screenshot, and highlight the link
Step 2
Is it some items for all mappings? Yes/No. If yes, continue with this step, if no, go to step 3.
1.Check the disk space is not exhausted
a.Collect a screenshot
2.Check that the exported-but-not-imported figure has not exceeded 100%
a.Take a screenshot of the System Health page
3.Review any errors on the Failed Items screen
a.Take a screenshot of the errors
Step 3
Did the import start, and then just stop? Yes/No. If yes, continue with this step, if no go to step 4.
1.Check that the module doesnt have a scheduled defined
a.This is on the modules page
b.Take a screenshot of the schedule
2.Check the System Health page to ensure the target vault store/link is not in backup mode
a.Take a screenshot of the System Health Page
3.Check the Index Incomplete values on the System Health page
a.Take a screenshot of the System Health Page
4.Check the disk space is not exhausted
a.Collect a screenshot
5.Check that the exported-but-not-imported figure has not exceeded 100%
a.Take a screenshot of the System Health page
6.Review any errors on the Failed Items screen
a.Take a screenshot of the errors
Step 4
1.Gather logs:
a.Ensure that the module is configured for TRACE level logging
b.This is done on the modules page
c.Reprocess the item(s) or click on Failed Imports, or click on Hanging Imports
d.Wait one to five minutes
e.Generate a Support Bundle for review by Support.