Remotely Configuring Mac Teacher Console after Installation

Remotely Configuring Mac Teacher Console after Installation

Update March 26, 2024: Release of macOS 14.4 has broken the ability to use SSID Whitelisting. Anyone currently using SSID Whitelisting, it is recommended to delay updating to macOS 14.4 until this issue has been fixed. 

Overview

If changes need to be made to the LanSchool Teacher Console settings after installation is complete, the lstconfig utility is a tool that can be used to aid in the remote configuration. The lstconfig utility is provided in the LanSchool product download under Mac>> Utilities folder.

Using the lstconfig Utility

This utility can be used in conjunction with ARD. 
Run this tool using sudo in order to change global settings for this device. Otherwise, run lstconfig as user to change Teacher-specific settings.

Usage: lstconfig <key> <newvalue> 

The following is an example to allow the Teacher to change channels: 

sudo ./lstconfig EnableChannelSelect true 

Value names are case-sensitive.

Global Teacher Settings

The following are a list of global settings that can be changed:

Setting
Description
Options
Type
Default

AlertOnUpdate

Controls whether the teacher is alerted when there is an update to LanSchool.  
false=don’t alert 

true=alert 
Boolean
True
AllowAudio 
Controls whether the teacher can listen and talk to students via the console. 
0=don’t allow 

1=allow 
Integer
1
AllowDumpUploads
Controls whether or not crash log files are uploaded to our servers. Crash logs allow us to fix crashes in our software, and no private information is conveyed. 
0=do not allow 

1=allow  
Integer 
0
AllowInternetMonitoring 
Controls whether the LanSchool Student software to record website visits. 
0=do not allow 

1=allow 
Integer
1
AllowKeyboardMonitoring 
Allows the LanSchool Student software to record keystrokes. 
0=do not allow 

1=allow 
Integer 
1
AllowTaskmanLimiting
Controls whether the teacher can prevent Task Manager/Activity Monitor from running  on student computers. Note that this does not activate the feature but merely enables it.  
0=don’t allow 

1=allow 
Integer
1
Authorization
Contains a one-way secure hash of the password for use in verification. Passwords are never stored. 

This value can be copied from 

/Library/Preferences/com.lanschool.student.settings.plist

for a student that has already been properly configured in Secure Mode.
N/A
Integer
0
ClassroomServerAddress 
Contains the name or IP address of your LanSchool Connection Service (LCS).  Examples of this value would be “192.168.2.200” or “LANSCHOOL-LCS”.  A static IP address for the LCS is preferred above a hostname or dynamic IP address.
N/AString
“” (empty string) 
DisableDataTransmission 
Controls whether the teacher can change the network transport settings. 
true=cannot change 

false=can change 
Boolean 
false
EnableChannelSelect 
Controls whether or not the teacher can change her channel. 
false=cannot change channel 

true=can change channel 
Boolean
false
NoRegistration 
Controls whether or not the LanSchool Teacher Console prompts to register the product. 
false=prompts 

true=does not prompt 
Boolean
false
SecureMode
Controls whether the LanSchool Student software communicates with teachers who have entered the correct password in the LanSchool Teacher Console. See also Authorization.
0=off 

1=on 
number
0
StealthMode
Controls whether the Student software hides the system menu bar item.
0=off 

1=on 
Integer
0
UseLegacyScreenGrabber
Reverts to our "old" method of retrieving the screen for Remote Control. If there are issues grabbing the student screen in the Teacher Console, change this setting to see if the old RC method will be more reliable.
false=off

true=on
Boolean
false

Teacher Settings

The following are a list of teacher-specific settings that can be changed:

Setting
Description
Options
Type
Default
Channels
The Teacher Console can view more than one Channel. The channel number must be a number between 1 and 16,000. Can view a maximum of 64 channels. 
N/A
Number 
1
limitTaskManager
Teacher can prevent Task Manager/Activity Monitor from running  on student computers.
false=off

true=on
Boolean
true
LogLevel 
Controls whether or not logs are created by the LanSchool Teacher software. These logs are helpful if you are having issues and seeking              help from our Support team. 
0=logging disabled 

1=logging enabled 
Integer
0
Subnets
List of IP addresses under IP-Directed Broadcast / Connection Server. Minimum 1, maximum 3. 
N/A
String
“” (empty string)
Transport
Sets which Data Transmission option to use; IP-Broadcast, IP-Multicast or IP-Directed Broadcast / Connection Server

0= IP- Broadcast
1= IP- Multicast
2=IP=Directed Broadcast/ Connection Server

Integer
0
useSingleChannel
Allows only one channel to be used.
false=off

true=on
Booleantrue

The Teacher Console should not be running when configuring settings.

Teacher Settings for "Become a Student"

The following are a list of Teacher settings are only used when the teacher "Becomes a Student" or updates a computer running the LanSchool Student:

Setting
Description
Options
Type
Default
AllowInternetMonitoring 
Controls whether the LanSchool Student software records website visits.
0=do not allow 

