Critical Dates this cycle:
- 1st July 2022 - Canada Day (Canada)
- 4th July 2022 - Independence Day (US)
- 11th - 15th July 2022 - Prague All Staff Meeting (including travel time)
Date | Time | Responsibility | Deliverables | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 18.00 | SI Content Release Lead | Authoring begins for | February July 2022 International release. | Request update Update for root concept synonym. Check for and request updates to validation to align with large scale changes to content development (e.g. axiom, GCI, concrete domains etc). SI Content Release Lead to check Daily Build RVF report daily to ensure no failures in the "Traceability Service" assertion(s). These will provide advanced notice of the type of failures we currently don't find until Release time (items missing from the RF2 manifest, package formatting issues, etc), so that they can be fixed well before the release. | |||||||||||
Feb | 12:00 | SI Devops Team | Setup new automated JIRA tickets to be generated from the parent International Release ticket, for all Mapping steps below (both internal and external)03 Feb | |||||||||||||
| 12:00 | SI Content Release Lead | No further batch loads or bulk updates. No further promotion for projects that have large scale changes for example promotion from the Community Content or changes to foundational hierarchies likely to have impact across other content. Cross check that all MRCM changes have been made and the associated content changes completed (i.e. no MRCM errors on Main). No further changes to MRCM. | |||||||||||||
| 17:00 | SI Release Manager | Verify with Content Release Lead any new moduleDependency/RefsetDescriptor records required for this cycle... | Create the module dependency records for the next release. |
| |||||||||||
| 17 | 09:00 | SI | ContentRelease | LeadNotify Content Team about forthcoming release close and aim to complete project promotion in advance of cut off to prevent last minute issues for the Mapping Team. | Manager |
| |||||||||
09:00 | SI Content Release Lead | Notify Content Team about forthcoming release close and aim to complete project promotion in advance of cut off to prevent last minute issues for the Mapping Team. | ||||||||||||||
12:00 | SI Content Team | Suzanne SantamariaFarzaneh Ashrafito conduct Preliminary content review for conflict with LOINC agreement. LOINC tasks to | 14.00 | SI Content Team | be promoted in LOINC project (where applicable) before content versioning. LOINC project to be promoted to parent- code system Farzaneh Ashrafi and Suzanne Santamaria | 13 Feb |||||||||||
| 1214:00 | SI | Content Release Team | Initial handover meeting - once all signed off, full validation of initial content + fixing of all issues that it is possible to resolve before versioning. | ||||||||||||
12:00 | SI Content Release Lead | Last day for the Content | LeadLast day for the Content team to promote any changes intended for release in the current editing cycle. 12.00 UTC - CONTENT CUT OFF - Final project promotion Content team may continue to author after final project promotion and until the authoring platform is under maintenance window, but must not delete any new concepts or components that have already been promoted for the | February July 2022 release. No project promotion until further notice. | ||||||||||||
14 Feb | 00:01 - 05:00 | WCI |
| |||||||||||||
09:00 | SI Mapping Team | Mapping team to finalise any mapping from the final content promotion after the 12:00 content cut off previous day (or any issues identified during the Mapping Server validation process), and then Resolve their "Mapping Complete" ticket to confirm that "Mapping QA complete". NB: this is using the content from yesterday's final promotion cut off at 12:00, as the Daily Build feed then ran at 01:00 | 14 Feb ||||||||||||||
09:00 | SI Content Release Lead | Submit INFRA ticket for project promotion to be disabled in the authoring platform until further notice. Final content review and validation in the current release branch:
| ||||||||||||||
| 09:00 | SI Release Manager | Check that SEP + lateralizable refset generation process has been run before kicking off test build(s). | 14 Feb |||||||||||||
| 11:00 | SI Release Team | Initial handover meeting - once all signed off, full validation of initial content + fixing of all issues that it is possible to resolve before versioning. |
| 12:00 | SI Release Manager | Update the devops Report ticket with the relevant 2x release packages so there's no confusion (eg) |
Jira | ||||||
---|---|---|---|---|---|---|
|
SI Mapping Team
12:00 - MAPPING CUTOFF (This is using the content from last night's Daily Build feed (run at 01:00))
SI Content Release Lead
SI Content Release Lead to create 2x new tasks in authoring platform project 'Release mapping upload project', to accept the upload of the new Map files Delta's (one for SimpleMap + one for ExtendedMap delta files).
SI Content Release Lead to email the 2x new tasks to WCI (Rick Wood+ Deborah Shapiro + support-si@westcoastinformatics.com) for use in the map uploads.
14 Feb
12:00
Manual/automated backup of Mapping Server IF CHANGES were made to maps this morning - Chris Morristo automate when possibleDonna Morgan to confirm...
14 Feb
WCI
- 13:00 - Mapping Server is Cloned over to the Release Mapping Server (can be done immediately after the backup is complete if WCI can automate this?). FYI This is only necessary if there are definable risks of the Content changing between now and the Published Production release at the end of the month
- 15:00 - WCI generate ICD-0 + ICD-10 map files and QA reports checked
- Potential for some discussion with Donna if any red flags in these reports...
- 16:00 - WCI send ICD-0 + ICD-10 FINAL map files to SI Release manager before close of play
- 16:00 - WCI upload ICD-0 + ICD-10 FINAL map files (with BLANK EFFECTIVETIMES) to the termserver, using the RF2 Swagger upload process
- 16:30 - WCI to confirm to SI Content Release Lead + SI Release Manager that map upload is complete and validation can continue.
- 16:30 - SI Content Release Lead to validate + promote the two Map file tasks to MAIN
- Backup plan: If there is a Critical (P1) issue found in the final content (shouldn't be due to the new task/project validation, but we need an emergency process just in case), then WCI can import a specific fix branch straight into the Cloned Release Mapping Server, without bleed through from the next month's content. However, this should only be used in the genuine emergency situations...
SI Content Team
Suzanne SantamariaFarzaneh Ashrafito conduct final content review for conflict with LOINC agreement.
For the first few releases the SI Release Manager should run an initial full Release against the UN-VERSIONED content, to ensure no failures in the "Traceability Service" assertion(s) in the RVF report. These will provide advanced notice of the type of failures we currently don't find until Release time (items missing from the RF2 manifest, package formatting issues, etc), so that they can be fixed well before the release.
Versioning to proceed once SI Release Manager confirms that there are no Critical issues in this build.
***** NOTE there will be some false positives in the new Traceability Assertions (assertionUuid: "b7f727d7-9226-4eef-9a7e-47a8580f6e7a") until the map files can be finalised and uploaded to the termserver (see below) the number of failures should exactly match the number of records across BOTH map file delta's - so if this is the case these can be ignored until the map files are uploaded to the termserver in a few days...
SI Devops Team
If any Critical fixes have been required, we need to:
- Push them back through to MAIN before versioning
- Re-run the Daily Build manually in order to ensure that the Mapping Server picks up the latest version
SI Release Team
SI Devops Team
Technical team release tasks (as and when initial validation is signed off at each milestone)
- *** Maintenance screen to be raised in Production ***
- termServer branching and Release versioning (DevOps to raise tickets themselves as per Terance's request)
- Snapshot used to provisionally bring the AP validation etc back up again today, so that it works for the interim period until the new Production release package is signed off tomorrow (on the 16 Nov this cycle)...
- Provisional date to drop Maintenance & re-open Content authoring for next editing cycle - providing no Critical issues identified...
- *** Maintenance screen to be lifted in Production ***
Once authors confirm Editing has re-commenced:
- run the test upload into Dev browser to ensure no issues.
- re-configure the Daily Build + Daily Build browser to work in the next Editing cycle -
Performing this step early allows the daily build to report on the next monthly release content, for both authoring validation and external use. New unreleased content will hidden in the main browser until the effectivetime. If any content has to be removed due to urgent issues we will need to back-out and reimport the International data.
- Reminder to WCI to cut off mapping drip feed (but NOT clone over to Release Server until Mapping Team confirms that both ICD-0/ICD-10 + GMDN maps are all updated based on Content + latest GMDN content.
SI Release Manager
New versioned Release Build (including both ICD-0 + ICD-10 maps from termServer) is created and validated by SI Release Manager
***** MANIFEST CHANGED TO PULL MAP FILE DATA FROM SNOWSTORM INSTEAD OF EXTERNALLYMAINTAINED FOLDERS ******
SI Release & Devops teams
Once Final, versioned Release Build is signed off by SI Release Manager, it is handed over to DevOps to update the Daily Build, plus all AP validations, etc
As this can take a few days (depending on when the weekends fall this cycle, etc), in the interim DevOps will use the provisional Snapshot release from the versioning process in order to ensure minimal downtime for these services.
*******************************************************************************************************************************************
SI Devops Team
If any Critical fixes have been required, we need to:
- Push them back through to MAIN before versioning
- Re-run the Daily Build manually in order to ensure that the Mapping Server picks up the latest version
SI Release Team
SI Devops Team
Technical team release tasks (as and when initial validation is signed off at each milestone)
- *** Maintenance screen to be raised in Production ***
- termServer branching and Release versioning (DevOps to raise tickets themselves as per Terance's request)
- Snapshot used to provisionally bring the AP validation etc back up again today, so that it works for the interim period until the new Production release package is signed off tomorrow (on the 16 Nov this cycle)...
- Provisional date to drop Maintenance & re-open Content authoring for next editing cycle - providing no Critical issues identified...
- *** Maintenance screen to be lifted in Production ***
Once authors confirm Editing has re-commenced:
- run the test upload into Dev browser to ensure no issues.
- re-configure the Daily Build + Daily Build browser to work in the next Editing cycle -
Performing this step early allows the daily build to report on the next monthly release content, for both authoring validation and external use. New unreleased content will hidden in the main browser until the effectivetime. If any content has to be removed due to urgent issues we will need to back-out and reimport the International data.
- Reminder to WCI to cut off mapping drip feed (but NOT clone over to Release Server until Mapping Team confirms that both ICD-0/ICD-10 + GMDN maps are all updated based on Content + latest GMDN content.
SI Release Manager
New versioned Release Build (including both ICD-0 + ICD-10 maps from termServer) is created and validated by SI Release Manager
*******************************************************************************************************************************************
THIS BUILD MUST BE DONE WITH x PREFIXES REMOVED + USING PRODUCTION NAMING CONVENTIONS SO DEVOPS CAN USE IT
*******************************************************************************************************************************************
***** MANIFEST CHANGED TO PULL MAP FILE DATA FROM SNOWSTORM INSTEAD OF EXTERNALLYMAINTAINED FOLDERS ******
SI Release & Devops teams
Once Final, versioned Release Build is signed off by SI Release Manager, it is handed over to DevOps to update the Daily Build, plus all AP validations, etc
As this can take a few days (depending on when the weekends fall this cycle, etc), in the interim DevOps will use the provisional Snapshot release from the versioning process in order to ensure minimal downtime for these services.
SI Content Release Lead
Approximately 18.00 UTC - AUTHORING + MAPPING RE-COMMENCE
Restart content editing for the next release cycle in the new release branch on authoring platform.
Project promotion is also clear to commence from this point onwards.
Maria BraithwaiteSEND NOTICE to Content team members - all existing tasks must be rebased to prevent problems with the classification (until we can automate all rebases then rebasing the tasks is also needed. Dev Ops will still rebase all projects each release).
Mapping Drip Feed switched back on (but mapping tool will not be back up to date until first drip feed run later tonight).
JULY RELEASES ONLY!
After the versioned branch is proven valid and complete, we should then update the Refset tool with the versioned branch, in order to allow all of the authors to start the migrations a bit early, rather than waiting until 1st August.
- So you need to copy the versioned branch, and update the "Terminology Path" field in EACH relevant refset config in the Refset Tool:
- Then, you need to send an email to ALL relevant authors and remind them to CHECK the path is still the Versioned branch when migrating:
- If there are then subsequently any critical changes necessary to the July INT Edition release, we will need to:
- Delete each of the BETA releases in the refset tool that were migrated against the mid-July early version of the INT Edition
- Update the Terminology Path field in each relevant refset config to the new, updated INT Edition branch (for the FINAL July 31st release)
- Re-migrate all of the refsets against the new branch from 1st August onwards, and use those refsets instead for the final releases.
SI Content Release Lead
Approximately 18.00 UTC - AUTHORING + MAPPING RE-COMMENCE
Restart content editing for the next release cycle in the new release branch on authoring platform.
Project promotion is also clear to commence from this point onwards.
Maria BraithwaiteSEND NOTICE to Content team members - all existing tasks must be rebased to prevent problems with the classification (until we can automate all rebases then rebasing the tasks is also needed. Dev Ops will still rebase all projects each release).
Mapping Drip Feed switched back on (but mapping tool will not be back up to date until first drip feed run later tonight).
16 Feb
WCI (AUTOMATED)
- 01:00 - Daily Build first run after Versioning
- 02:00 - Mapping Drip feed first run after Versioning - WCI to inform SI Mapping Team that they can re-commence mapping
SI Release Manager
SI Mapping Team
WCI
-
SI Release Manager
SI Content Release Lead
Full manual + automated validation of the versioned content.
Lateralizable and SEP ref sets. (BUT ONLY IF NEW AUTOMATION OF THESE REFSETS IS STILL NOT YET AVAILABLE).
-
09:00
SI Content + Mapping Teams
Preparation of release notes.
SI Content Release
Lead
Full manual + automated validation of the versioned content.
Lateralizable and SEP ref sets. (BUT ONLY IF NEW AUTOMATION OF THESE REFSETS IS STILL NOT YET AVAILABLE).
-
Build final Production release for July 2022
Run full regression testing and fix any subsequent issues.
Preparation of release notes.
SI
Release
-
Build final Production release for February 2022
Run full regression testing and fix any subsequent issues.
Manager
SI Release Manager
PRODUCTION RELEASE to community
- Include full comms to explain process + package changes due to Frequent Delivery
- Confirm how the standard Monthly releases will look from this point onwards
- Include notes that Delta Generation Tool is available to use if they'd like
Mar
Once Release Manager confirms Production release is published:
- Update all Production systems (authoring platform, browser) using the final S3 published package.
- This needs to include the new Release Stats page in the browser (https://browser.ihtsdotools.org/qa/#/descriptive-statistics), which can be updated using step 7 ("If this is the final INT release we need to also update the Stats") in these instructions: https://confluence.ihtsdotools.org/display/DEVOPS/Browser+Release+Updates
- NOTE: For the initial soft launch Releases this will just be tested in Dev/Uat browser rather than Prod to avoid confusing users
- From September 2020 ensure that the GPS ValueSet is available through the FHIR API ie https://browser.ihtsdotools.org/fhir/ValueSet/gps
- Update both the:
- Release Stats Summary Report:
- Individual Release Stats Report:
- Check this through with Peter as likely unnecessary now with new reports...
...