ILLINOIS SCIENCE ASSESSMENT 2022

Page created by Manuel Cruz
 
CONTINUE READING
ILLINOIS SCIENCE ASSESSMENT 2022
ILLINOIS SCIENCE ASSESSMENT
                                 2022

ISBE
Illinois Science Assessment
Safe Exam Browser Installation & Troubleshooting

01/31/2022

Overview
This document contains instructions for the installation and management of the Safe Exam Browser
(SEB) used for the Illinois Science Assessment.
ILLINOIS SCIENCE ASSESSMENT 2022
Table of Contents
Current SEB Versions                                                     3
  Important Note                                                         3

SEB for Windows 10                                                       4

SEB for macOS 10.15, 11.x, 12.x                                          5

SEB for Chromebook                                                       6

SEB for Apple iPad - iOS 13.0+                                           8

SEB Troubleshooting                                                      9
  Windows SEB Installation & Troubleshooting                             9
  Uninstall the Windows Safe Exam Browser (SEB)                          14
  Mac SEB Troubleshooting, Installation Images & Uninstall Information   16

                                                                              2
ILLINOIS SCIENCE ASSESSMENT 2022
Current SEB Versions
Tests will be administered using a Safe Exam Browser (SEB), which locks down the testing device
preventing the student from navigating away from the test mid-assessment. Ensure the SEB is
properly installed on all testing devices prior to initiating student testing. Only an SEB installed from
the official, ISBE-supplied SEB installer will interoperate with the ISA testing platform.
Links to the official SEB installers are available on the ISA page of the ISBE Website:
https://www.isbe.net/Pages/Illinois-Science-Assessment.aspx

All Districts and Schools should verify that they are using the correct version of the SEB for the 2022
ISA.
                                  Operating System                          SEB Version

   Windows              Win 10                                ISA SEB v.3.3.1

   Mac                  macOS 10.15, 11, 12                   ISA SEB v. 2.2.2

   Chromebook           93-97                                 ISA 2022
                        We recommend using one of the
                        most recent three versions of the
                        OS.

   iPad                 iOS 13x-15.1, 15.2                    ISBE SEB App

                        Supported Versions
                        • iPad Pro 9.7 inch +
                        • iPad Air (third gen)
                        • iPad Air 2
                        • iPad 5th generation
                        • iPad 6th generation
                        • iPad 7th generation
                        • iPad 8th generation

Important Note

When installing a newer version of the ISBE-ISA Safe Exam Browser (SEB), it is important to
remove all vestiges of previously installed SEB instances. If a previous year's ISBE-ISA SEB or another
vendor’s SEB is not removed, students will not be able to start their tests.

                                                                                                            3
ILLINOIS SCIENCE ASSESSMENT 2022
SEB for Windows 10
Note: Support for Windows 11 is still conditional due to the timing of the release

Installing/Running in a Managed Environment: MSI
File Name: ISBE_ISA_2022-WindowsSEB_v3.3.1.msi
Note: This installer will be available as a standard MSI file for either manual installation on testing
stations or distribution by configuration management systems.
    1. In order to successfully install via the MSI file, ensure the following dependencies are
       installed/up to date
           a. .NET Framework 4.7.2 or higher is needed. Installer can be found at Microsoft’s site
               (make sure to download the “runtime” version)
                https://dotnet.microsoft.com/download/dotnet-framework/net472
           b. Microsoft’s Visual C++ 2015-2019 is needed as well (x64 version). Uninstall any
               outdated versions before installing the following
               https://docs.microsoft.com/en-US/cpp/windows/latest-supported-vc-
               redist?view=msvc-170
           c. Microsoft’s Edge WebView2 Runtime is also needed. Preferred version is “Evergreen
               Standalonex64” for compatibility with future applications but the fixed versionx64
               should also work for this year
               https://developer.microsoft.com/en-us/microsoft-edge/webview2/
    2. Install SEB using the standard MSI procedure.
 Installing/Running in a Managed Environment: EXE
    (Notes: You must have local administrator rights to the device to install via the .exe file.)
    1. Make sure to have updated versions of all three files listed under the MSI installer, step 1
       (.NET Framework 4.7.2+, Visual C++ 2015-2019, Edge WebView2)
    2. Copy the file to a local drive.
    3. Navigate to file in explorer.
    4. Right click file and “Run as administrator.”
            a. Do not double-click file to install.
    5. “User Account Control” Popup. Click .
    6. “Welcome to the Install Shield Wizard for Safe Exam Browser”. Click .
    7. “License Agreement”. Click “I agree …” radio button and then click .
    8. “Ready to Install the Program”. Click .
    9. “InstallShield Wizard Completed”. Click .
    10. Start the Safe Exam Browser.
            a. Unless otherwise directed, SEB will be saved to the standard program folder on your
               computer. Start SEB by searching for “Safe Exam Browser” in the Start Menu and
               select Safe Exam Browser.
            b. Note: If any prohibited processes are running, the system will display “Permitted or
               Prohibited Processes Are Running” dialog box. Click  to start SEB.
