Clinical Experience and Performance Quick Start

Owned by Steven Arnold
Last updated: Mar 31, 2023
3 min read

Use this Quick Start to set up and explore the Clinical Experience and Performance solution. At the end of this Quick Start, you'll have a functional and configurable sample Virtual Machine environment on Amazon Web Services, suitable for exploration and demonstration purposes.

Summary


Step 1. Setup the Virtual Machine

Prerequisites

To be able to successfully follow this Quick Start, you will need an Amazon Web Services Console Web Account with sufficient permissions to instantiate EC2 instances.

Ed-Fi can help with hosting a virtual machine on Amazon Web Services. Please enter a ticket into the Ed-Fi's tracker system to request help hosting your Quick Start virtual machine. You can create a new ticket by clicking on the "Create" button on the top menu of Tracker.

Set up the Virtual Machine in AWS

Follow these steps to create an instance of the VM that contains the Ed-Fi ODS / API and the Clinical Experience and Performance Starter Kit Dashboards.

  • Sign in to your AWS Console Web Account.
  • On the top menu select Services and then EC2.

  • On the left navigation menu, select IMAGES then AMIs.

  • On the top right-hand side, ensure that the "Ohio" availability zone is selected.
  • Click on AMI Catalog
  • Add the search terms: ed-fi-epp to the search box and hit enter to initiate a search.
  • Click on the Community AMI's tab
  • You should see an image show up, titled "Ed-Fi-EPP-Starter-Kit":

image-2023-3-31_15-15-31.png

  • Click the orange 'Select' button on the right side of the image
  • Click 'Launch instance with AMI' near the upper right corner 
  • Note: We recommend you use at least a t2.large. We have tested with smaller instances but they seem to be too slow to work with. Ideally a t2.xlarge provides a great responsive Windows UI and Ed-Fi development environment.

  • Move to the next section 'Key pair (login)'. This is often used to retrieve the instance’s Administrator Password. (This is not required as our image has a default password defined later in this document.) You can select one from the list or create a new key pair. Click the orange “Launch Instances” button.
  • You are now presented with a “Launch Status” screen. On the bottom right corner you will see another blue button that says "View Instances". Click it.
  • You will be redirected to the EC2 homepage where you will see your new instance starting up. You can edit the name for easy identification. 
  • Once the status changes to “Running” and initialization completes, copy the IP address and use it to remote desktop into the server.
  • Connecting to your EC2 instance:
    • If you're on a Windows machine, go to your Start Menu  and search “RDP”. Click on the "Remote Desktop Connection" application as depicted below.
    • If you're on a Mac, download Microsoft Remote Desktop from Apple's Mac Store.

  • Once the application opens use the public IP that was given to your VM instance and the following credentials:
    • Username: Administrator
    • Password: EdFi!sCool

image2020-3-25_11-52-37.pngThis will log you in to the virtual machine where you can start exploring the Clinical Experience and Performance Starter Kit.



Step 2. Explore the Starter Kit

Once you have logged in to the Virtual Machine click on the "Start Here" shortcut on the computer's desktop.

This will open a web page that will guide you through the rest of the process. In a nutshell, it will show you how to open the Power BI dashboard and work with it.


Follow the use cases and guide described in: Clinical Experience and Performance Dashboard Walkthrough.