Deployment 2020-2.0 checklist

[mrakitin]

Previsit

• Make sure that the current latest environments are pushed to all the bl machines
• Skim the IPython startup files in profile_collection
  • Check if it's safe to start bsui remotely (does it touch any hardware?) - use git grep .put or git grep caput
• Check for outstanding PRs and issues on beamline repos
• Check if beamline specific packages pushed to the BL machines
• (Optional) Enable CI

Housekeeping

• Add BL staff to the BL GitHub organization as owners
• Work with BL staff to commit any un-committed changes to their profiles
• Tag the profile as-found as 2019C3.x
• Discuss with BL staff which conda envs they want to keep/delete and perform the cleanup
• Check/update the beamline's inventory with the BL staff (in https://github.com/NSLS-II/playbooks/blob/master/production)

Test deployment

• In ~/.bashrc add the following and remember to source ~/.bashrc afterward.

  export BLUESKY_LOG_FILE=/var/log/bluesky/bluesky.log
  export BLUESKY_IPYTHON_LOG_FILE=/var/log/bluesky/bluesky_ipython.log
  umask 0002

  and (if needed) create those directories, making them world-read/write-able.
• Append to 00-startup.py https://gist.github.com/jklynch/a4366b8900ec0c03883403455ae711b2
• Run profile against new environment
  • BS_ENV=collection-2020-2.0rc8 bsui
• Update the profile as needed to run:
  • history.sqlite issue - see https://blueskyproject.io/bluesky/metadata.html#persistence-between-sessions
  • Replace .value -> .get() if it's in a Device, or with yield from bps.read() if in a plan
  • Potential issue with images in databroker V2
  • Address a similar issue to CMS
• Run acceptance tests (if any) and run a representative set of scans for the beamline
• Tag the updated profile as 2020C2.0
• Update BSUI via ansible to use the new environment (http://nsls-ii.github.io/deployment/upgrading-beamlines.html#change-bsui-s-default-environment)

[mrakitin]

I didn't pay close attention to the "Address a similar issue to CMS" item, but @gwbischof pointed to the fix at CMS some time ago (NSLS-II-CMS/profile_collection@8d0fcaf) that we independently implemented with @dmgav today in #18.