Lab Prerequisites

1. Attendees at these sessions will be doing hands-on exercises using the Ed-Fi Cloud ODS/API for Azure, and you will need to provide your own laptop and have access to an Azure tenancy. There are two options for meeting the Azure tenancy prerequisite:
   • Option 1: You can use an existing Azure subscription and login provided you are Co-Owner (Co-Admin is not sufficient)
   • Option 2: You can setup free Azure subscription at portal.azure.com, that provides a $200 credit (you will be owner Global Admin). You can choose to do this ahead of time or wait for the session, where we will answer any questions.

     Note: Selecting option 2 requires a credit card!

2. You should have access to Ed-Fi Exchange and Ed-Fi's GitHub repository - which requires completing the Ed-Fi Access Request Form. 
   • Verify by connecting to: https://github.com/Ed-Fi-Alliance/Ed-Fi-X-Ods-Deploy-Azure
   • If not - we have a workaround!

Lab Instructions

Confirm you can login to your Azure tenant

• Connect to https://portal.azure.com and login
• Check your role: https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RolesAndAdministrators 

Set up Cloud ODS on Azure

• Obtain Azure Cloud ODS artifacts from the Ed-Fi Exchange.

  • If you have an Ed-Fi Community Login
    • Login to the Exchange (https://exchange.ed-fi.org)
    • Search for "Ed-Fi ODS/API Cloud Deployment for Azure (v3.x)"), and select "Download"
  • 
  • Download the latest Azure deployment scripts (version 2.0.0 or newer) from the GitHub release page: https://github.com/Ed-Fi-Alliance/Ed-Fi-X-Ods-Deploy-Azure/releases 
  • Note the simplest way to download is to choose the Source code (zip) link 
  • 

  • If you don't have an Ed-Fi login pr  GitHub access to Ed-Fi GitHub - download Ed-Fi-X-Ods-Deploy-Azure-v.2.0.0.zip

• Unzip to your local machine

  • Before unzipping the ZIP file, you need to "unblock it" - right-click on file and select unblock
  • 
  • Unzip to a local folder ("C\CloudODSInstall")
• Open PowerShell (Admin mode) and navigate to "C:\CloudsODSInstall\Ed-Fi-X-Ods-Deploy-Azure-v.2.0.0\Application\Published"
• Follow the detailed instructions in the readme: https://github.com/Ed-Fi-Alliance/Ed-Fi-X-Ods-Deploy-Azure/blob/v.2.0.0/README.md (or this PDF version)

.\Deploy-EdFiOds.ps1 -ResourceGroupLocation "South Central US" -InstallFriendlyName "My Lab ODS"

Notes:

• Determine your PS version: In a PS shell: "Get-Host | Select-Object Version" 

• You may need to change the execution policy for unsigned PowerShell scripts to run on your machine to run the scripts.

• Click through license: CloudOdsLicenseKey.txt

• 
  

  This may be accomplished by opening a PowerShell console and typing the following command:

  Set-ExecutionPolicy Unrestricted

Install pre-reqs for Lab 2  on your laptop

In order to do Lab 2 - ODS/API Management, you need to have the following:

• Ed-Fi URL's
  • URL to Admin App (in your Azure environment)
  • URL to Ed-Fi Swagger
• Postman tool and demo packages
  • Install Postman from https://www.getpostman.com.
  •  Download 'Ed-Fi Boot Camp 2019' Postman Collection and Environment 

Explore Ed-Fi Databases in SQL Azure (optional)

Make sure you have SQL Server Management Studio installed on your laptop.

Obtain a connection string from the Azure Portal and navigate around the databases.