Purpose
This document will show the setup and use of the KDS2 Installer USB image.
Process
USB Creation
There are two ISO images that can be used. One is for prod and one is for staging:
- kds2installer-stage-u22-250328.iso
- kds2installer-prod-u22-250328.iso
USB Required format:
- NTFS
- ExFAT
This ISO has a file that is over 4GB so FAT32 will not work properly. Do not use FAT32.
Example settings from Rufus:
Open image-20250331-153457.png
image-20250331-153457.png
USB Install
Requirements:
- USB
- Keyboard
- KDS Device powered off
Plug the USB and Keyboard into the KDS device.
TES Mach1
The TES Mach1 BIOS doesn’t have a shortcut to the boot menu for some reason.
BIOS Boot
Power on device
Press DEL or ESC when prompted
Use left and right arrow keys to navigate to Boot tab
Use up and down arrow keys to highlight Boot Option #1
Open 20250331_105323-20250331-161030.jpg
20250331_105323-20250331-161030.jpg
Press Enter to to open the sub-menu
Use arrow keys and enter to select:
UEFI USB DEVICE: UEFS: USB DISK 2.0 PMAP . PARTITION 1
Open 20250331_105335-20250331-161004.jpg
20250331_105335-20250331-161004.jpg
Press F4 to Save and Exit
Yes should be default highlighted - press enter
The grub menu for the KDS2Installer should pop up and will auto start in 5 seconds. Enter to skip the wait.
Open 20250331_105454-20250331-160844.jpg
20250331_105454-20250331-160844.jpg
All other Devices
This includes:
TES i3 - IC-156P-AW3
FEC - PP-9645C
AOpen - DE3650-S
AOpen - DE3450 X
AOpen - DE3250-S
Boot Menu
Power on device
Press F12 when you would normally press ESC or DEL
Use the arrow keys and enter to select:
UEFI: USB DISK 2.0 PMAP, PARTITION 1
Note: If you see NTFS or FAT options within the UEFI, choose NTFS
Open 20250331_105416-20250331-160930.jpg
20250331_105416-20250331-160930.jpg
The grub menu for the KDS2Installer should pop up and will auto start in 5 seconds. Enter to skip the wait.
Open 20250331_105454-20250331-160844.jpg
20250331_105454-20250331-160844.jpg
Ubuntu Install - Cloud Init
Once the USB install starts, this will be the first action taken.
This will be automatic and no user interaction is needed. There will be a lot of output.
Open image-20250331-161635.png
image-20250331-161635.png
This will take about 10 minutes. Once completed the device will shutdown and the USB can be pulled.
The BIOS may need to be updated to look at the Hard Drive again.
KDS2Installer Application
Overview
The application will automatically start when the device boots
This program has the three main steps in tabs that can be navigated to by pressing on them. The steps should complete without any assistance from the operator.
Step
Name
Objective
Step 1 - Initial Setup
get-minion-id.service
This will show the progress of the service. If it is successful then we should also get the Minion ID on the top right.
Step 1 - Initial Setup
snap-install.service
Installs snap applications such as chromium-browser
Step 2 - Salt Operations
set-software
Set the salt software grain to kds2
Step 2 - Salt Operations
kds-install
Run the salt state kds.install
Step 3 - KDS Running
kds_2_epmd.service
Monitor the KDS 2 network component service
Step 3 - KDS Running
kds_2.service
Monitor the KDS 2 service
Step 3 - KDS Running
chromium.service
Monitor the Chromium browser service
Open image-20250331-162528.png
image-20250331-162528.png
Open image-20250331-162950.png
image-20250331-162950.png
Open image-20250331-163006.png
image-20250331-163006.png
Success
Once all three steps show completed then there will be a button to switch to the KDS software
Open image-20250331-163535.png
image-20250331-163535.png
Pressing this will stop and disable the KDS2Installer.service so it will not run again. It should then show the normal setup screen.
Open image-20250331-164732.png
image-20250331-164732.png
Failures
Each action within the steps has the possibility to fail due to unforeseen issues such as network disruptions or otherwise. If an action fails then it will get a button under it to restart it to try again.
Open image-20250331-164616.png
image-20250331-164616.png
After Installation
Once the KDS2 software is installed and running the Operator will need to contact Support to finish the setup of the device through KDSAPI and ADM.