The following is a checklist for existing users upgrading to the 2.4 release and is aimed at both the person doing the upgrade and the administrators responsible for systems operations.
It provides a list of things that you may need to do in order to take advantages of the new features in this release.
OpenVPMS now requires two MySQL users when connecting to the database; a read/write user (default
'openvpms'), and a read-only user (default 'openvpmsreport').
These can be configured running:
The <admin-user> argument is a MySQL user with administration privileges.
The read/write user can also no longer be used for the toolbox database --update command. This requires a MySQL user with administration privileges, specified using the new -u argument:
toolbox database --update -u <admin-user> -p
If OpenVPMS is hosted behind a proxy or load balancer, Tomcat needs to be configured to pass the correct client IP addresses through.
See Tomcat Configuration for details.
The following document templates were updated:
Updated to use the Logo from Letterhead, and to support long practice names.
See OVPMS-2520, OVPMS-2913
Updated to insert the clinician signature if present.
See OVPMS-2605.
Updated to include the product Printed Description, if present.
See OVPMS-2860
For sites using standard templates, these can be loaded using:
toolbox template --load documents --size <size>
where <size> may be A4, A5 or Letter. This will load all document templates, so should not be run on sites that customise these. Sites that customise these should refer to the above for the changes required.
Alternatively, templates can be loaded separately, using the following commands:
toolbox template --load 'Letterhead' --size <size> toolbox template --load 'Letterhead-A5' -size <size> toolbox template --load 'Desexing Certificate' -size <size> toolbox template --load 'Microchip Certificate' -size <size> toolbox template --load 'Prescription External' -size <size> toolbox template --load 'Rabies Vaccination Certificate' -size <size> toolbox template --load 'Referral Letter' -size <size> toolbox template --load 'Vaccination Certificate' -size <size> toolbox template --load 'Prescription' -size <size> toolbox template --load 'Invoice Items' -size <size> toolbox template --load 'Invoice Items-PT' -size <size> toolbox template --load 'Estimate Items' -size <size> toolbox template --load 'Estimate Items-PT' -size <size> toolbox template --load 'Customer Grouped Email Reminder' -size <size> toolbox template --load 'Customer Base Email' -size <size> toolbox template --load 'Customer Invoice Email' -size <size> toolbox template --load 'Customer Receipt Email' -size <size> toolbox template --load 'Customer Refund Email' -size <size> toolbox template --load 'Customer Statement Email' -size <size> toolbox template --load 'Patient Base Email' -size <size> toolbox template --load 'Patient Estimate Email' -size <size> toolbox template --load 'Patient Owner History Email' -size <size> toolbox template --load 'Patient Referral History Email' -size <size> toolbox template --load 'Euthanasia Consent' -size <size> toolbox template --load 'Surgical Admission' -size <size> toolbox template --load 'Vaccination Certificate (Reminders)' -size <size> toolbox template --load 'Patient Grouped Email Reminder' -size <size> toolbox template --load 'Patient Last Dose Products Email Reminder' -size <size> toolbox template --load 'Patient Next Dose Products Email Reminder' -size <size> toolbox template --load 'Patient Products or Reminder Type Name Email Reminder' -size <size> toolbox template --load 'Patient Single Collection Email Reminder' -size <size> toolbox template --load 'Patient Single Email Reminder' -size <size> toolbox template --load 'Customer Grouped Reminder' -size <size> toolbox template --load 'Patient Collection Overdue Reminder' -size <size> toolbox template --load 'Patient Collection Reminder' -size <size> toolbox template --load 'Patient Desexing Reminder' -size <size> toolbox template --load 'Patient Grouped Reminder' -size <size> toolbox template --load 'Patient Single Overdue Reminder' -size <size> toolbox template --load 'Patient Single Reminder' -size <size> toolbox template --load 'Statement' -size <size> toolbox template --load 'Fit to Fly Certificate' --size <size> toolbox template --load 'Investigation' 'Investigation Results' 'Investigation Result Items' 'Investigation Images' --size <size>
The following reports were updated:
For sites using standard templates, these can be loaded using:
toolbox template --load reports --size <size>
where <size> may be A4, or Letter. This will load all report templates, so should not be run on sites that customise these. Sites that customise these should refer to the above links for the changes required.
Alternatively, templates can be loaded separately, using the following commands:
toolbox template --load 'Practice Sum. Poduct Sales by Location' --size <size> toolbox template --load 'Practice Sum. Poduct Sales by Type' --size <size> toolbox template --load 'Customer Sales Report' --size <size> toolbox template --load 'Stock Movement Report' --size <size> toolbox template --load 'Stock Valuation Report' --size <size> toolbox template --load 'Customer Discount Report' --size <size> toolbox template --load 'Practice Sum. Count Appointments by Clinician' --size <size> toolbox template --load 'Practice Sum. Count Appointments by Type' --size <size> toolbox template --load 'Restricted Drug Sales Report' --size <size> toolbox template --load 'PetSure Pre-Approval' --size A4 toolbox template --load 'PetSure GapOnly Pre-Approval' --size A4 toolbox template --load --size A4 'Customer Product Sales Report'
OpenOffice no longer needs to be specified in the system PATH, and will be located using the default installation path. If there are multiple installations, or OpenOffice is installed in a non-standard directory, the installation path should be configured via Administration - System - OpenOffice.
For improved security, new passwords must conform to a practice wide Password Policy.
To ensure existing passwords are updated, use the toolbox user --force-password-change --all command to force users to update their passwords when they next login.
Administrators are required to change their passwords when upgrading.
The Max Duration field of Schedules should be set to in order to improve response times in Workflow - Scheduling.
For day schedules, Max Duration should be no longer than 24 hours. For boarding schedules, it should be no greater than the maximum boarding period.