Update to 2.2
This content is for 2.2 (Preview). Switch to the latest version for up-to-date documentation.
This is a minor version update of Schoolyear AVD and thus no major migration steps need to be taken. You can learn more about our versioning policy here. Migrating from 2.1 should be easy with the necessary permissions, and your currently deployed images will not be affected. The only changes related to 2.1 are 2 new resources:
- Custom Azure role
- Backup Storage Account
Additionally, the custom role of your App Registration gets two new permissions (see Service Principal permissions).
Features
Section titled “Features”Amongst some future-proofing and stability updates, version 2.2 introduces 3 new features.
Automatic cleanup of Entra Devices
Section titled “Automatic cleanup of Entra Devices”Schoolyear AVD now adds each session host to a Security Group, instead of relying on a Dynamic Group. A nice perk of this approach is that at the end of an exam, Schoolyear AVD automatically removes these devices from Entra ID. As a result, successful exams no longer leave orphaned devices. You can read more on the Security Group in the Architecture Overview page.
Service Control A.10 was updated from once every 3 months to once every 6 months.
Student file backup
Section titled “Student file backup”At the end of every exam, Schoolyear AVD will automatically back up student files to a dedicated Backup Storage Account deployed in your base resource group.
By default, the Documents, Downloads, and Desktop folders will be backed up. Custom layers can extend this list using backup_config_patterns in properties.json5.
Files will be retained for 30 days (configurable) and are accessible to teachers and administrators via the Schoolyear dashboard.
See the Student file backup page for full details.
Custom VM Login Role Assignment
Section titled “Custom VM Login Role Assignment”We’ve reduced the necessary number of role assignment calls from 2 to 1 by creating a custom VM role assignment, dramatically reducing the load on Azure during large exam starts. This roughly translates in twice as fast onboarding of students. Azure has a hard cap of 4000 role assignments per subscription so this also doubles the allowed number of students that are able to participate in exams in a single AVD Add-on installation.
Steps for updating
Section titled “Steps for updating”Updating from version 2.1 to version 2.2 involves the following steps:
- Go to your Schoolyear dashboard, select your
Secure Apps Consoleand go to theAVD Add-onstab. - Find your version 2.1 AVD add-on and click on it.
- On the top right corner you will see an
Upgrade nowbutton, click on it. - You will be prompted to follow a similar (but much quicker)
process as you would be installing a fresh instance of the AVD Addon. You
will only be asked to deploy and configure the new resources introduced in
version 2.2. Any resources previously installed in the 2.1 version of the
Addon will remain intact and won’t need re-deployment.
One of the steps adds the two new permissions to the custom role of your
App Registration. This requires permission to edit custom roles in the
Subscription, such as the
Ownerrole. - Save the add-on.
- Delete the old Dynamic Group, unless another 2.1 add-on still uses it.