Skip to content

Connect to Schoolyear

Once you have completed your Schoolyear AVD implementation in your Azure tenant, you can connect it to your Schoolyear tenant.

Configuring quotas

To make sure users won’t schedule exams for which you do not have enough capacity in your Azure tenant, you will need to configure quotas in the Schoolyear dashboard.

The quota system consists of two parts:

  1. How much is available: Configure in Schoolyear how much capacity is available in your Azure Subscription.
  2. How much is required: Configure per AVD app how much capacity is required to deploy an exam. This is configured per app when installing the AVD add-on later in this section.

We will start by configuring how much capacity is available.

  1. Figure out how much capacity of Standard DSv5 Family vCPUs is available in your Azure Subscription in the region you want to deploy exams to. This can be lookup in the “Quota” dashboard of the Azure Portal.

  2. Navigate to the Schoolyear Admin - Quota page

  3. Click on “Add Quota” and fill in

    • Subscription ID: The ID of your Azure Subscription.
    • Resource ID: azurevms
    • Value: The available quota you found in the first step.
  4. Click Add

Install the AVD add-on

For each Azure implementation, you have to install one “Azure Virtual Desktop” add-on in the Schoolyear admin dasbhoard. Each of these add-on installations can publish multiple “Apps” for teachers to choose from. Each of these Apps refer to a Deployment Template in your Azure tenant.

  1. Navigate to the Schoolyear Admin dashboard

  2. Click Add > Azure Virtual Desktop

  3. Configure the add-on details

    • Name: Schoolyear AVD
    • Azure Tenant ID: Your Azure Tenant ID
    • Client ID: The Application (client) ID of the App Registration you made in an earlier chapter
    • Client Secret: The App Registration Client Secret you created in an earlier chapter
    • OIDC Issuer: This will be filled-in automatically.
    • Discovery TTL: Leave as is
    • Additional Scopes: Leave as is
  4. Publish the Office 365 App

    • App Name: Microsoft Office
    • Thumbnail URL: You can leave this empty or point it to a publicly hosted Thumbnail image
    • Max Duration: Here you configure the maximum duration of an exam. You can leave it to the default (5h).
    • Template Resource ID: Paste the Resource ID of the Template Spec you created in the previous chapter.
    • Azure Region: Fill-in the Azure Location in which you did the Azure implementation.
    • Subscription ID: Fill-in the Subscription in which you did the Azure implementation.
    • Deploy Duration: This is the duration before the exam start the deployment will start. You can set it to duration("25m") for test purposes.
    • Delete Duration: The is the duration you expect the deletion of the resources to take after the exam. You can set it to duration("20m") for test purposes.
    • Expected average # students: 50
    • Quotas: Select the azurevms quota you created earlier and set the value to 2*n + min(max(2, int(ceil(n / 10))), 10). This is how the planning tool will calculate how much quota to reserve for an exam.
  5. Click “Add” to install the Schoolyear AVD add-on.

Done

Congrats, you are done. You’ve implemented Schoolyear AVD.

Teachers can now use the Microsoft Office app when configuring exams in your Schoolyear tenant. You can give it a try now.