...
| Team | Stakeholders to notify |
|---|---|
| SI Release Manager | |
| SI Content Release Lead | |
| SI Devops Team | |
| SI Content Team | |
| SI Mapping Team | |
| WCI |
Critical Dates this cycle:
- 2nd May 2022: May Day holiday (UK)
- 30th May 2022: Memorial Day (US)
...
...
SI Content Release Lead
...
Authoring begins for May 2022 International release.
Request 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.
...
...
...
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.
...
...
Verify with Content Release Lead any new moduleDependency/RefsetDescriptor records required for this cycle...
- Validate automatically generated moduleDependency/RefsetDescriptor records for this release, AND IF ANY ISSUES:
- Create the moduleDependency/RefsetDescriptor records for this release
...
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.
...
...
Suzanne SantamariaFarzaneh Ashrafito conduct Preliminary content review for conflict with LOINC agreement.
LOINC tasks to be promoted in LOINC project (where applicable) before content versioning.
LOINC project to be promoted to parent- code system Farzaneh Ashrafi and Suzanne Santamaria
...
...
SI Content Release Lead
...
Last 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 May 2022 release.
No project promotion until further notice.
...
...
WCI
...
- 00:00 - WCI to SUSPEND DRIP FEED FOR TONIGHT AND TOMORROW NIGHT
- 02:00 (or immediately after the Daily Build/Snapshot provided by DevOps post-versioning is available if Rick Wood can automate this?) - WCI to completely remove SNOMED from the Mapping Server + upload the latest version.
- 03:00 - WCI to validate the Release Mapping Server
- 04:00 - WCI to lift maintenance window and allow Mapping Team to access other projects ONLY (GMDN, MedDRA, etc)
...
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
...
...
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:
- Confirm root concept has been updated.
- Review RVF report.
- Review MRCM report.
- Check the exceptions list for all components listed during the current release cycle.
- Run all reporting platform release validation reports, save link to reports.
- Run all reporting platform release statistic reports, save link to reports.
- Spell check/ check descriptions file for inaccuracies or typos.
...
...
Check that SEP + lateralizable refset generation process has been run before kicking off test build(s).
...
...
SI Release Team
...
...
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.
...
...
12:00
...
Manual/automated backup of Mapping Server - Chris Morristo automate when possible...
...
...
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 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).
...
...
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
...
-
...
Build final Production release for May 2022
Run full regression testing and fix any subsequent issues.
...
...
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
...
...
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...
Team notifications:
...
...
...
...
...
...