Disabling V1 test job submissions
=================================

**IMPORTANT** 2017.10 starts the roadmap to the removal of V1 by DISABLING all V1 test job submissions. 

Queued V1 test jobs will continue to run but once 2017.10 is installed, all attempts to submit a V1 test job will be rejected. This includes health checks for devices which do not yet have a V2 health check. (So those devices would go offline - remove the health check job from the database entry of the device-type to get the device back online if there are queued jobs.)

Before installing this upgrade, check the Migration Status page on the particular instance. e.g. https://staging.validation.linaro.org/scheduler/migration

Notification on installation
============================

By default, installing 2017.10 will raise a notice, reminding you of this change:

  The 2017.10 release **disables ALL V1 test job submissions**. Queued
  test jobs will continue to run but if you proceed, only V2 submissions
  will be accepted by this instance.
  .
  If you want to create an archive of the existing V1 test data, install
  this version but do not allow further upgrades of LAVA packages.
  .
  See https://lists.linaro.org/pipermail/lava-announce/2017-September/000037.html  

If you are deploying this change using configuration management, you may need to define this environment variable to allow the installation to proceed: 

APT_LISTCHANGES_FRONTEND=none

Window for creating a V1 archive
================================

Once installed, admins can choose to wait until all queued V1 test jobs have finished and then use a backup of the postgres database to create a read-only V1 archive. Install 2017.10 on the archive instance and then restore the backup database. All dashboard objects in 2017.10 are read-only. Admins will need to ensure that all devices on the archive instance match those on the original instance and then change all devices to Retired status in the django admin interface.

See also https://staging.validation.linaro.org/static/docs/v2/pipeline-server.html#support-for-a-v1-archive

Archive repository support
==========================

2017.10 will be preserved in a dedicated LAVA repository in case an archive has to be reconstructed from a database backup after 2017.11 is released. http://images.validation.linaro.org/v1-archive-repo/

lava-server
===========

03fec0ea Fix out of date stretch reference
2c8a88d8 Include non https in title for security defaults configuration doc.
56185add Mark required parameters in left over deploy action reference.
b1de8acf Update instructions for migrating postgres
2b845967 Fix issues in the documentation build.
f9e64aa1 Fix SQL request storm when listing jobs
95b12c01 Fix missing import
0a63c2f3 Adjust U-Boot load addresses for imx6q-sabrelite to allow bigger kernels
3a4cddf4 LAVA-341 Unicode issues in tables and queries
5bff2fd5 Mark required parameters in deploy action using an asterisk.
00b5044a LAVA-1035 Force all Dashboard objects into read-only mode for users
7a006f64 Change load addresses for Jetson TK1 to allow bigger kci kernels
ca5e6834 Update commands for eMMC boot of OE on X15
0d17e797 Add docker device-type configuration
f0c2107c Remove doc references to lava-lxc-device-* commands.
715c6309 LAVA-771 - Support dragonboard-820c with lxc
7a4adb03 Fix the hierarchy of md5sum and sha256sum in nbdroot index.
576661f4 Make clear when to use lxc://
7c68e21b Document download deploy and explain about lxc:// url scheme.
8f4d7419 Rewrite fastboot deploy action reference doc.
11f5c222 archive: do not allow to force hc
9536450d logger: drop level and action name
771d0d93 Fix a typo in deploy to name.
0a2404fa Update command requires an alias argument
e7a704a1 Add V1 EOL summary to the index page for all docs
cdaa6376 LAVA-1003 do not lose logging messages
f09b6beb LAVA-1045 - document the archive setting
483fb1a7 LAVA-1038 add a settings to archive the instance
866afbf4 migration: v1 health-check are not used anymore
896db15b LAVA-1033 remove v1 job wizard
2eac055b LAVA-1043 fix handling of large log files
aef7d7b8 Add device-type disco-l475-iot1
399b9dbc Use the CDumper to export results
c9dc6a14 LAVA-1032 reject v1 submission at api level
65394986 Drop lookups to ActionData from testcase export
80d1a9fa Add support for the NextThing CHIP Pro
21c8fc52 Only write logs to output.yaml
01df9ce0 Improve job listing by fetching more data
436c220e Decrease SQL queries when listing test results
445b9c66 Add support for reading django settings for limiting LDAP group access
a33b9c9f Only set the job status if lava-run crashed
581b616f Fix boot action doc for fastboot and lxc boot methods.
08393dbb Use new logging API
33a73bb3 device-types: panda: handle bigger kernels
746fe4c9 Allow to override prompt in device configuration
5932f9d1 LAVA-1048 Extend X15 to typical U-Boot support
affaa35d Fix error message in daemonise.py
e24db160 Fix lambda syntax
8fb16105 v2: Do not fall back to db for health-checks
bceecc64 Do not submit new health checks for v1 only device

lava-dispatcher
===============

1b129396 Remove unnecessary calls to get_udev_devices.
55cc9a0d Replace LxcAddDeviceAction with LxcCreateUdevRuleAction.
9cf899df Include vendor and product id if available, while writing udev rule.
5eea8b61 Add missing requirement for magic binding
75b47c6a Remove loop mounts via guestfs, while applying overlay to sparse image.
1f285ecf Ensure the image is Android sparse image before acting on it.
44b8436a Add missing dependency on pytz
b953a562 Append to the udev rules and avoid overwriting.
44380b3e Add a new device type: docker
336719bf Fix broken link in hikey960 unit test.
1703dc94 Remove unused signals after introduction of udev based device addition.
7f2f049e Always don't assume a ZMQ handler for logging.
9fa3995e Fix a typo in log message.
9cab91d0 LAVA-1046 allow to send logs from lxc udev scripts
37c7e863 log: allow to add a linger when closing socket
dd4f6b09 LAVA-1040 - Initial boot only support for artifact conversion in LXC
7ed0674c logger: remove level and action name
70fb64c4 lava-run: output_dir should be an absolute path
8f31f584 Always revert directory changes
40ca2c11 Add a timezone aware log message at job start
79325b7b Ensure a retry sets a failed result
b8527df2 Debug log message to know image files are copied to LXC.
3665e840 Allow fastboot calls to fail and return the log
7de0f887 Fix bug #3007 - Unable to reboot target between tests on hikey-hi6220
dc5e5b18 Send a bad status only when lava-run crashed
18607373 Write description.yaml when all logs where sent to lava-master
e185d967 Move most exception handling to lava-run
57829892 Move signal handling to lava-run
d9d39463 Provide useful output when no classes accept an action
1c45a4ad Setup logging as early as possible
af4401f0 LAVA-1048 extend X15 support for U-Boot
12711359 Raise an error instead of setting self.errors in run()


--

Neil Williams
=============
neil.williams@linaro.org
http://www.linux.codehelp.co.uk/