Upgrade checklist, May 2016

notes.md

0. Create 'DAMA Software' logbook in beamline Olog.
1. Run conda list -n collection > /tmp/conda-list-before-upgrade.txt and include it in an Olog entry as an attachment.
2. Install packages:
   • event_model >= 1.0.2.
   • bluesky==0.5.0
   • databroker==0.4.1
   • metadatastore==0.4.2
   • ophyd==0.4.2rc1
   • doct==1.0.2
   • historydict==1.0.1
3. As above, create a text file and attach it to the same log entry.
4. Commit IPython profile and sync with github.
5. Standardize 00-startup.py around the documented standard
6. Adjust for API Changes in beamline config:
   • Remove imports of bluesky.broker_callbacks, bluesky.hardware_checklist, bluesky.standard_config.
   • If gs was being imported from standard_config, import it from bluesky.global_state instead.
   • gs.RE.subscribe_lossless('all', metadatastore.commands.insert)
   • To avoid an annoying warning, import install_qt_kicker from bluesky.utils instead of (deprecated) bluesky.qt_kicker.
   • Cleanup unneeded code that turns asyncio debugging off. (It's off my default now.)
   • Do not bulk import from bluesky.plans import *. (There is a lot of stuff in there now, and some names like sleep shadow common imports.)
   • Use new Olog integration and verify that it works. (Some beamlines are already doing this.)
7. Check the order of Components in Device class definitions. To be safe: in PVPositioner definitions, readback (not setpoint) should be first because that is the value that will be used to restore motors to their original positions if .position does not exist.
8. Customize names, read_attrs, and configuration_attrs in accordance with beamline scientists' preferences.
9. Run user acceptance tests.
10. Commit IPython profile and upload to github.
11. Ask what new hardware beamline will use this cycle.