.\"----------------------------------------------------------------------------- .\" Man-pagina voor kzinstall. .\" .\" Geschreven door Karel Zimmer . .\" .\" Auteursrecht © 2019-2020 Karel Zimmer. .\" Creative Commons Naamsvermelding-GelijkDelen 4.0 Internationaal-licentie .\" .\" .\" REL_NUM=03.02.03 .\" REL_DAT=2020-10-14 .\" REL_MSG='Controle en toelichting installatiebestanden aangepast' .\"----------------------------------------------------------------------------- .TH "KZINSTALL" "1" "" "kzscripts 365" "kzinstall" .SH NAAM kzinstall \- Apps installeren .SH SAMENVATTING .B kzinstall [OPTIE...] [--] [\fIAPP\fR...] [\fIBESTAND\fR...] .SH BESCHRIJVING \fBkzinstall\fR installeert apps en wijzigt systeeminstellingen. De opdrachten die standaard meegeleverd worden bij \fBkzinstall\fR zijn idempotent; herhaaldelijk utvoeren leidt steeds tot hetzelfde resultaat. Standaard wordt met \fBkzinstall\fR het bestand\ /usr/bin/kzinstall---\fIEDITIE\fR.sh verwerkt voor algemene apps en systeeminstellingen voor de huidige (e.g. ubuntu), (e.g. 20.04), en \fIEDITIE\fR (standaard=desktop). Als bestand\ /usr/bin/kzinstall---\fIEDITIE\fR-.sh aanwezig is wordt deze daarna verwerkt voor apps en systeeminstellingen voor de huidige computer, . Standaard wordt als \fIEDITIE\fR desktop gebruikt, met optie \fB--editie\fR is dat aan te passen (e.g. \fIEDITIE\fR server). Optie \fB--files\fR geeft een lijst van alle installatiebestanden voor de huidige distributie, e.g. ubuntu. .br Het is mogelijk om \fIBESTAND\fRen op te geven; deze bestanden dienen te beginnen met '\fBinstal-\fR' en te eindigen met '\fB.sh\fR'. Iets anders wordt beschouwd als een \fIAPP\fR, zie hierna. Voor de indeling van installatiebestanden zie de sectie \fBBESTANDSINDELING\fR hieronder. Optie \fB--apps\fR geeft een lijst van apps die beschikbaar zijn. .br Het is mogelijk om \fIAPP\fRs op te geven. Als \fIAPP\fRs zijn opgegeven worden de regels van deze app opgezocht in een installatiebestand en worden de regels gekopieerd naar een tijdelijk bestand\ '/tmp/kzinstall-\fIAPP\fR-XXXXXXXXXX.sh'. .br Het tijdelijke bestand wordt opgenomen in de lijst van te verwerken bestanden. Gebruik \fBkzsetup\fR voor het aanpassen van de gebruikersinstellingen. .SH BESTANDSINDELING De te verwerken bestanden dienen te beginnen met '\fBkzinstal-\fR' en te eindigen met '\fB.sh\fR'. De regels worden verwerkt op de volgorde zoals deze in het bestand voorkomen. .br De opdrachten standaard meegeleverd bij \fBkzinstall\fR zijn zodanig opgesteld dat bij herhaaldelijk uitvoeren het resultaat hetzelfde blijft; idempotentie. Zie \fBTabel 1\fR voor welke \fBsoorten\fR regels er zijn en hoe deze regels verwerkt worden. Zie \fBTabel 2\fR voor de \fBvolgorde\fR van deze regels in een installatiebestand. .TS box; cb s s lb | lb | lb l | c | l. Tabel 1. Soorten regels en hun verwerking = Regelsoort Verplicht Beschrijving = #@\fIAPP\fR Nee Wordt gebruikt om regels te vinden voor \fIAPP\fR. #1 Ja Bevat een beschrijving. .\" Eerder afbreken, anders regellengte > 80 door de tabs. #2 Nee Bevat aanvullende instructies na het installeren \ van \fIAPP\fR; voor optie info. .\" Eerder afbreken, anders regellengte > 80 door de tabs. #3 Nee Bevat instructies voor het verwijderen van \fIAPP\fR; voor \ optie remove-info. Nee Wordt overgeslagen (is leeg). # Nee Wordt overgeslagen (is commentaar). * Ja Wordt als opdracht verwerkt (idempotent). .TE .sp .br .TS box; cb s lb | lb l | l. Tabel 2. Volgorde van regels in een installatiebestand = Regel Beschrijving = #\ --------------------------------------------- Commentaar. #\ Software installeren " #\ --------------------------------------------- " Lege regel. #@google-chrome \fIAPP\fR-tag voor Google Chrome. #1 Google Chrome - De webbrowser van Google Beschrijving. sudo apt-get install --yes google-chrome-stable Opdracht. #2 1. Start Start Google Chrome Aanvullende installatie-instructies; voor \ optie info. #2 2. Controleer de werking " #3 Start Terminalvenster en voer uit: Verwijder-instructies; voor optie \ remove-info. #3 sudo apt remove google-chrome-stable " .TE .sp .br In een grafische werkomgeving zoals GNOME (e.g. Ubuntu) kan \fBkzinstall\fR worden gestart door te zoeken naar \fBapps\fR, klik op \fBApps installeren\fR. .SH OPTIES Lange opties kunnen worden afgekort, zolang de afkorting uniek blijft. Een argument dat verplicht of optioneel is voor een lange optie, is dat ook voor de overeenkomstige korte optie. .TP \fB-a\fR, \fB--apps\fR Toon een lijst van te installeren apps. .TP \fB-c\fR, \fB--cat\fR Toon de inhoud van de (opgegeven) installatiebestanden. Ieder bestand wordt voorafgegaan door een commentaarregel met de bestandsnaam. .TP \fB-e\fR, \fB--edition=\fIEDITIE\fR Gebruik editie \fIEDITIE\fR. .TP \fB-f\fR, \fB--files\fR Toon een lijst van alle installatiebestanden. .TP \fB-i\fR, \fB--info\fR Toon aanvullende instructies na het installeren van de apps. .TP \fB-r\fR, \fB--remove-info\fR Toon instructies voor het verwijderen van de apps. .TP \fB-s\fR, \fB--simulate\fR Geen actie, maar simuleer de installatie, en toon de opdrachten die uitgevoerd zouden worden. .TP \fB-d\fR, \fB--debug\fR Geef foutopsporingsinformatie weer in het logboek (gebruik 'journalctl -ab -t kzinstall'). .TP \fB-g\fR, \fB--gui\fR Start in grafische modus (gui = graphical user interface). .TP \fB-h\fR, \fB--help\fR Toon een een korte omschrijving van de beschikbare opties. .TP \fB-u\fR, \fB--usage\fR Toon de beschikbare opties. .TP \fB-v\fR, \fB--version\fR Toon de versie, de auteur, en het auteursrecht. .TP \fB--\fR Een -- geeft het einde van de opties aan en schakelt de verdere verwerking van opties uit. Alle argumenten na de -- worden behandeld als bestandsnamen en argumenten. Een argument van - is gelijk aan --. .SH STOPSTATUS Normaal wordt afsluitwaarde 0 teruggegeven; als er een fout optreedt, is de afsluitwaarde 1. Als er een waarschuwing optreedt, is de afsluitwaarde 2. .SH BESTANDEN /usr/bin/bin/kzcommon.sh .RS Scripts variabelen en functies. .RE /usr/bin/kzinstall-ubuntu--\fIEDITIE\fR.sh .RS Standaard installatiebestand als er geen \fIBESTAND\fRen zijn opgegeven, \ \fIEDITIE\fR is standaard desktop. .RE /usr/bin/kzinstall-ubuntu--\fIEDITIE\fR-.sh .RS Standaard installatiebestand als er geen \fIBESTAND\fRen zijn opgegeven, \ \fIEDITIE\fR is standaard desktop. .RE /usr/share/applications/kzinstall .RS Bureaublad-configuratiebestand. .RE /usr/share/bash-completion/completions/kzinstall .RS Tab-completion-script. .RE /usr/share/polkit-1/actions/nl.karelzimmer.kzinstall.policy .RS PolicyKit actiedefinitiebestand. .RE /tmp/kzinstall-\fIAPP\fR-XXXXXXXXXX.sh .RS Tijdelijk installatiebestand voor \fIAPP\fR. .RE .SH NOTITIES .IP " 1." 4 Checklist installatie .RS 4 https://karelzimmer.nl .RE .SH AUTEUR Geschreven door Karel Zimmer . .SH ZIE OOK \fBkzcommon.sh\fR(1), \fBkzmenu\fR(1), \fBkzsetup\fR(1), \fBhttps://karelzimmer.nl\fR .\" EOF