Sideversjonen fra 7. mar. 2025 kl. 12:29

skolelinux-netboot

kilde: https://git.nuug.no/nuug-public/skolelinux-netboot

Dette depotet inneholder mulige oppgaver for å sette opp en netboot-server med det eneste formålet å hjelpe til med å sette opp bærbare datamaskiner i NUUG/Skolelinux dugnad. Det er veldig spesifikt for vår nåværende bruk, og kan være nyttig for noen andre.

Bare Debian 12 har blitt testet.

Kom i gang

Du trenger en vanlig datamaskin med to nettverksporter. Ut fra dine behov, kan det hende det er ok med wifi til internett, og en ethernet-port (native eller usb-dongle) til det lokale pxe/netboot-nettverket. For større og mer stabile oppsett anbefales en datamaskin med to fysiske Ethernet-porter.

Etter du har installert standard Debian 12-installasjon, konfigurer din andre nettverksport for det lokale nettverket du skal nettstarte på. Sørg for at du har et stort nok subnett til å inneholde antall klienter du vil nettstarte til enhver tid.

Nettverket som er konfigurert på dette grensesnittet, vil også bli konfigurert senere for DHCP-serveren.

Sørg for at du oppgraderer alle tilgjengelige pakker, og etter at du har gjort oppsettet, start nettboot-verten på nytt for å sikre at den kjører den nyeste kjernen og at nettverksportene har sine IP-adresser etter behov.

Du må installere ansible og git på netboot-verten først:

a) Hvis du installerte Debian 12 netinstall, kjør følgende for å være root:

su -

Skriv inn passordet for brukerkontoen din og du er root.

b) Ellers hvis du installerte Debian 12 kde live, kjør denne kommandoen for å være root:

sudo -i

Skriv inn passordet for brukerkontoen din og du er root.

apt install ansible git

Kjør deretter ansible-pull for å kjøre oppgavene fra dette depotet:

Deretter kan du klone det offentlige git-depotet som brukes til å sette opp resten av netboot-infrastrukturen:

git-klone https://git.nuug.no/nuug-public/skolelinux-netboot.git

Dette vil opprette katalogen skolelinux-netboot/ som inneholder den aktuelle spilleboken og andre data som trengs for å konfigurere netboot-verten.

cd skolelinux-netboot

Konfigurer lokale innstillinger

Før du kjører spilleboken, må du lage en fil local-vars.yml (denne filen ignoreres av git) som inneholder verdier den mulige spilleboken vil bruke under oppsettet. Bruk favorittredigeringsprogrammet for å lage filen, og fyll den med følgende data:

internet_interface: "eno1" # Grensesnittnavn som har internettilgang

# DHCP-serverkonfigurasjon
dhcpd_interface: "enx7cc2c6469631" # Grensesnittnavn for lokalt netboot-nettverk
dhcpd_subnet_network: "192.168.100.0" # Nettverksadresse for lokalt nettverk
dhcpd_subnet_netmask: "255.255.252.0" # Nettverksnettmaske for lokalt nettverk
dhcpd_pool_start: "192.168.100.50" # Startadresse for DHCP IP-pool
dhcpd_pool_end: "192.168.103.250" # DHCP IP-utvalgsadresse
dhcpd_option_routers: "192.168.100.1" # Gateway for lokalt nettverk (din netboot-vert!)
dhcpd_option_domainnameservers: "1.1.1.1,1.0.0.1" # DNS-servere som skal sendes til klienter
dhcpd_option_nextserver: "192.168.100.1" # Netboot PXE-server (din netboot-vert!)

# Fullt navn, brukernavn og klartekstpassord for ønsket ikke-root
# bruker skal opprettes under forhåndsinnstilling. Dette kommer til å være brukeren som
# logges automatisk inn som kioskbruker.
preseed_user_fullname: ""
preseed_username: ""
preseed_user_password: ""

# Brukernavn og passord som vil bli konfigurert i ProFTP og som ShredOS vil
# bruk for å laste opp PDF-rapporter # etter makulering av disker.
proftpd_shredos_user: "noen bruker"
proftpd_shredos_pass: "noe pass"

# En liste over givere av bærbare datamaskiner. VIKTIG: Bruk kun små og oppalfanumeriske bokstaver
# (a-z, A-Z, 0-9), ingen mellomrom! Hver giver vil få sin egen ShredOS netboot-meny
# valg, og deres egen ShredOS-loggkatalog.
givere:
- "storselskap"
- "distrikt 123"

