We have made Mailbox Shuttle as flexible as possible when it comes to managing the migration of mailboxes. The management options are described in more detail in the sections below:

Users
User Groups
Stage 1: Sync
Stage 2: Switch
Stage 3: Integration

In this section we describe the basic configuration that is required for Mailbox Shuttle.

Environments
PowerShell Scripts
Integration

There are various configurable options in Mailbox Shuttle, the are described in the following sections:

General
Modules
Active Directory

Configuration

In this section we describe the basic configuration that is required for Mailbox Shuttle.

Environments

The Environments page in the user interface displays information about the environments involved in the migration, and allows configuration to take place. This is described in the sections below:

ItemDescription
NameShows the name of the environment as it was given when it was configured in Mailbox Shuttle
TypeThe kind of environment, for example Exchange, Office 365, etc
PowerShell ModuleThe associated PowerShell module server
AD ModuleThe associated Active Directory module server
Default ServerThe chosen default server for commands/operations to take place on
Has MappingIndicates whether the environment has migrations/mappings associated with it. A green dot indicates that there are mappings, no dot indicates that there are no mappings

PowerShell Scripts

The page in the user interface allows you to update PowerShell scripts which can be used during the migration to perform additional activities. The following actions are available:

ActionDescription
AddClick on this button to bring up a dialog where PowerShell scripts can be given a name and description, and then uploaded
EditThis button can be used to change the name or description of a script. It can also be used to upload a new revision of a script.
DeleteWhen one or more scripts are selected this button can be used to remove the script
Refresh /ResetThese buttons are used to refresh the grid containing the list of scripts, or to reset the grid back to the default display

Integration

This page in the user interface allows you to configure the integration between Mailbox Shuttle and Archive Shuttle, it is described in more detail in the Integration Guide.

Managing a Migration

We have made Mailbox Shuttle as flexible as possible when it comes to managing the migration of mailboxes. The management options are described in more detail in the following sections.

Users

This page shows all of the users in the environment and information relating to any configured migrations and group membership. Information which is displayed and actions which can be performed are described below:

ItemDescription
Group NameThis will either indicate that the mailbox is not in any group (Groupless) or it will give the name of the associated group
Display NameThe users display name from Active Directory
DatabaseThe name of the mailbox database for the primary mailbox of the user
E-mailThe primary SMTP address of the user
TypeAn indicate of the type of the mailbox / user, eg Exchange, Office 365
Has ArchiveA flag to indicate if the mailbox has an associated secondary mailbox (personal archive). A green dot indicates that there is a secondary mailbox, a red dot indicate that there isn’t.
MappedA flag to indicate if the mailbox is already mapped. A green dot indicates it is mapped, a red dot indicates it is not mapped
Item count / item sizeThe number of items in the primary mailbox and the overall size of the mailbox

Actions

ActionDescription
Add MappingIndividual mappings can be configured by selecting one or more users, and clicking this button
SyncSends a command to collect metadata about the selected mailboxes (eg item count, and size)
Assign Users / Unassign usersAllows you to add users to a group, or remove them
Refresh / Columns / ResetThese buttons are used to refresh the grid containing the list of users, select any additional data-columns which might be available, or to reset the grid back to the default display.

User Groups

This page in the user interface displays information about groups, and allows groups to be created and configured. Valuable information is displayed relating to each group and there are several actions which can be performed. These are described below:

ItemDescription
NameThe chosen name of the group
DescriptionThe description which was given to the group when it was created
Sync Start DateThis is the date and time that the mailbox sync will start between the source and target environment
AutocompleteThis indicates whether the mappings should be completed automatically or not. A green dot indicates that the mappings will be automatically completed, a red dot indicates that they won’t.
Switch Start DateeThis is the date and time that the ‘switch’ should take place between the source environment and the target environment. This would normally be set to a date and time which is outside of the business hours of the users in the group so as to not cause disruption to the end-users whilst the switch takes place.
Users CountThe number of users added to the group
Primary Mailbox Items and Primary Mailbox SizeThe number of items and size of items in the primary mailbox
Secondary Mailbox Items and Secondary Mailbox SizeThe number of items and size of items in the secondary mailbox
Mapping Counts – CreatedThe number of mappings which have been created for members of the group
Mapping Counts – EnabledThe number of mappings which are currently enabled for migration in the group
Mapping Counts – DisabledThe number of mappings which are currently disabled from migration in the group
Mapping Counts – FailedThe number of failed migrations in the group
Mapping Counts – CompletedThe number of mappings which have so far completed migration in the group

Actions