Notes
    •   Use CTRL+Q to shut down SEB. Administrators will need to use the following password to
        safely shut down the SEB: 472317
                                                                                                          4
ILLINOIS SCIENCE ASSESSMENT 2022
SEB for macOS 10.15, 11.x, 12.x

DMG file name: ISBE-ISA_Mac_SEB_2022.dmg
Installer file name (within DMG): ISBE-ISA Safe Exam Browser 2022.pkg
Installing in a Managed Environment
   1. SEB is a DMG/PKG distribution package for Apple systems which can be installed via
      standard methods including manual install or configuration management tools designed to
      manage Mac fleets.
           a. Note: The DMG includes the primary PKG installer and an “Extras” folder (which
              contains a ZIP of the SEB app and an SEB config file). Items in the “Extras” folder are
              for fallback purposes only. Please see troubleshooting for more info
   2. Download Safe Exam Browser DMG (ISBE-ISA_Mac_SEB_2022.dmg).
   3. Open Downloads folder in the Finder.
   4. Double-click the downloaded ISBE-ISA Mac SEB 2022.dmg.
   5. Double-click the “ISBE-ISA Safe Exam Browser 2022.pkg” installer within the DMG.
   6. Click “Continue” for the introduction.
   7. Click “Install” and proceed through installer windows.
   8. Click “Close” when complete.
        A resulting application titled “ISBE-ISA SEB Spring 2022 (2.2.2)” will be in the /Applications
        folder. Depending on your system configuration, it may or may not have a “.app” extension
        shown.
        An “SEBClientSettings.seb” configuration file will be located in the system
        /Library/Preferences directory.
   9. To start the SEB and begin the ISA test, navigate to the /Applications folder and double-click
      the “Safe Exam Browser” application.

Notes
   -Administrators will need to use the following password to safely shut down the Mac SEB:
   472317
   -The installer should place any previously installed version of the SEB that is titled “Safe Exam Browser” in
   the Trash (assuming the old version is in /Applications) to ensure that the proper version is used. The new
   configuration .seb file will overwrite any older ones by default.

                                                                                                               5
ILLINOIS SCIENCE ASSESSMENT 2022
SEB for Chromebook

The Chromebook equivalent of the SEB must be installed via the Google Admin Dashboard. It
typically takes less than 3 minutes to install the app on all managed devices. However, it may take
up to a half hour for the app to appear on the devices. Verify that the correct version of Chromebook
SEB is installed by looking for a “2022” in the icon artwork.

Note: If you installed and used this app during the ISA 2021 administrations, it should automatically
update to the 2022 version which can be verified by looking at the icon artwork. If the Chrome device
has not been restarted in the past few weeks, restarting the device will force the update and show
the ISA 2022 SEB App.

Installation Instructions
        1. In Google Admin Dashboard, Select the Organization to apply this change to.
        2. As a Super Administrator or Apps and Device Administrator, navigate to:
              - Device Management
                 - Chrome Management
                   - Select Apps & Extensions from the list
                     - Select Kiosks from top row

        3. Check to ensure that the desired Organization/Sub-Organization is selected in the left-
           hand column.
        4. If the app was previously installed for this Organization/Sub-Organization, it will appear
           on the list.
        5. If the app was not previously installed for this Organization/Sub-Organization
               a. Select the yellow “+” sign on the bottom right corner
               b. Hover the mouse arrow over the options and select “Add Chrome App by
                  extension or ID
               c. Type in the app ID: ejikkaandonohadbjpdnoffgbcljgbhb
               d. Ensure that “From the Chrome Web Store” is listed below the entry and select
                  Save.
        6. Double check that the app is listed as “Installed”. If not, select the drop-down arrow and
           change
               a. **The ISBE ISA 2022 App will now appear in the APPS section of the taskbar
                  (bottom of the screen) when a Chromebook is turned on, BEFORE log in. Left
                  Clicking on the App icon will launch the app. Following the test session, restarting
                  the Chromebook will return it to normal use.
        7. IMPORTANT - Select Save again in the top right corner of the screen.

