WA-DCYF

This video starts with an October 2020 image and goes through the IT set-up process after imaging.

Imaging Computers at EGCC, NYC, and GH

You will need a black dock with a purple reset USB as well as a red dock and proximity to the DCYF_Education WiFi signal. The most up to date image USBs are labeled Oct20

Image a device:

  1. If necessary, backup student home folder to a USB drive before imaging computers

  2. Dock the laptop (powered off) with a reset USB plugged into the docking station

  3. Boot the computer, at the American Megatrends BIOS screen press Fn + F12 key repeatedly. You should be asked to enter a password. Enter the BIOS password.

  4. Boot to the UEFI USB Drive. Press enter on the first Clonezilla screen and yes up to 3x to confirm the imaging process. The process should run at 4GB/min and take an hour.

After a device has been imaged (estimated time 4-5 minutes per device):

This process was last updated on 10/21/2020

  1. Dock the Securebook on any red docking station (do not connect to any WiFi signal)

  2. Login is as jadmin with the default password

  3. Create a student account by typing users into the desktop search bar

Student accounts are lastnamefirstinitial and password is JRA number

  1. Change the jadmin password

  2. Change the sharedaccount password (this also has admin rights)

  3. Delete the existing 'student' account

  4. Open the terminal (type terminal in desktop search bar)

  5. Check the date and time, we must have a near accurate date and time.

sudo date -s "yyyymmdd hh:mm"

example for October 15,2020 at 3:35PM:

sudo date -s "20201015 15:35"

  1. In terminal, run the WiFi script, if desired by typing in:

./setup-wifi.sh

then press enter and follow the prompts the SSID is:

DCYF_Education

You must have a successful connection to DCYF_Education the first time this script is run

  1. In terminal, enable the user to manage their own printers, if desired by typing in:

sudo adduser username lpadmin

replace username in the above with the student's account name, press enter

  1. In terminal, lock the students password:

sudo passwd username -n 10000

replace username in the above with the student's account name, press enter

  1. Enable ssh access

sudo systemctl enable ssh

  1. Reboot the computer while still on the same dock and confirm WiFi connects

  2. If necessary, replace student documents per the training below

Added on 11/13/2020 & 11/25/2020:

  1. Please also remove this one TED video through the following command in the terminal:

sudo rm -r /var/local/bin/rachel/modules/en-TED-endless/videos/Anas*

sudo rm -r /var/local/bin/rachel/modules/en-TED-endless/videos/Seba*

(there is a single space between -r and /var)

This should be the extent of IT involvement, except to troubleshoot otherwise failing machines. Re-image, provision, deploy, repeat.


Video of restoring student's documents and folders after imaging Endless Justice Securebook

Backup / Restore Student Docs After Imaging from Jadmin

If the IT admin is going to backup and restore student documents

There have been some reported issues when putting saved student files back onto a freshly imaged Endless Justice machine. Following this process precisely should eliminate those issues.

  • From the jadmin account or the student account you can save off student documents to a USB drive. We assume this part does not require additional detail.

  • On a freshly imaged machine, first, create the student account you want

  • While still logged in as jadmin, you can copy the files from the USB. To copy multiple files or folders at one time, click the top most item and hold the shift key while clicking the bottom most icon.

  • Right click on the highlighted selection and click "copy" - do not select "Copy to" - we must first unlock the student's folder before attempting to paste in the new documents

  • Navigate to the student's folder using the navigation window by clicking "+ other locations" -> home -> studentsprofile - or - you can type cntrl + l key which will put you in the top most navigation bar. In the bar you can type: admin:///home/studentsprofile

  • Once you attempt to open the studentsprofile folder in the navigation window you will be promped to authenticate

  • After authentication, you can now right click and "paste"

  • You may then be questioned a number of times to "merge" folders, checking the box at the bottom for "do this for all items" will greatly speed up the process

If you have trouble with permissions during this process, you can always login as the student account directly and copy from the USB drive into the student's home folder.


It is reasonable to offload this task to local program staff, where you have a good local partner. An admin password is not explicitly necessary to save documents to USB, nor to open a student account and put those documents back into a student's folder.

  • Login as the student account while the machine is docked with the USB plugged in

  • Copy the folders and files from the USB to the student account home folder

WiFi Connection on Multiple Docks

To enable a machine to connect to multiple docks without an admin password as well as lock the machines to one WiFi signal (October 2020 imaged machines can jump to step 3)

  1. Either download this package directly to a machine in the home folder of jadmin, or onto a USB stick and then transfer to the machine in jadmin home folder:

TAR PACKAGE / MIRROR (alternate download)

  1. Untar the package and place the contents inside the home folder of jadmin. If the tar package has been saved to the home folder of jadmin, open terminal and type in:

sudo tar -xvf wifi-connect.tar

  1. Open the terminal when logged in as jadmin

  2. Dock the computer on any dock with a WiFi connection available

  3. Type in ./setup-wifi.sh and then press enter

hint: you can type in ./s and then press the tab key which should autocomplete the phrase

  1. Enter the SSID of the signal you wish to connect to, press 1 to confirm it is correct

  2. Enter the password of the signal you wish to connect to, press 1 to confirm

  3. Reboot the computer

Running jconfig Utility

Sometimes there's an issue with an Endless Version. When this happens, World Possible releases an update using a utility script called "jconfig". Here are the steps to running the jconfig Utility. (eos-jconfig-2020-qf3 download)

  1. Download and extract the eos-jconfig-2020-qf3.zip so you have a single folder that contains jconfig and it's files

  2. Make an exFat USB

  3. Drag the folder over to the exFat USB

  4. Place the USB in the black docking station

  5. Log in as jadmin

  6. Open a terminal window

  7. Open a file browser window with the jconfig folder open

  8. Drag the jconfig file to the terminal window

  9. Click on the terminal window and press Enter

  10. Run the update menu option

Additional Information

Find additional helpful Tutorials and Guides about the World Possible Securebook and Endless OS at World Possible Justice Documentation.