Nå skal du kunne kjøre spilleboken som vil utføre alle nødvendige konfigurasjonsoppgaver. Dette kan ta litt tid.

ansible-playbook netboot-host-setup.yml -D

Det er sannsynligvis en god idé å starte nettboot-verten på nytt etter dette (forutsatt at alt gikk bra), for å sikre at tjenestene starter ved oppstart (DHCP-server, ProFTPd, Apt-cacher-ng). Du kan sjekke med f.eks.:

systemctl status proftpd.service
systemctl-status isc-dhcp-server.service
systemctl-status apt-cacher-ng.service

Du skal nå kunne bruke denne verten i det lokale nettverket der du utfører Skolelinux-installasjonene. Denne verten skal være den eneste DHCP-serveren i nettverket, og gateway-IP-en må samsvare med det som blir presset av denne verten over DHCP.

Hvis det er noen endringer i local-vars.yml-filen, bør du bare kunne kjøre spilleboken på nytt, og systemet vil bli rekonfigurert tilsvarende.

If there are any new development for this setup made available in the git repository, you can update your files, by running a git command while being in the skolelinux-netboot/ directory:

git pull

To apply the latest changes, re-run the ansible playbook again.

Disable Suspend/Hvilemodus på preseed-maskinen

When this is not disabled the computers getting tanked from the preseed machine wil stop installing as we have experienced xD

a) Go to systemsettings/systeminnstillinger -> Strømstyring/Powermanagement -> ta av haken i Lås økt / Lock session and click on Bruk/Use

Share wireless internett to the netboot machine

a) Either start a preinstalled Debian 12 kde laptop with both wireless and ethernet network (cable), or boot a Debian live KDE from a USB-stick

b) When the system is started to Desktop -> left click the network icon in the bottom right corner and connect to a wireless network. Example Rebel-Network

c) Right click the network icon in the right corner of the screen again and do: > Configure Network Connections/Sett opp nettverkskoblinger -> Wired Connection 1 -> Kablet Forbindelse 1 -> IPv4 (tab/fane -> Method/Metode -> Shared to other computers / Delt til andre datamaskiner -> Use/Bruk

d) Go to settings -> powermanagement/strømstyring -> On AC Power/På nettstørm (tab/fane) -> remove check mark for Lock session -> On battery/På batteridrift > remove check mark for Lock session -> On Low Battery/Lavt batterinivå remove check mark for Lock session -> click Use/Bruk

e) Connect a network cable from the network card on the laptop to Internet in network card on the preseed machine.

@@ Linje 41: / Linje 41: @@
 === Konfigurer lokale innstillinger ===
-<div lang="en" dir="ltr" class="mw-content-ltr">
+Før du kjører spilleboken, må du lage en fil <code>local-vars.yml</code> (denne filen ignoreres av git) som inneholder verdier den mulige spilleboken vil bruke under oppsettet. Bruk favorittredigeringsprogrammet for å lage filen, og fyll den med følgende data:
-Before running the playbook, you need to create a file <code>local-vars.yml</code> (this file is ignored by git) containing values the ansible playbook will use during the setup. Use your favourite editor to create the file, and fill it with the following data:
+  internet_interface: "eno1" # Grensesnittnavn som har internettilgang
-  internet_interface: "eno1" # Interface name that has internet access
+  # DHCP-serverkonfigurasjon
-  # DHCP server configuration
+  dhcpd_interface: "enx7cc2c6469631" # Grensesnittnavn for lokalt netboot-nettverk
-  dhcpd_interface: "enx7cc2c6469631" # Interface name for local netboot network
+  dhcpd_subnet_network: "192.168.100.0" # Nettverksadresse for lokalt nettverk
-  dhcpd_subnet_network: "192.168.100.0" # Network address for local network
+  dhcpd_subnet_netmask: "255.255.252.0" # Nettverksnettmaske for lokalt nettverk
-  dhcpd_subnet_netmask: "255.255.252.0" # Network netmask for local network
+  dhcpd_pool_start: "192.168.100.50" # Startadresse for DHCP IP-pool
-  dhcpd_pool_start: "192.168.100.50" # DHCP IP pool start address
+  dhcpd_pool_end: "192.168.103.250" # DHCP IP-utvalgsadresse
-  dhcpd_pool_end: "192.168.103.250" # DHCP IP pool end address
+  dhcpd_option_routers: "192.168.100.1" # Gateway for lokalt nettverk (din netboot-vert!)
-  dhcpd_option_routers: "192.168.100.1" # Gateway for local network (your netboot host!)
+  dhcpd_option_domainnameservers: "1.1.1.1,1.0.0.1" # DNS-servere som skal sendes til klienter
-  dhcpd_option_domainnameservers: "1.1.1.1,1.0.0.1" # DNS servers to push to clients
+  dhcpd_option_nextserver: "192.168.100.1" # Netboot PXE-server (din netboot-vert!)
-  dhcpd_option_nextserver: "192.168.100.1" # Netboot PXE server (your netboot host!)
+  # Fullt navn, brukernavn og klartekstpassord for ønsket ikke-root
-  # Full name, username and cleartext password of your desired non-root
+  # bruker skal opprettes under forhåndsinnstilling. Dette kommer til å være brukeren som
-  # user to be created during preseed. This is going to be the user that
+  # logges automatisk inn som kioskbruker.
-  # is automatically logged in as the kiosk user.
   preseed_user_fullname: ""
   preseed_username: ""
   preseed_user_password: ""