1=allow  
Integer
0
AllowKeyboard Monitoring
Allows the LanSchool Student software to record website visits. 
0=do not allow 

1=allow 
Integer
1
Authorization

Contains a one-way secure hash of the password for use in verification. Passwords are never stored.

This value can be copied from 

/Library/Preferences/com.lanschool.student.settings.plist

for a student that has already been properly configured in Secure Mode.

N/A
Integer
0
ClassroomServerAddress 
Contains the name or IP address of your LanSchool Connection Service (LCS).  Examples of this value would be “192.168.2.200” or “LANSCHOOL-LCS”.  A static IP address for the LCS is preferred above a hostname or dynamic IP address. 
N/A
String
“” (empty string) 
SecureMode 
Controls whether the LanSchool Student software communicates with teachers who have entered the correct password in the LanSchool Teacher Console. See also Authorization. 
0=off 

1=on 
Number
0
StealthMode 
Controls whether the Student software hides the system menu bar item. 
0=off 

1=on 
Integer
0

After the change in settings are made, you will need to clear the preferences cache for the user.  This can be done either by rebooting/logout, or by running: killall -u <user> cfprefsd


    • Related Articles

    • Installing LanSchool Teacher for macOS

      Update March 26, 2024: Release of macOS 14.4 has broken the ability to use SSID Whitelisting. Anyone currently using SSID Whitelisting, it is recommended to delay updating to macOS 14.4 until this issue has been fixed. Overview The following ...
    • Mass Deploying LanSchool Teacher for macOS

      Update March 26, 2024: Release of macOS 14.4 has broken the ability to use SSID Whitelisting. Anyone currently using SSID Whitelisting, it is recommended to delay updating to macOS 14.4 until this issue has been fixed. Overview LanSchool provides the ...
    • Installing LanSchool Student for macOS

      Update March 26, 2024: Release of macOS 14.4 has broken the ability to use SSID Whitelisting. Anyone currently using SSID Whitelisting, it is recommended to delay updating to macOS 14.4 until this issue has been fixed. Overview The following ...
    • Using the LanSchool Tech Console

      Overview The use model for Tech Console is quite similar to LanSchool Teacher consoles. The Tech Console can be launched from the LanSchool icon in the system tray for Windows or from the dock icon on Mac. The Tech Console includes a number of ...
    • Mass Deploying LanSchool Student for macOS

      Update March 26, 2024: Release of macOS 14.4 has broken the ability to use SSID Whitelisting. Anyone currently using SSID Whitelisting, it is recommended to delay updating to macOS 14.4 until this issue has been fixed. Overview LanSchool provides the ...
    • Popular Articles

    • Limiting Website Use

      Overview To block troublesome or distracting websites or limit students to a select few websites pertinent to the class, use the Limit Web feature in LanSchool Classic. The teacher can choose to restrict all web activity, allow only certain websites, ...
    • LanSchool Classic Teacher Guide

      LanSchool Classic Teacher Console The LanSchool Teacher Console is the interface teachers will use to manage their classroom and students. It contains all the tools necessary for a teacher to effectively interact with students and create a ...
    • Installing LanSchool Teacher for Windows

      Overview The following instructions will assist you with manually installing LanSchool Classic Teacher Console on a single Windows device. For information on installing the student client or mass deploying LanSchool throughout your organization, see ...
    • Latest Release Notes

      LanSchool Classic Release Notes Customers with an active LanSchool subscription will have access to download the latest version from the LanSchool Classic Portal. For instructions, see Downloading LanSchool Installers. LanSchool Classic 9.3.0.12 ...
    • Blanking Student Screens

      Overview Blank student screens on your channel and disable student keyboards and mice. This feature is useful when you want to lecture without the distraction of students playing with their computers, or you need to quickly gather their attention. ...
    • Recent Articles

    • Using Assessment Mode

      Overview Assessment Mode allows an Administrator or Teacher to put student devices into a secure, locked mode in order to take a test or exam. When applied, the students devices enter Assessment Mode. During this mode the Teacher can't interact with ...
    • Downloading LanSchool Classic Installers

      Overview LanSchool Classic Downloads are accessed in LanSchool Air. Classic customers will see all their information, expiration and licensing keys in LanSchool Air. Admins who use both LanSchool Classic and LanSchool Air only need to manage one ...
    • Configuring LCS Redirection

      Overview In multiple LanSchool Connection Service scenarios, LCS Redirection allows administrators to set a default student LCS configuration where a MASTER LCS will send students to their correct LCS. The choice of LCS is configured based on the IP ...
    • Deploying LanSchool Classic Using Jamf Pro

      Update March 26, 2024: Release of macOS 14.4 has broken the ability to use SSID Whitelisting. Anyone currently using SSID Whitelisting, it is recommended to delay updating to macOS 14.4 until this issue has been fixed. Overview The LanSchool Classic ...
    • Disabling Fast User Switching

      Overview LanSchool Classic does not support Windows Fast User Switching feature. The student client will not function properly when the computer is switched to a second user account. It is recommended to disable Fast User Switching in order for the ...