Serverinstallatieprogramma

FAQ › EUZOS Server › Serverinstallatieprogramma · English

Wat is het?

Het serverinstallatieprogramma zet EUZOS Server vanaf een USB-stick op de interne schijf (SATA/AHCI, NVMe, of virtio-blk in een virtuele machine) van een server. Het is grafisch, in dezelfde stijl als het installatieprogramma van het bureaublad (keuzescherm, kaarten, licht of donker, muis, toetsenbord en het schermtoetsenbord), en valt terug op een tekstinstallatieprogramma in de console als er geen framebuffer is. Naast de schijf stelt het het netwerk in (DHCP of een vast/publiek adres), de pakketten (serverrollen, eerst Werkplekbeheer) en registreert het na een geslaagde installatie de werkplekserver bij de organisatie van de beheerder op de profielserver. De firewall van de geïnstalleerde server staat standaard dicht.

Hoe doe ik…?

Hoe start ik het installatieprogramma?

Start de server vanaf een EUZOS Server-stick. Omdat hij vanaf USB is gestart, verschijnt het keuzescherm ("Welkom bij EUZOS Server"): Console (vanaf de stick, er verandert niets op de server) of Installeren op deze server (op de interne schijf; alles daarop wordt gewist). Zonder keuze gaat hij na 10 seconden naar de console. Vanuit de console toont installer het keuzescherm opnieuw en start installer text het tekstinstallatieprogramma. Met choice=no (oud keuze=nee, wordt nog gelezen) in \EOS\FW\INSTALL.TXT verschijnt het keuzescherm niet. automatic=yes (de installatiestick van het bureaublad) heeft op de server geen effect: daar beslist alleen crate::setup_choice::must_choose (gestart vanaf een USB-stick, op x86-64, niet choice=no).

Wat zijn de stappen?

Grafisch installatieprogramma (euzos_ui::installation_server):

1. Omgeving (alleen testbuild): SBX of PROD; gaat als PROFILE.TXT naar de nieuwe schijf.
2. Netwerk: de netwerkadapter (standaard die met een verbinding) en DHCP of een vast adres: IP-adres, netmasker of prefix (/24 of 255.255.255.0), gateway, één of twee DNS-servers, en optioneel het externe adres achter NAT (publiek IP-adres of DNS-naam). Alleen IPv4. Het adres geldt meteen (voor de stap Account) en gaat naar de nieuwe schijf.
3. Account: de beheerder logt in of maakt een account (e-mailadres en wachtwoord, met de code uit de mail); geen inloggen met Microsoft. Met dit account wordt de server bij de organisatie geregistreerd.
4. Pakketten: de lijst met serverpakketten, eerst Werkplekbeheer (standaard aan). Pakketten die nog niet af zijn, staan grijs als Binnenkort.
5. Naam van de server (als Werkplekbeheer gekozen is): zo heet hij in Server Admin en bij de beheerder (1 tot 64 tekens; standaard EUZOS Server).
6. Poorten (optioneel): de netwerkadapters, USB-poorten en USB-opslag die in deze machine gevonden zijn, allemaal aan; schakel uit wat de server niet gebruikt (zie hieronder). Verder zonder wijzigingen slaat de stap over.
7. Schijf, 8. Wissen (snel of grondig wissen, of Testen, niet wissen: alleen opnieuw ingedeeld, nooit de standaard, met een waarschuwing en een tweede keer Verder ter bevestiging; zie Desktop-installatieprogramma), 9. Bevestigen (typ de laatste 4 tekens van het serienummer), 10. Voortgang,
   1. Klaar (zet de server uit, haal de stick eruit, zet hem weer aan: de server start in de console).

Hoe schakel ik ongebruikte netwerkadapters of USB-poorten uit bij het installeren?

In de stap Netwerkadapters en USB-poorten heeft elke adapter (PCI-adres, MAC-adres, link), elke USB-poort (een aansluiting met USB 2 en USB 3 is één schakelaar) en USB-opslag (usb-class storage) een schakelaar; alles staat aan. Tik op een schakelaar (of pijltjes en spatie) om hem uit te zetten. Dezelfde veiligheidsregels als op een draaiende server gelden: de adapter die je in de stap Netwerk koos blijft aan, de poort van de installatiestick blijft aan, en de laatste adapter of de poort met het enige toetsenbord uitschakelen vraagt een tweede tik. Wat uit staat, komt op de nieuwe schijf in \EOS\FW\PORTS.TXT; staat alles aan, dan wordt er geen bestand geschreven. Later wijzigen kan met Server Admin › Poorten (zie Poorten).

Hoe stel ik een vast of publiek IP-adres in?

Kies in de stap Netwerk Vast adres en vul de velden in. Een ongeldig adres, een IPv6-adres, een netwerk- of broadcastadres of een gateway buiten het subnet geeft een melding bij het veld. Een publiek adres mag: dan verschijnt de melding "deze server is direct vanaf internet bereikbaar. De firewall staat dicht; poorten open je met Server Admin." Na de installatie wijzig je het met network op de console of met Server Admin (zie Netwerk en firewall).

Waarom staat de firewall na het installeren dicht?