-  # Username and password that will be configured in ProFTP and that ShredOS will
+  # Brukernavn og passord som vil bli konfigurert i ProFTP og som ShredOS vil
-  # use to upload PDF reports # after shredding of disks.
+  # bruk for å laste opp PDF-rapporter # etter makulering av disker.
-  proftpd_shredos_user: "someuser"
+  proftpd_shredos_user: "noen bruker"
-  proftpd_shredos_pass: "somepass"
+  proftpd_shredos_pass: "noe pass"
-  # A list of donors of laptops. IMPORTANT: Use only lowercase and uppalphanumeric
+  # En liste over givere av bærbare datamaskiner. VIKTIG: Bruk kun små og oppalfanumeriske bokstaver
-  # (a-z, A-Z, 0-9), no spaces! Each donor will get their own ShredOS netboot menu
+  # (a-z, A-Z, 0-9), ingen mellomrom! Hver giver vil få sin egen ShredOS netboot-meny
-  # choice, and their own ShredOS logs directory.
+  # valg, og deres egen ShredOS-loggkatalog.
-  donors:
+  givere:
-   - "bigcompany"
+ - "storselskap"
-   - "district123"
+ - "distrikt 123"
-Now you should be able to run the playbook that will perform all the necessary configuration tasks. This might take a little while.
+Nå skal du kunne kjøre spilleboken som vil utføre alle nødvendige konfigurasjonsoppgaver. Dette kan ta litt tid.
   <code>ansible-playbook netboot-host-setup.yml -D</code>
-It's probably a good idea to reboot your netboot host again after this (assuming all went well), to make sure services start at boot (DHCP server, ProFTPd, Apt-cacher-ng). You can check with e.g.:
+Det er sannsynligvis en god idé å starte nettboot-verten på nytt etter dette (forutsatt at alt gikk bra), for å sikre at tjenestene starter ved oppstart (DHCP-server, ProFTPd, Apt-cacher-ng). Du kan sjekke med f.eks.:
   systemctl status proftpd.service
-  systemctl status isc-dhcp-server.service
+  systemctl-status isc-dhcp-server.service
-  systemctl status apt-cacher-ng.service
+  systemctl-status apt-cacher-ng.service
-You should now be able to use this host in the local network where you are performing the Skolelinux installations. This host should be the only DHCP server in the network, and the gateway IP must match what is being pushed by this host over DHCP.
+Du skal nå kunne bruke denne verten i det lokale nettverket der du utfører Skolelinux-installasjonene. Denne verten skal være den eneste DHCP-serveren i nettverket, og gateway-IP-en må samsvare med det som blir presset av denne verten over DHCP.
-</div>
-<div lang="en" dir="ltr" class="mw-content-ltr">
+Hvis det er noen endringer i <code>local-vars.yml</code>-filen, bør du bare kunne kjøre spilleboken på nytt, og systemet vil bli rekonfigurert tilsvarende.
-If there are any changes in your <code>local-vars.yml</code> file, you should be able to simply re-run the playbook, and the system will be reconfigured accordingly.
-</div>
 <div lang="en" dir="ltr" class="mw-content-ltr">