Upgrading Archive Shuttle
This section describes how to upgrade an Archive Shuttle migration environments.
Archive Shuttle strongly advises you to read through this section in its entirety before performing any kind of production environment upgrade.
There are three components that will be upgraded:
·Archive Shuttle Core: An MSI will be run to perform this upgrade.
·Archive Shuttle Modules: An MSI will be run to perform this upgrade.
·Archive Shuttle databases: Archive Shuttle Core will upgrade the Archive Shuttle Directory Database, and each Item Database when the Windows services start, following the upgrade.
|
|
NOTE: See the Quadrotech Archive Shuttle Compatibility Guide to determine what version of .Net is required for the Archive Shuttle Core server. |
Supported upgrade paths
You can upgrade to the current version of Archive Shuttle from any previous version of Archive Shuttle. The specific build that is running will not affect the upgrade.
How to monitor DB upgrade status
Archive Shuttle should handle upgrade with databases' larger than 100GBs without the need for manual intervention.
Getting ready
Archive Shuttle recommends that, whenever possible, you perform the upgrade in a lab environment first. This gives you some familiarity of the upgrade process and allows you to fine-tune the upgrade steps to suit the particular customer, environment, policies, and procedures.
Having access to a lab environment also enables the exploration of the new features that are delivered in the newer version of Archive Shuttle. More information relating to the new features is available in the Release Notes and the Revision Notes.
Before starting the upgrade, it is essential to have the following:
·New Archive Shuttle x.x Core MSI
·New Archive Shuttle x.x Modules MSI
·Access to the username/passwords used during the installation for the Archive Shuttle Core and Modules
|
|
NOTE: Any username used during the original installation is remembered. However, the password must be re-entered. |
In order for the upgrade to succeed, Archive Shuttle recommends that there is sufficient free space on the SQL server locations for both the database and log files. The space available should be as follows:
|
Database/Log |
Space |
|---|---|
|
Archive Shuttle Directory |
2x current size of database |
|
Archive Shuttle Directory Logs |
1x current size of log file |
|
Archive Shuttle Item Database |
2x current size of database |
|
Archive Shuttle Item Database Logs |
1x current size of log file |
Sufficient time should also be allocated to the upgrade. Upgrading a large Archive Shuttle Item Database can take several hours. Archive Shuttle recommends you monitor the Core log files after deployment to verify the process has completed when working with large deployments.
If a problem is encountered when upgrading the Archive Shuttle database, there are manual steps that can be performed to resume the upgrade. These are available from Quest Support.
Performing the upgrade
Archive Shuttle recommends that you to perform the upgrade on the Archive Shuttle environment when migration activity is not actively running. Prior to performing the steps below, Archive Shuttle recommends that you disable the Archive Shuttle modules that have been deployed and then allow some time to pass for the modules to complete their queued work before proceeding.
Archive Shuttle also advises you to review the Archive Shuttle Dashboard. If the needles on the activity gauges are showing 0, then exports and imports are not currently running. Other background activity might still be in progress, so it is advised to perform the step of disabling the modules and reviewing the module log files to ensure work has stopped.
The following steps should be performed in order to upgrade the environment:
1.Stop the Archive Shuttle Modules on all servers.
2.Stop the Archive Shuttle Core service on the Archive Shuttle Core Server.
3.Perform a full SQL database backup of:
·Archive Shuttle Directory Database, and
·Every Archive Shuttle Item Database
4.Run the new Archive Shuttle xx.x Core MSI on the Archive Shuttle Core Server.
5.Verify that the installation/upgrade completes without errors. When the installation has been completed, open the Archive Shuttle Admin Interface and navigate to some of the pages.
6.Run the Archive Shuttle xx.x Module MSI on each server which have modules installed.
|
|
NOTEs: 1.If the migration target is Exchange or Office 365 and the server running the ingestion module is Windows 2008 R2, there is an additional Microsoft component to install. 2.If the Office 365 Leavers functionality is to be used within Archive Shuttle, then there are additional requirements described in this link. 3.For the Office 365 module to process licensing for Leavers, the PowerShell execution policy needs to be set to RemoteSigned or Unrestricted. Verify that the installation/upgrade completes without errors. After the installation the Archive Shuttle modules page in the Admin Interface should show all modules without a red background. This indicates that they are properly communicating with the Archive Shuttle Core. 4.If any changes have been made with regards to the logging levels for the Archive Shuttle Core or Modules, those changes will need to be implemented again once the upgrade has completed. |
When the upgrade has been completed, perform the following post upgrade checks and ensure the step relating to Environment Sync is performed.
Post upgrade checks
Following the installation and upgrade of the migration environment, verify the upgrade by performing the followings tasks:
1.Open the Archive Shuttle administration page, and verify that the page opens without errors.
2.Verify the build number in the lower left hand corner of the administration page. It should be: XX.X.X.NNNNN (NNNNN will be five digits indicating the exact build number)
3.Go to the EV Environment page, and perform a Sync All EV Environments operation. This will take a few minutes to run, and is an essential post-upgrade step.
4.Open the Modules page from the Archive Shuttle administration page, and verify that all of the modules are accessible (none should show red, indicating that the Archive Shuttle Core has had issues contacting the module).
5.Verify that all the Archive Shuttle services are started using the Windows Service Control Manager on each server in the environment.
6.In each of the Archive Shuttle databases (Directory Database, and each Item Database) there is a table called SchemaVersion. The versions reported should be as follows:
·Archive Shuttle Directory Database: xx.x.0.0
·Archive Shuttle Item Database: xx.x.0.0
|
|
NOTE: If the SchemaVersion tables do not show these versions, contact Quest Support. Archive Shuttle also recommends that you perform another full database backup prior to using Archive Shuttle for further archive migrations. |
Uninstalling Archive Shuttle
To uninstall Archive Shuttle:
1.From Windows Control Panel, select Programs.
2.Select Uninstall a program.
3.From the list of programs, select Quadrotech Archive Shuttle 64-bit.
|
|
NOTE: The uninstaller does not delete any data or databases. |
About Us
Quest creates software solutions that make the benefits of new technology real in an increasingly complex IT landscape. From database and systems management, to Active Directory and Office 365 management, and cyber security resilience, Quest helps customers solve their next IT challenge now. Around the globe, more than 130,000 companies and 95% of the Fortune 500 count on Quest to deliver proactive management and monitoring for the next enterprise initiative, find the next solution for complex Microsoft challenges and stay ahead of the next threat. Quest Software. Where next meets now. For more information, visit www.quest.com.
Contacting Quest
For sales or other inquiries, visit www.quest.com/contact.
Technical Support Resources
Technical support is available to Quest customers with a valid maintenance contract and customers who have trial versions. You can access the Quest Support Portal at https://support.quest.com. The Support Portal provides self-help tools you can use to solve problems quickly and independently, 24 hours a day, 365 days a year. The Support Portal enables you to:
·Submit and manage a Service Request
·View Knowledge Base articles
·Sign up for product notifications
·Download software and technical documentation
·View how-to videos
·Engage in community discussions
·Chat with support engineers online
·View services to assist you with your product