Note:
**Alternatively, you can select “ISBE ISA 2022” as the “Auto-launch app” and it will automatically
boot up when the computers are restarted/turned on after inactivity (typically within 30 minutes).
The direct URL is: https://chrome.google.com/webstore/detail/isbe-isa-
2022/ejikkaandonohadbjpdnoffgbcljgbhb?hl=en&authuser=0
                                                                                                        6
ILLINOIS SCIENCE ASSESSMENT 2022
NOTE: The pictured keys below (specifically the “BrowserBack” arrow pointed left) should
NOT be used by students to navigate between test items. If pressed while in an active test,
the students will be booted out of their test and the Org Admin will be required to reset the
student login in ISBE Teach.

If this becomes a repeated issue for your students, the Google Admin in control of Chromebook
settings can enable the “Set Keyboard Top Row as FN Keys” feature pictured below BUT this
will “lock” the rest of the top row shortcuts (including volume/brightness controls). In this mode, the
top-row shortcuts are still accessible by holding the magnifying glass/search button on the
left side of the keyboard and pressing the shortcut, making it more difficult to accidentally exit
the test.

Installation Notes
   •   If attempting to install and run via the Chrome browser and the Chrome Web Store (on a Mac
       or PC), a blue "Incompatible" warning will be displayed.
   •   If attempting to install via Client settings/extensions (for example by downloading to a jump
       drive and unpacking the app on the desktop), the following alert will be displayed:
           o   “There were warnings when trying to install this extension: 'kiosk only' is not allowed
               for specified platform.”
   •   If attempting to install via the Chrome browser on a managed Chromebook an alert similar to
       the above or "blocked by administrator" will be displayed.
   •   If the school’s Google Domain has the Apps/Extensions restriction set to “block all except
       what I whitelist”, the ISA App may need to be whitelisted prior to installing in Kiosk mode.

                                                                                                          7
ILLINOIS SCIENCE ASSESSMENT 2022
SEB for Apple iPad - iOS 13.0+

Note: ISA supported iPads must run OS 13.0 – 15.2. Supported devices include iPad Pro 12.9 inch,
   iPad Pro 9.7 inch, iPad Air 2, iPad Air, iPad 5th generation or better.

iPad Secure Exam Browser Instructions
   1. Access the ISA iPad secure testing application via the ISBE.net / ISA page. The link posted
      there will be for the approved app in the Apple Store. Follow the onscreen instructions to
      access the application.
   2. Once downloaded, users will immediately be prompted to allow the application to enter single
      application mode. Select Yes.

   3. The Secure Exam Browser application will launch.
   4. Navigate through the assessment.
   5. Shut down the Secure Exam Browser application by selecting the red button in the top-right
      corner of the screen.
   6. Users will be prompted to enter an unlock code to shut down the Secure Exam Browser
      application. The unlock code is: 472317.
   7. After entering the unlock code, tap the OK button or the Done button on the keyboard to shut
      down the browser.
   8. To use the Secure Exam Browser application for a new test, tap the Launch button.

Installation Notes
   •   The application is only built to work on iPads; it cannot be downloaded or used on an iPhone.
   •   Applications specifics:
          a. Name: ISBE ISA Secure Exam Browser
          b. Title: ISBE ISA Secure Exam Browser
          c. By: Illinois State Board of Education
          d. Direct URL: https://apps.apple.com/us/app/isbe-isa-secure-exam-
             browser/id1451989498

                                                                                                    8
ILLINOIS SCIENCE ASSESSMENT 2022
SEB Troubleshooting

Windows SEB Installation & Troubleshooting

  1.   In order for the MSI file to install successfully, ensure the .NET Framework 4.7.2 or later
       is installed. If it is not installed, you can find the download details at the following
       Microsoft URL
       a. https://dotnet.microsoft.com/en-us/download/dotnet-framework/net48
  2.   Install SEB using the MSI or EXE following the typical methods.
       • If you see this (or a similar) error message, right click the file and select run as
           administrator to run the SEB install.

  3.   After the Install process is complete, you should see the following icon in the Start Menu
       or Programs List.

  4.   When launching the SEB, you should see the SEB splash screen and the welcome
       screen for the Test Driver:

  5.   Some Users may see this message when launching the SEB for the first time
       (Mac version shown):

                                                                                                     9
