This guide refers to the Upgrading of version 3.x
- Copy BlackfordPlatformInstaller-Release-x64.msi to a suitable location on windows server
- Stop Blackford Platform service in Task Manager
- Archive previous Blackford Platform folder C:\Program Files\Blackford Analysis\Blackford Platform > C:\Program Files\Blackford Analysis\Blackford Platform Archive\<release version. Commit number>
- When folder is archived, ensure the following folder is deleted C:\Program Files\Blackford Analysis\Blackford Platform. As the upgrade will create a new folder.
- Create RunRecord.txt file and include details of the upgrade. Save file to C:\Program Files\Blackford Analysis\RunRecord.txt
- Run BlackfordPlatformInstaller-Release-x64.msi
- Review all file extensions in the newly created C:\Program Files\Blackford Analysis\Blackford Platform folder. Some may have generated incorrect file extensions like studyconfiguration.xml.3.21.6 rename these to .xml
- Open BlackfordPlatformSettingsEditor.exe (run as administrator)
- Configure the settings editor with the same information in the previous platform version (you can find this in the archive folder). Note: due to it being an upgrade some settings may have been added/removed. Save settings editor when complete
- You will need Telemetry details from the Dashboard to add in to the Logging and Telemetry section of the Settings Editor, these can be provided upon request
- Restart Blackford Platform service in Task Manager
- If the Platform service fails to start then check the Windows Event Viewer > Windows Logs > Application and review the error.
Post-Upgrade Checks
- Platform restarts successfully
- Check logs and ensure no platform/clinapp/docker errors
- Check telemetry and dashboard information is correct