Besluit van de eigenaar: een EUZOS Server is inkomend standaard helemaal dicht, met of zonder publiek adres. Alleen het beheerprotocol van Server Admin (TCP 8446) vanuit het eigen subnet staat open (in een testbuild ook SSH vanuit het eigen subnet). Het scherm Klaar herinnert je eraan: "De firewall staat dicht: open de cache (poort 8445) met Server Admin." Zie Netwerk en firewall.

Wat als de registratie mislukt?

Het scherm Klaar zegt "De server is niet geregistreerd (reden); dat kan later". Redenen van de profielserver: het account is geen beheerder van een organisatie (geen_beheerder), het account beheert meerdere organisaties (kies_organisatie), de sleutel is al geregistreerd (al_geregistreerd), of te veel registraties (te_vaak). Hij kan dan later op de profielserver geregistreerd worden (zie Organisaties).

Wordt het wachtwoord van de beheerder op de server bewaard?

Nee. Het wachtwoord zit alleen tijdens het verzoek in de kernel; het pc-token van de stap Account blijft in het RAM en wordt na de installatie afgemeld.

Hoe gebruik ik het tekstinstallatieprogramma?

installer text in de console. Elke stap verschijnt als tekst; je typt een regel en drukt op Enter. stop gaat terug naar de console (behalve op het scherm Klaar), back gaat een stap terug. Stap Netwerk: Enter = volgende, r = opnieuw kijken. Pakketten: typ het nummer van een pakket om het aan of uit te zetten, Enter = volgende. Voor Werkplekbeheer vraagt hij daarna de naam en de koppeling: de naam van de organisatie of een registratiecode; beide gaan alleen als hint voor de beheerder in WORKPLC.TXT. Schijf: typ het nummer (of r om opnieuw te zoeken). Wissen: 1 snel (alleen SSD; de standaard op een SSD), 2 grondig (de standaard op een harde schijf) of 3 "Quick install for testing: don't wipe, only repartition" (snel installeren om te testen: niet wissen, alleen opnieuw indelen; oude gegevens blijven terug te halen; minuten in plaats van een uur of langer); Enter houdt de getoonde keuze. Na 3 volgt een waarschuwing (de oude gegevens zijn met simpele hulpmiddelen terug te halen; alleen als er niets vertrouwelijks op staat). Bevestigen: typ de code precies, namelijk WIPE-<serienummer> (het serienummer, letters, cijfers en -; het oude WIS-<serienummer> wordt nog geaccepteerd); zonder wissen de code en NO-WIPE, bv. WIPE-S0EXAMPLE1234 NO-WIPE. Het tekstinstallatieprogramma heeft geen stap Account en registreert de server niet; registreer hem daarna op de profielserver (zie Organisaties).

Details

• Installeren gaat vanaf de stick zelf (install::install_internal met Source::Stick): het ondertekende manifest \EOS\MANIFEST.TXT en alle bestanden worden gecontroleerd voordat er iets gewist wordt; daarna wordt alles teruggelezen. Hij weigert de opstartschijf en schijven zonder bruikbaar serienummer of die te klein zijn. Alleen op x86-64.
• Er gaan geen wifibestanden en geen apps (Chromium) mee: dat is EUZOS Desktop.
• Bestanden die naar de nieuwe schijf gaan (\EOS\FW\):
  • het rolbestand van elk gekozen pakket (Werkplekbeheer: WORKPLC.TXT met de naam; zie Pakketten);
  • voor Werkplekbeheer de sleutels WPKEY.TXT (Ed25519) en WPTLS.TXT (P-256 voor TLS), op deze machine gemaakt en alleen naar de nieuwe schijf geschreven;
  • het netwerkbestand NETWORK.TXT (vast adres per MAC-adres, extern adres), alleen als een adapter een vast adres heeft of er een extern adres is ingesteld;
  • het taalbestand LANG.TXT (language=<code>, als er een taal gekozen is);
  • PORTS.TXT met wat in de stap Poorten is uitgeschakeld (alleen als er iets uit staat; zie Poorten);
  • PROFILE.TXT met de omgeving (testbuild; environment=, key=, key-id=, …);
  • in een testbuild dev-ssh=yes in het rolbestand (SSH voor ontwikkeling).
• Registratie: na een geslaagde installatie stuurt crate::server_setup_choice::register de publieke werkpleksleutel, de naam en het externe adres met het pc-token van de stap Account naar de profielserver. De werkplekserver verschijnt dan in Server Admin bij die beheerder met naam, account, installatiedatum en extern adres.
• De stappen en de logica van het tekstinstallatieprogramma zitten in euzos_install::server (Installer, Step), getest op de ontwikkelmachine.

Naslag

Consoleopdrachten

Invoer van het tekstinstallatieprogramma (euzos_install::server::Installer::line):

Functies en modules

Configuratiebestanden

API-eindpunten

Aangeroepen door het installatieprogramma op de profielserver (details in API):

De kernel roept nu het oude pad aan.

Protocolberichten en formaten

Inhoud van het registratieverzoek (regels sleutel=waarde, draadformaat, blijft Nederlands): sleutel=<publieke sleutel, 64 hex>, naam=<naam>, optioneel extern=<extern adres>. Antwoord: ok met werkplek=<id> en organisatie_naam= / organisatie=, of een fout met reden=<code> (geen_beheerder, kies_organisatie, al_geregistreerd, te_vaak, …).

Zie ook

• docs/EDITIONS.md ("The server installer")
• docs/INSTALLING.md
• Pakketten, Netwerk en firewall, Organisaties