ILLINOIS SCIENCE ASSESSMENT 2022
6.    If this message is shown instead of the ISBE Learn Test Welcome Page when launching
         the SEB, it indicates the test configuration process was not completed properly during the
         initial installation. Exit the SEB and use the following instructions to complete the SEB
         configuration set up.
   7.    Download the Windows SEB configuration file, SebClientSettingsForProd from the
         ISBE-ISA site. Deploy this file to the testing devices.
   8.    Find this file on the testing device.

   9.    Right Click the filename,
         a. Select Open with… and then select Safe Exam Browser.

           1)                                     2)
         b. Or, if listed, select Open with Safe Exam Browser from the top of the right click
            menu.

   10.   This action will apply the SEB configurations to the installed SEB on that device. After
         completing this action once, the SEB should open normally using the standard SEB icon.

Windows Error Messages Continued:

                                                                                                 10
If the above error message appears when attempting to install or uninstall the SEB there are two
things that could be wrong.
   1. The Visual C++ redistributable is outdated (or not installed at all). 2015-2019 is required.

   2. .NET framework is outdated (version 4.7.2 or higher is needed)
-To update the Visual C++ redistributable go to the following link and install the 64x version of the
2015-2019 redistributable
https://support.microsoft.com/en-us/topic/the-latest-supported-visual-c-downloads-2647da03-1eea-4433-9aff-
95f26a218cc0
-To update the .NET framework you can either use the .exe installer for the SEB which
automatically updates the framework, or you can visit the following Microsoft link and download the
most up to date version
https://dotnet.microsoft.com/download/dotnet-framework

“SEB failed to start a new session! Consult the Log Files” Error Message:

This error message most likely means your Visual C++ redistributable needs to be updated. Review
the list of system requirements on page 4 under Windows installation. Follow the above link and
install the 64x version. If that does not fix the issue, contact support and have the log files linked in
the error message ready and available to send via e-mail to a support team member.