ActionDescription
Add / Edit /DeleteAllows a group to be created, edited and deleted
SyncAllows metadata relating to the group to be collected. This is information such as the number of items and size of mailboxes
CSV ExportExports the metadata for a particular environment to a CSV file
CSV ImportAllows CSV files to be imported into Mailbox Shuttle
ManageThis switches the screen to the ‘Users’ page, with the page filtered to show the selected group. It assists with adding additional users to a group, or removing users from a group
Sync & SwitchAllows you configure the Synchronization start date / time, whether the group should be ‘auto switched’ after the synchronization stage completes, or a specific switch data and time can be configured
Switch MappingAllows you to switch all of the mappings associated with the selected group.
Bad Item LAllows you to configure the number of item-level errors for a group. If there are fewer failed items than this, then the synchronization step will still be considered a success, and the mapping can be switched.
Complete BatchAllows a group to be completed
Refresh / Columns / Reset These buttons are used to refresh the grid containing the list of groups, select any additional data-columns which might be available, or to reset the grid back to the default display.

Stage 1

The stage 1 page in the user interface shows synchronization progress for groups and for mappings. It shows information about them, and allows actions to be performed on them, as described below:

ItemDescription
Group NameThe name of the group
E-mailThe primary SMTP address of the mailbox / user
EnabledA flag to indicate if the migration is enabled or not. A green dot indicates that the migration is enabled, a red dot means it is not enabled
PriorityThe relative priority of the migration
Existing Move requestAn indicator about whether this mapping relates to an existing move request, or not
StatusThe current status of the migration
MessageAny informational messages about the mapping will be displayed here
Failed ItemsThe number of failed items in the mapping
ProgressThe percentage progress of the migration
Sync Start DateThe date / time that mailbox synchronization will start
AutocompleteA flag to indicate if the migration will be moved into Stage 2 automatically (Autocompleted). A green dot indicates that autocomplete is enabled, a red dot indicates it is not.
Suspend ReasonIf a migration is suspended the reason for the suspension will be given here
Migration timeline – Started / EndedThe date / time that migration started and finished
Last UpdateWhen the mapping information was last updated
Source TypeAn indicator to show the type of the source container
Target TypeAn indicator to show the type of the target container
Scripts ExecutionA flag to indicate whether scripts will be run on this mapping

Actions

ActionDescription
Pause / ResumeThis button allows you to pause and resume migration
RemoveThis button allows you to remove a mapping
RetryThis button allows you to queue a command to retry the migration
Bad Item LimitThis button lets you configure a bad item limit, and that means if there are fewer failed items than the limit, the synchronization is considered a success and the mapping can continue into stage 2.
Enable / DisableThis button allows you to enable or disable a mapping from migration
Delete MappingThis button allows you to delete a mapping from the system
Refresh / Columns / Reset
These buttons are used to refresh the grid containing the list of groups, select any additional data-columns which might be available, or to reset the grid back to the default display.

Stage 2

This page in the user interface allows you to view details relating to stage 2 of the migration. It shows important information, as well as allowing actions to be performed. These are described below:

ItemDescription
Group NameThe name of the group
E-mailThe primary SMTP address of the mailbox / user
PriorityThe relative priority of the migration
StatusThe current status of the migration
MessageAny information messages about the mapping will be displayed here
ProgressThe percentage progress of the migration
Source TypeAn indicator to show the type of source container
Target TypeAn indicator to show the type of target container
Scripts ExecutionA flag to indicate whether scripts will be run on this mapping
Switch Start DateThe date / time that the switch to stage 2 started on
Suspend ReasonIf a migration is suspended the reason for the suspension will be given here

Actions

ActionDescription
Switch UsersEnable stage 2 for the selected mappings
RetryThis button allows you to queue a command to retry the migration
Bad Item LimitThis button lets you configure a bad item limit, and that means if there are fewer failed items than the limit, the synchronization is considered a success and the mapping can continue through stage 2.
Refresh / Columns / ResetThese buttons are used to refresh the grid containing the list of mappings, select any additional data-columns which might be available, or to reset the grid back to the default display.

Stage 3

This page in the user interface shows the progress of the workflow relating to the migration of archive data using Archive Shuttle, it will be described in more detail in the Integration Guide.

Reports

As part of any migration project there is usually a requirement to report on the progress. Mailbox Shuttle has various on-screen reports and are described in more detail in the following sections.

Overall Dashboard

This page in the user interface displays key indicators relating to your migration. The information shown is described below:

ItemDescription
StatusThis shows an overall percentage bar of the number of users completed and the amount of volume which is complete.

