|
Upgrading from Official Releases |
  
|
|
Upgrading from Official Releases |
|
Introduction
The ImageServer supports upgrading between official software releases. The 2.0 ImageServer installer can upgrade from any prior official release. For instance, the installer can upgrade the 1.3 software to the 2.0 software.
Upgrade Procedure
The following steps summarize the method for upgrading between official releases:
Leave the Prior Version on the System
The prior version of the ImageServer software must be left on the system. The installer will automatically remove the prior version during upgrade.
Process Pending Study Integrity Queue Items and WorkQueue Reconcile Entries
There were several changes in the way Study Integrity Queue items are processed in the 2.0 version of the ImageServer. Although we have made efforts to still be able to process Study Integrity Queue entries in 2.0 that were generated in prior versions, it is recommended that any Study Integrity Queue entries from prior releases be processed before upgrading.
It is also recommended that Reconcile entries in the WorkQueue be processed before upgrading. As a general practice, it is desirable for WorkQueue to be empty before upgrading, although this is not a necessity.
Shutdown the ShredHostService
It is highly recommended that the ImageServer's ShredHostService be shutdown (using the Windows services.msc utility) before backing up the database and launching the upgrade. It is important to ensure no activity is occurring within the ShredHostService while the upgrade is being conducted. It is also recommended that all connections to the web interface be stopped.
Backup the Database
It is highly recommended that a complete backup of the database be done before installation of the new release.
| • | To backup the database with SQL Server 2008 Management Console, see this article from Microsoft. |
| • | To backup the database with SQL Server 2005 Management Console, see this article from Microsoft. |
Launch the Installer
Launch the new installer and follow the steps outlined by the installer. The installer will automatically detect the previous installation and uninstall it. It will then automatically upgrade the database schema and install the new version of the software. Feedback will be given in the GUI as the database is being upgraded.
Notes on Upgrading from Version 1.3 (PLEASE READ THIS!)
| • | IMPORTANT: When the 2.0 (or 1.5) installer is run, it will automatically try and uninstall 1.3. During the 1.3 uninstall, you will be asked if you want to remove the database. Make sure you click NO, otherwise the upgrade will not work properly. |
| • | Several bugs were found after the release of the 1.3 ImageServer software with how the Study XML files were created. If streaming is being used with the ImageServer, it is recommended that the Study XML files be rebuilt. A new Service Scheduling service was introduced in the 1.5 ImageServer release to rebuild the Study XML files on a filesystem. |