Difference between revisions of "AquilaServer Upgrade Instructions"

From EHS Help
Jump to: navigation, search
m
(Page updated to reflect new release & new recovery procedures)
Line 1: Line 1:
 
{{ProductTopic|Technical (IT)|Instructions}}
 
{{ProductTopic|Technical (IT)|Instructions}}
  
==Instructions==
+
==Overview==
 
+
  
 
* Any existing AquilaServer must be installed and working correctly.  It should not be uninstalled.
 
* Any existing AquilaServer must be installed and working correctly.  It should not be uninstalled.
Line 8: Line 7:
 
* Backup the IBID database to provide fall-back in the event of a failure.  (Installations for older versions of the server are readily available, should a major roll-back be required).
 
* Backup the IBID database to provide fall-back in the event of a failure.  (Installations for older versions of the server are readily available, should a major roll-back be required).
 
* On the machine where AquilaServer is currently installed, run the file AquilaServer_N.N_upgrade_32-bit.exe
 
* On the machine where AquilaServer is currently installed, run the file AquilaServer_N.N_upgrade_32-bit.exe
 +
* Upgrade each client as necessary
 +
* See also [[Aquila Server Configuration]]
  
See also [[Aquila Server Configuration]]
+
==Installation==
  
Download the AquilaServer upgrade from here: [https://www.evolutionhealthcaresystems.co.uk/downloads www.evolutionhealthcaresystems.co.uk/downloads]  (login required)
+
* Download the AquilaServer upgrade from here: [https://www.evolutionhealthcaresystems.co.uk/downloads/#aquila-upgrade www.evolutionhealthcaresystems.co.uk/downloads]  (login required)
 
+
* Run the upgrade app and check the introductory screens & ensure your system meets any new minimum system requirements if presented.
Introductory screens: please read & ensure your system meets the requirements.
+
* During the file replacement stage, the server will be unavailable to end users.
  
 
<!-- [[File:AqServerUpgrade 1.png]] -->
 
<!-- [[File:AqServerUpgrade 1.png]] -->
 
 
<!-- [[File:AqServerUpgrade 2.png]] -->
 
<!-- [[File:AqServerUpgrade 2.png]] -->
 
 
[[File:AqServerUpgrade 3.png]]
 
[[File:AqServerUpgrade 3.png]]
  
Server is stopped, files are replaced, server is restarted:
+
* AquilaServer is stopped, files are replaced and AquilaServer is restarted (2-3 minutes):
  
 
[[File:AqServerUpgrade 4.png]]
 
[[File:AqServerUpgrade 4.png]]
  
Database upgrade starts (this may take 5-10 minutes):
+
* Database upgrade starts (5-10 minutes):
  
 
[[File:AqServerUpgrade 5.png]]
 
[[File:AqServerUpgrade 5.png]]
  
Database upgrade completed:
+
* '''CAUTION''': If there are any issues with the database upgrade, they will appear here
 +
** Do not proceed with the installation
 +
** Report any issues to the help desk immediately on 01964 503400 or see [[Getting support]]
  
[[File:AqServerUpgrade 6.png]]
+
== Analysis Recalculations ==
  
Notice the new version number (in this case 39.0) and the number of changes made (1).   If this doesn't happen, something may have gone wrong, please [[Getting support|Get in Touch]].
+
* If the Aquila Server upgrade is a major upgrade then following the database upgrade the internal calculated analysis data may be recalculated to reflect any changes in the formula.
 +
* These recalculations will take some time, depending on the amount of data, hardware specifications, etc.  
 +
* The system is available whilst these calculations are running, although users may perceive a slight performance hit.  Depending on your available resources, you may prefer to wait until this has completed.
  
The '''IBID analysis calculations''' are now started and will take some time, depending on the amount of data, hardware specifications, etc. ''The application is available whilst this is running''.
+
[[File:AqServerUpgrade 6.png]]
  
 
When the calculations are completed, the upgrade is complete.
 
When the calculations are completed, the upgrade is complete.
Line 46: Line 49:
 
In the event of a problem during the server upgrade, the roll-back process is as follows:
 
In the event of a problem during the server upgrade, the roll-back process is as follows:
  
* Contact EHS who will be able to supply files for the previous version of AquilaServer.
+
1) Contact EHS who will be able to supply files for the previous version of AquilaServer.
* Replace the file on your system with those provided by EHS.
+
2) Use the [[Aquila Server Configuration]] tool to make a careful note of your settings.
* Ensure the AquilaServer process is not running, either via the Services control panel app, or via the command prompt with "net stop AquilaServer".
+
3) Uninstall the AquilaServer product
* Restore the database from the backup taken immediately before the upgrade process.
+
4) Restore the database from the backup taken immediately before the upgrade process.
* Start the AquilaServer process again, either via the Services control panel app, or via the command prompt with "net start AquilaServer".
+
5) Install the previous version of AquilaServer as supplied, using the settings you noted in step 2.
 
+
== Notes ==
+
  
* Replacing the necessary files & upgrading the database takes 5-10 minutese; during which time the application will be '''unavailable'''.
 
* The iBID recalculations will take between 1-4 hours depending on the size of your iBID database.  The application will be '''available''' during this time.
 
* The upgrade also re-calculates the analysis data in the database in order to implement new and changed formulae for the national reports, dashboard reports etc.  During the analysis re-calculation, the system will be available to end-users, however performance may be affected slightly.
 
  
 
==Support==
 
==Support==
  
 
See [[Getting support]]
 
See [[Getting support]]

Revision as of 10:15, 22 May 2018

This is a Technical (IT) Instructions topic

Overview

  • Any existing AquilaServer must be installed and working correctly. It should not be uninstalled.
  • All users should ideally be off the system.
  • Backup the IBID database to provide fall-back in the event of a failure. (Installations for older versions of the server are readily available, should a major roll-back be required).
  • On the machine where AquilaServer is currently installed, run the file AquilaServer_N.N_upgrade_32-bit.exe
  • Upgrade each client as necessary
  • See also Aquila Server Configuration

Installation

  • Download the AquilaServer upgrade from here: www.evolutionhealthcaresystems.co.uk/downloads (login required)
  • Run the upgrade app and check the introductory screens & ensure your system meets any new minimum system requirements if presented.
  • During the file replacement stage, the server will be unavailable to end users.

AqServerUpgrade 3.png

  • AquilaServer is stopped, files are replaced and AquilaServer is restarted (2-3 minutes):

AqServerUpgrade 4.png

  • Database upgrade starts (5-10 minutes):

AqServerUpgrade 5.png

  • CAUTION: If there are any issues with the database upgrade, they will appear here
    • Do not proceed with the installation
    • Report any issues to the help desk immediately on 01964 503400 or see Getting support

Analysis Recalculations

  • If the Aquila Server upgrade is a major upgrade then following the database upgrade the internal calculated analysis data may be recalculated to reflect any changes in the formula.
  • These recalculations will take some time, depending on the amount of data, hardware specifications, etc.
  • The system is available whilst these calculations are running, although users may perceive a slight performance hit. Depending on your available resources, you may prefer to wait until this has completed.

AqServerUpgrade 6.png

When the calculations are completed, the upgrade is complete.

AqServerUpgrade 7.png


Rollback

In the event of a problem during the server upgrade, the roll-back process is as follows:

1) Contact EHS who will be able to supply files for the previous version of AquilaServer. 2) Use the Aquila Server Configuration tool to make a careful note of your settings. 3) Uninstall the AquilaServer product 4) Restore the database from the backup taken immediately before the upgrade process. 5) Install the previous version of AquilaServer as supplied, using the settings you noted in step 2.


Support

See Getting support