Basic Statistics
This shows the number of mailboxes, the number of items and overall size of the environment. It also shows high level statistics from the migration so far.
Current ActivityThis shows a bar graph of the current spread of activity and the different stages of that activity
Migration SpeedThese two sections show the migration speed on each day in terms of the number of mailboxes, and also the data volume related to those mailboxes.
Last 5 Scheduled GroupsGives an overview of the last five scheduled groups and what happened them during the migration
Next 5 Scheduled GroupsIf there are additional groups already scheduled to migrate at specific dates and times, they are shown here along with information relating to the number of mailboxes, and size.
MigrationsA pie chart summary of the migrations which have taken place broken down to where they are in the migration. (eg completed, ‘in stage 1’, etc)
Migration Speed Items/h and GiB/hShows the migration speed in terms of number of items per hour, and, the volume per hour.

Groups Report

This page in the user interfaces show a summary of the actions performed on all configured groups in the migration. Individual groups can also be analyzed and reported on in more detail. The information shown on this page includes:

ItemDescription
GroupYou can select a particular group, or select an overall summary of all groups. This is done in the drop down list at the top of the page.
Migration Progress – MailboxesShows the progress through the stages of migration based on the number of mailboxes.
Migration Progress – ItemsShows the progress through the stages of migration based on the number of items.
Migration Progress – VolumeShows the progress through the stages of migration based on the volume of data.
Error ReportShows a list of errors against associated mailboxes
Unmapped UserShows a list of all users who are not currently mapped for migration or associated with a group

Integration Status Report

This page in the user interface shows the progress of any email archive migration which is also taking place using Archive Shuttle. This page is described in more detail in the Integration Guide.

Scripts Execution Report

If scripts have been run during the migration, the result of the execution of those scripts, per mailbox, will be shown on this page in the user interface.

Settings

There are various configurable options in Mailbox Shuttle, the are described in the following sections.

General

This page in the user interface contains general settings which can be changed. After changing a value on the screen, remember to click on ‘Save’. The settings are described below:

SettingDescription
UI Log LevelControls the logging level for the user interface
Time ZoneControls the time zone, if you are based in US Eastern Standard time, set that in the drop down list. All of the sync and switch dates/times are based around the time zone configured here.

Modules

This page in the user interface displays information about the modules installed in the migration environment. There is some important information displayed on this page along with several actions which can be performed, these are described below:

ItemDescription
Module TypeThe kind of module, for example Exchange Import, Office 365 etc
EnabledAn indicator of whether the module is enabled or not. A green dot indicates it is enabled, a red dot indicates it is not enabled. Disabled modules receive no new work items

Computer Name

The name of the server where the module is installed

Domain
The DNS domain name of where the module is installed
VersionThe software version of the module
Core Log Level / Module Log LevelThese indicate the amount of logging which is currently being generated. Normally INFO level logging is sufficient however, for troubleshooting any problems which might be encountered you may be advised by Support to increase the logging level. When the level is changed in the user interface the next time the module checks in for work it will receive the change in configuration and begin logging at the new level.
Module HealthThis indicates whether the Windows service relating to the module is running or not. A green dot indicates that the service is running, a red dot indicates that the service is not running.

Actions

ActionDescription
Enable / DisableWhen one or more modules are selected they can be enabled or disabled by using these buttons. A disabled module will continue with its current workload, but will request no additional work.

Start / Stop / Restart
When one or more modules are selected these buttons can be used to start, stop, or restart the selected modules.
UpdateWhen one or more modules are selected this button will download the latest available modules, and upgrade them without the need to remotely connect to the server and install the update manually. It is recommended to select each Admin module which is shown in the list of modules and update that. It will update all of the modules on the chosen server(s).
Set Log LevelWhen one or more modules are selected this button will allow you to change the current log level
Refresh / Columns / ResetThese buttons are used to refresh the grid containing the list of modules, select any additional data-columns which might be available, or to reset the grid back to the default display.

Active Directory

This page in the user interface tells you about domains which are discovered in the environment, and allows some actions to be performed, as described below:

ItemDescription
NameThe DNS name of the domain
Scan DomainWhether or not this domain will be scanned for metadata. A green dot indicates it will be scanned, a red dot indicates it won’t be scanned
Distinguished NameThe Active Directory distinguished name of the domain

Actions

ActionDescription
Sync AD UsersWhen one or more domains are selected, clicking on this button will tell the Active Directory modules to collect metadata from the domains.
Enable / DisableWhen one or more domains are selected, clicking on these buttons will enable or disable metadata collection
Refresh / Columns / ResetThese buttons are used to refresh the grid containing the list of domains, select any additional data-columns which might be available, or to reset the grid back to the default display.
Print Friendly, PDF & Email