“Failed to start. Verify that you have sufficient privileges....” error message (or “Safe
Exam Browser Service” Files in Use message:

                                                                                                         11
Note: The “Files in Use” dialog only
                                                            appears when using the .msi installer
                                                            These error messages will appear if the
                                                            2022 installers are used while there is still
                                                            an outdated (2021) version of the Safe
                                                            Exam Browser installed on the device.
                                                            There are two ways of handling this
                                                            First Method (only doable with the .MSI
                                                            installer as the “Files in Use” dialog does
                                                            not appear for the .exe):
                                                            •               Files in Use Dialog:
                                                            Select “Cancel” and exit out of the installer
                                                          •               Manually uninstall the
                                                          outdated “Safe Exam Browser” application
       via “Settings” or “Control Panel” or the command line
   •   Run the installer (.msi or .exe, either will work) again and everything should be good to go
Second Method:
   •   Files in Use Dialog (if using the .msi): Select “Close the application....” and then “OK”
   •   Failed to start error dialog: Do NOT select "Retry” even if you have admin privileges as this
       will stall out the computer and require a restart.
          o   (.exe): Right clicking and using the “Run as administrator” option will not prevent this
              either, it does not appear to be a privileges/permissions issue
   •   Cancel the installation process and exit out of the installer.
          o   The installer at this point will have uninstalled the outdated version of the SEB
   •   run the same installer a second time. This time the SEB should successfully install with no
       issues

                                                                                                          12
***As these error messages appear tied to the transition from uninstalling the old application to the
installation of the updated one, it’s easiest for future test windows (or for your other devices) to
uninstall the SEB application from your computer fleet as soon as your current test window closes***

                                                                                                   13
Uninstall the Windows Safe Exam Browser (SEB)
Navigate to the Windows uninstall utility tool, using the
following path:

    1. Start menu
    2. Control Panel
    3. Programs
    4. Uninstall a program

    5. Search and select SafeExamBrowser
    6. Select the uninstall button above the table
    7. Follow the onscreen prompts to complete the
       uninstall process
    8. When the uninstall process is complete, you may
       install the current year SEB.

NOTE 1

Some users might encounter the following message or a
similar error message during the uninstall process in Step 7
above.

Use the following steps to complete the uninstall process.

    1. Take note of the specific name of the requested .tmp
       file (should be in the format MSIXXXX.tmp where the
       X’s are a combination of letters/numbers). Download
       the following replacement MSI.tmp at
 https://drive.google.com/file/d/1lGDt15hTTsAMQiAwVR8SyXX
                        w3my8zV4U/view
    2. Rename the downloaded MSI.tmp file to match the
       filename that the error message requests
       (MSIF915.tmp in the example on the right)
    3. Return to the error message and click on Browse to
       select the file from the local machine where it is
       saved.
    4. Once the file path appears in the Use Source field,
       click OK.
                                                               14
5. The uninstall process will continue and complete.
NOTE: If the error message requests a specific installer
rather than a .tmp file, contact support who will put you in
touch with the development team who will have access to
older installers
NOTE 2

Some users might find that after uninstalling there are still
items in the SafeExamBrowser folder
(C:\Program Files (x86)\SafeExamBrowser)
If this happens, you must delete the entire folder before
installing the new version.

                                                                15
Mac SEB Troubleshooting, Installation Images & Uninstall Information

Local Settings Have Been Reset Message

It’s possible that upon opening the SEB an error message claiming “local preferences were created by an
incompatible SEB version..... Ask your exam supporter to re-configure SEB correctly” will pop up.
This is a non-issue as long as the above “Illinois Science Assessment” Welcome/Start splash screen appears
behind said message. Simply click “OK” and begin testing.
Note: This message appears the first time opening the Safe Exam Browser after doing the complete un-install
listed below (most specifically, removing the .plist file will trigger this message the next time the application is
opened) and will not appear again.

Typical Issues:
ADP-1210: Secure Exam Browser application is NOT recognized when code is entered

                                                                                                                  16
This means 1 of 2 things

    1. The installed Safe Exam Browser.app is an incorrect version. Verify that the installed SEB is v 2.2.2 (if
       this is not listed on the bar at the top of the application when open, can check this by right clicking the
       application in Finder and selecting “Get Info”
    2. If the version # is correct, then the SEBClientSettings.seb file was not properly replaced and is
       outdated.

Move the faulty file from above to the Trash, then try running the installer again and you should be set.
Otherwise, take the file needed from the “Extras” folder in the .dmg installer and place it in the corresponding
directory which can be found on the “Uninstall” guide below.

Screen Claiming Safe Exam Browser Isn’t Configured Yet When Application is Opened

This means that the configuration file either wasn’t installed or somehow ended up in the incorrect directory
(the application searchs for it in /Library/Preferences).

    •   Run the installer one more time
    •   If the SEBClientSettings.seb file is still not located in the above directory, open the DMG file and enter
        the “Extras” folder. Download the .seb file, right-click and select “Open with “ISBE-ISA SEB Spring
        2022 (2.2.2)””

                                                                                                                   17
Uninstall the Safe Exam Browser (SEB) for macOS
To clear the entire computer of any SEB remnants
    1. Delete the following items (names may vary slightly and not all files may be present on a
        given system).
            a.   /Applications/Safe Exam Browser.app
            b.   /Library/SEBClientSettings.seb
            c.   /Users/username//Library/Preferences/org.safeexambrowser.Safe-Exam-Browser.plist
            d.   /Users/username/Library/Caches/org.safeexambrowser.bt.Safe-Exam-Browser
            e.   /Users/username/Library/Logs/Safe Exam Browser

    2. Launch “Keychain Access.app” and remove items with names relating to SEB from the user’s
       “login” keychain.
    3. Log out and back in or reboot to complete the process.
            a. NOTE: The next time you install/boot up the Safe Exam Browser application after
               removing all the above files, the “Local SEB Settings Have Been Reset Message” will
               appear but can safely be ignore. It will not appear subsequently.
            b. We also recommed re-imaging your testing workstations between test taking windows
               (or at least removing all traces of the SEB). This will make for the smoothest
               experience in upgrading to next year’s application

Troubleshooting Damaged or Incomplete Applications:

*This issue appears to be related to permissions access. If the manual process below is not practical to do for
your entire lab contact support and inquire about getting the development team’s alternate installer.
Alternatively, feel free to re-package the SEB.app using your own packaging software with the needed
permissions if that’s simpler
    1. Move the application with the slashed circle icon to the Trash
    2. Open the DMG file one more time and access the “Extras” folder
    3. Double click the Safe Exam Browser.zip file
    4. Move the uncompressed application file from the downloads folder to the /Applications directory
    5. Open the SEB application to confirm that the system properly reads the file

This section pertains specifically to the 2022 Mac SEB Install process for 10.13+ systems
Installation Process with Images
1. Double-click the ISBE-ISA Mac SEB 2022.dmg. (photo is from 2020)

                                                                                                              18
2. Double-click the “ISBE-ISA Safe Exam Browser 2022.pkg” installer file.

3. Follow the onscreen prompts to complete a typical, macOS installation process.

4. Following the installation process, “ISBE-ISA SEB Spring 2022 (2.2.2)” will be in the
   /Applications folder and the configuration file, “SEBClientSettings.seb” will be in
   /Library/Preferences.
5. Double-click “Safe Exam Browser” to start the ISBE-ISA test.

                                                                                           19
You can also read