.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\" Man-pagina voor kzinstall. .\" .\" Geschreven door Karel Zimmer . .\" .\" Auteursrecht (c) 2019-2021 Karel Zimmer. .\" Creative Commons Naamsvermelding-GelijkDelen Internationaal-licentie .\" . .\" .\" RelNum=04.04.02 .\" RelDat=2021-03-30 .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\" .TH KZINSTALL 1 "kzinstall" "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. .sp De opdrachten die standaard meegeleverd worden bij \fBkzinstall\fR zijn idempotent; herhaaldelijk utvoeren leidt steeds tot hetzelfde resultaat. .sp Standaard wordt met \fBkzinstall\fR het bestand\ '/usr/bin/kzinstall---\fIEDITIE\fR.sh' verwerkt. .br Dit bestand bevat opdrachten voor het installeren van apps en het wijzigen van systeeminstellingen voor de huidige (e.g. ubuntu), (e.g. 20.04), en \fIEDITIE\fR (standaard=desktop). .sp Als bestand\ '/usr/bin/kzinstall---\fIEDITIE\fR-.sh' aanwezig is wordt deze daarna verwerkt met opdrachten voor de huidige computer, . .sp Standaard wordt als \fIEDITIE\fR desktop gebruikt, met optie \fB--editie\fR is dat aan te passen (e.g. \fIEDITIE\fR server). .sp 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'. .br Iets anders wordt beschouwd als een \fIAPP\fR, zie hierna. .sp Voor de indeling van installatiebestanden zie de sectie \fBBESTANDSINDELING\fR hieronder. .sp Optie \fB--apps\fR geeft een lijst van apps die beschikbaar zijn. .br Het is mogelijk om \fIAPP\fRs op te geven. .sp 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. .sp 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. .sp 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'. .sp 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. .sp Zie \fBTabel 1\fR voor welke \fBsoorten\fR regels (eerste twee posities op een regel) er zijn en hoe deze regels verwerkt worden. .sp Zie \fBTabel 2\fR voor een voorbeeld van de \fBvolgorde\fR van deze regels in een installatiebestand. Meer voorbeelden zijn te zien via de opdracht \fBkzinstall --cat\fR. .sp .sp .br .B Tabel 1. Soorten regels en hun verwerking .TS allbox tab(:); lb | lb. T{ Regelsoort T}:T{ Beschrijving T} .T& l | l l | l l | l l | l l | l l | l. T{ #1 APP T}:T{ Wordt gebruikt om regels te vinden voor APP. T} T{ #2 BESCHRIJVING T}:T{ Bevat een BESCHRIJVING van de opdrachten. T} T{ #3 INSTRUCTIE T}:T{ Bevat eventuele INSTRUCTIEs voor het installeren van APP. T} T{ #4 INSTRUCTIE T}:T{ Bevat eventuele INSTRUCTIEs voor het verwijderen van APP. T} T{ .sp T}:T{ Wordt overgeslagen (is leeg). T} T{ # T}:T{ Wordt overgeslagen (is commentaar). T} T{ * T}:T{ Wordt als opdracht verwerkt (idempotent). T} .TE .sp .sp .br .B Tabel 2. Volgorde van regels in een installatiebestand .TS box tab(:); lb | lb. T{ Regelsoort T}:T{ Beschrijving T} .T& - | - l | l l | l l | l l | l l | l l | l l | l l | l l | l. T{ # Software installeren T}:T{ Commentaar. T} T{ .sp T}:T{ Lege regel. T} T{ #1 google-chrome T}:T{ Naam voor Google Chrome; voor argument APP. T} T{ #2 Google Chrome installeren T}:T{ Beschrijving. T} T{ sudo apt-get install --yes google-chrome-stable T}:T{ Opdracht. T} T{ #3 1. Start Start Google Chrome. T}:T{ Installatie-instructies; voor optie install-info. T} T{ #3 2. Controleer de werking. T}:T{ " " T} T{ #4 Start Terminalvenster en voer uit: T}:T{ Verwijder-instructies; voor optie remove-info. T} T{ #4 sudo apt remove google-chrome-stable T}:T{ " " T} .TE .\" .\" .SH OPTIES .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. .br 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--install-info\fR Toon instructies voor het installeren van apps. .TP \fB-r\fR, \fB--remove-info\fR Toon instructies voor het verwijderen van 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. .br 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. .br Als er een waarschuwing optreedt, is de afsluitwaarde 2. .\" .\" .SH BESTANDEN /usr/bin/kzinstall-ubuntu--\fIEDITIE\fR.sh .RS Standaard installatiebestand als er geen \fIBESTAND\fRen zijn opgegeven, \ \fIEDITIE\fR is standaard desktop. .RE .sp /usr/bin/kzinstall-ubuntu--\fIEDITIE\fR-.sh .RS Standaard installatiebestand als er geen \fIBESTAND\fRen zijn opgegeven, \ \fIEDITIE\fR is standaard desktop. .RE .sp /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 VOORBEELDEN .sp \fBkzinstall\fR .RS Installeer alles wat in de standaard installatiebestenden staat. Hiervoor is ook starter 'Apps installeren' beschikbaar. .RE .sp \fBkzinstall google-chrome\fR .RS Installeer Google Chrome. .RE .sp \fBkzinstall google-chrome --install-info\fR .RS Toon aanvullende instructies na het installeren van Google Chrome. Rechtsklik op starter 'Apps installeren' en kies 'Info'. .RE .sp \fBkzinstall google-chrome --remove-info\fR .RS Toon aanvullende instructies voor het verwijderen van Google Chrome. Rechtsklik op starter 'Apps installeren' en kies 'Verwijderen info'. .RE .\" .\" .SH AUTEUR Geschreven door Karel Zimmer . .\" .\" .SH AUTEURSRECHT Auteursrecht (c) 2009-2021 Karel Zimmer. .br GNU Algemene Publieke Licentie . .\" .\" .SH ZIE OOK \fBkzcommon.sh\fR(1), \fBkzmenu\fR(1), \fBkzsetup\fR(1), \fBhttps://karelzimmer.nl\fR .\" .\" .SH BESCHIKBAARHEID Opdracht kzinstall is onderdeel van het pakket kzscripts en is beschikbaar vanaf Karel Zimmer Linux Scripts . .sp .\" EOF