EDSCLS Platform/VM 3.0

EDSCLS banner


The EDSCLS VM 3.0 was released in December 2017 and replaced by the EDSCLS VM 3.1 on January 29, 2018. To access the latest VM and related materials, click here. 

If you have already downloaded an older version of the EDSCLS VM and wish to download the new EDSCLS VM 3.0, make sure to save or export your data to PREVENT DATA LOSS. You can create a back-up copy by cloning your VM to be safe (see EDSCLS User Guide, Section 2.1.4 Virtual Machine Back-Up for instructions). 

See the Recommended Steps for updating the latest EDSCLS VM below for more information.


Changes Made to EDSCLS Platform/VM 3.0


Updated MySQL Client and Server 5.7, SSL 1.0.2g, Python 3, Postfix 3.1, SSL vulnerabilities, and Linux Kernel (replacing
What users need to do: For users who are currently using an earlier version of the EDSCLS platform/VM , IT administrators can (1) install the EDSCLS VM 3.0, which includes these updates, or (2) manually apply patches from the terminal command line (see EDSCLS User Guide Sections 2.1.1 Installation and Configuration and 2.1.5 Security Patches and Upgrades for instructions). Users can also power the older platform/VM off after a data collection has ended to prevent cyber-attacks (see EDSCLS User Guide Section 2.1.1 Installation and Configuration) and download the most recent VM before the next data collection.

Results and Reporting

Implemented new algorithms and step values to calculate benchmarked scale scores.  The benchmarked scale scores are not comparable to the scale scores produced by earlier versions of the EDSCLS platforms/VM. For more information about the benchmarked scale scores, see the EDSCLS benchmark webpage

What users need to do:When measuring school climate survey data trends (e.g., comparing school year 2016-17 data to what you will collect for school year 2017-18), you will need to convert your previous “legacy” scale scores to the benchmarked scale scores. In other words, the benchmarked scale scores produced by the EDSLCS platforms/VMs from now on are not comparable to the scale scores produced by previous platforms/VMs.

Users have two options to convert the old “legacy” scale scores to the benchmarked scale scores:

If you have raw data from previous administration(s), you can either:

  1. Import raw data from previous platforms/VMs to this platform/VM and rerun the legacy scale scores in the VM 3.0. See User Guide Section 2.2.10: Exporting and Importing Respondent-Level Survey Results.

  2. Use the new R code that generates benchmarked scale scores to convert legacy scale scores to benchmarked scale scores.

If you do not have raw data from previous administration(s) and need to measure data trends, contact the EDSCLS Help Desk at EDSCLS@air.org or 866-730-6735.

Added the updated R Code for calculating benchmarked scale scores to the EDSCLS User Guide appendix.
What users need to do: Users do not need to do anything, but are welcome to use the R code  that generates benchmarked scale scores to produce scale scores if they are administering the EDSCLS surveys outside of the platform. The old R code is available upon request from the EDSCLS helpdesk (EDSCLS@air.org, 866-730-6735).
Updated the scale score graphs to indicate benchmark levels with labels and color. 
What users need to do: Users do not need to do anything. The scale score graph now shows three levels into which the benchmarked scale scores may fall: The least favorable (scale score below 300); favorable (scale scores 300-400), and the most favorable (scale scores above 400-500). The three benchmark levels are presented in shades of gray to ease interpretation. See the benchmark webpage for more information about the benchmarked scale scores, including definitions for each level, and Section Survey Results Reports for a screenshot of the updated benchmarked scale scores graph. 
Updated filtering to exclude non-respondents from benchmarked scale score calculations.
What users need to do: Users do not need to do anything.  Starting with the platform/VM 3.0, non-respondents are excluded from the scale score calculations. Nonrespondents are defined as survey participants who didn’t answer any climate items, regardless of whether they answered any demographic items. 
Removed grades from staff survey results on the scale score report.
What users need to do: Users do not need to do anything. In the previous versions of the platform/VM, the scale score graph for instructional and noninstructional staff by subgroups showed grade levels. Each grade level had the symbol for missing data. Since data about a grade level are not collected in the staff surveys, the grade levels have been removed from the graphs that the platform/VM produces for staff surveys’ scale scores.  

Recommended Steps for Users of past EDSCLS VM Versions Transitioning to EDSCLS VM 3.0

If you have already downloaded a previous version of the EDSCLS VM and wish to transition to the latest EDSCLS VM, review the options below to prevent a loss of data.

Option 1: Keep the older EDSCLS VM on your server to house data from previous survey administrations. Then simply download the new EDSCLS VM and follow the installation instructions. Thus, you will have multiple VMs on your server storing your older and newer data.

Please see User Guide Section 2.1 System Setup in Virtual Environment for updated VM installation technical requirements. Note: Your server will require sufficient RAM and free hard disk space if you run multiple VMs on the same server. You also need to power off your old VM to prevent security breaches.

Option 2: If you do not wish to keep multiple versions of the EDSCLS VM on your server, and want to delete the older EDSCLS VM, you must first export all data reports you would like to save and export the raw data from the older EDSCLS VM for future use. If you do not, you will lose all the data stored in the older VM when it is deleted. It’s always a good idea to clone your current VM so that you have a back-up copy (see User Guide Section 2.1.4 Virtual Machine Back-up for cloning instructions).

If you are currently collecting data using the EDSCLS VM, we recommend you NOT transition to the new EDSCLS VM until your data collection is complete.

Instructions on How to Download and Start Using the EDSCLS VM 3.0

To help you navigate the administration of the EDSCLS, we have created a variety of tools. Below you will find links to download the latest EDSCLS VM, the EDSCLS User Guide which has been updated to reflect lessons learned, the updated EDSCLS Survey Item Lists, the updated EDSCLS Codebooks, and the Nonresponse Bias Worksheet.

We recommend that you download and read the EDSCLS User Guide before downloading the EDSCLS VM. Section 2.1 System Setup in Virtual Environment in the User Guide, which was just carefully updated, is intended for the education agency’s IT staff who will be in charge of downloading, installing, and configuring the EDSCLS web-based platform. Section 2.2 EDSCLS Administration is intended for Survey Administrators, who oversee the survey data collection through the EDSCLS dashboard.


Lessons Learned to Keep in Mind
As You Get Started:

Install the EDSCLS VM to a physical server, not another virtual machine, such as VMWare. See section 2.1 System Setup in Virtual Environment (for IT Staff) in the User Guide.

Use one of the three methods to keep your EDSCLS VM secure from cyber-attacks. See 5.2 Technical Platform Capabilities in the FAQ section of the User Guide.

Contact the EDSCLS helpdesk at EDSCLS@air.org or 866-730-6735, between 9:00 am to 5:00 pm EST, if you need assistance.

Download EDSCLS Administration User Guide
Download EDSCLS Survey Item Lists
Download the EDSCLS Code Books

American Institutes for Research

U.S. Department of Education

The contents of the National Center on Safe Supportive Learning Environments Web site were assembled under contracts from the U.S. Department of Education, Office of Safe and Supportive Schools to the American Institutes for Research (AIR), Contract Number  91990021A0020.

This Web site is operated and maintained by AIR. The contents of this Web site do not necessarily represent the policy or views of the U.S. Department of Education nor do they imply endorsement by the U.S. Department of Education.

©2022 American Institutes for Research — Disclaimer   |   Privacy Policy   |   Accessibility Statement