From cb1720059cfd2cd7d108244f19e431f8401e17c0 Mon Sep 17 00:00:00 2001 From: Christian Rößler Date: Mon, 13 Aug 2018 17:13:19 +0200 Subject: [run-virt] Linux scripts: some more documentation. --- .../data/opt/openslx/vmchooser/data/linux/LIESMICH | 15 ++--- .../data/opt/openslx/vmchooser/data/linux/README | 64 ++++++++++++++++++---- 2 files changed, 60 insertions(+), 19 deletions(-) (limited to 'core/modules/run-virt/data/opt/openslx/vmchooser/data/linux') diff --git a/core/modules/run-virt/data/opt/openslx/vmchooser/data/linux/LIESMICH b/core/modules/run-virt/data/opt/openslx/vmchooser/data/linux/LIESMICH index dd06472c..cf5dbc5d 100755 --- a/core/modules/run-virt/data/opt/openslx/vmchooser/data/linux/LIESMICH +++ b/core/modules/run-virt/data/opt/openslx/vmchooser/data/linux/LIESMICH @@ -12,16 +12,17 @@ awk, cat, chmod, chown, cut, cvt, find, grep, head, hexdump, ln, logger, mkdir, mount, mount.cifs, mv, ping, printf, ps, rmdir, sed, sleep, su, systemctl, timeout, unlink, xdg-user-dir, xrandr, xterm. -Als mitunter fehlend haben sich insbesondere mount.cifs und xdg-user-dir -erwiesen. Zur Ermittlung eventuell fehlender binaries ist hilfreich, das -Skript openslx mit root-Rechten von Hand zu starten und auf "…not found" -u.ä. zu achten. +Als mitunter fehlend haben sich insbesondere mount.cifs (wenn SMB-Laufwerke +nicht eingebunden werden und xdg-user-dir (wenn keine Icons auf dem Desktop +erscheinen) erwiesen. Zur Ermittlung eventuell fehlender binaries ist +hilfreich, das Skript openslx mit root-Rechten von Hand zu starten und auf +"…not found" u.ä. zu achten. Logeinträge: -Die Skripte loggen eine Vielzahl an Information zu, jeweiligen syslog. -Alle Logeinträge sind mit einem vorstehenden 'openslx' gekennzeichnet, +Die Skripte loggen eine Vielzahl an Information zum jeweiligen syslog. +Alle Logeinträge sind mit einem vorgestellten 'openslx' gekennzeichnet; die Einträge sind zudem wie folgt aufgeschlüsselt: 'openslx utility script': openslx-Hauptskript @@ -33,7 +34,7 @@ Enthaltene Skripte: vm_installer: Dieses Skript einmalig in einer lokalen, permanenten (also nicht innerhalb des Poolsystems) Virtuellen Maschine ausführen. - Es schreibt drei systemd-Servicedateien und verlinkt diese, + Es schreibt zwei systemd-Servicedateien und verlinkt diese, um beim Systemstart folgende Skripte zu starten: openslx: Das Skript openslx wird von einem durch vm_installer diff --git a/core/modules/run-virt/data/opt/openslx/vmchooser/data/linux/README b/core/modules/run-virt/data/opt/openslx/vmchooser/data/linux/README index 53576259..6a58e448 100755 --- a/core/modules/run-virt/data/opt/openslx/vmchooser/data/linux/README +++ b/core/modules/run-virt/data/opt/openslx/vmchooser/data/linux/README @@ -1,10 +1,59 @@ +Prerequisites + +These utilitity scripts are colling some external programs. Most of these +binaries should be contained in a standard Linux installation. If these +scripts malfunction or a feature does not work it would be wise to verify +whether the needed binaries are included in the used virtual machine (and +check the usual log files, of course). + +These programs are needed: + +awk, cat, chmod, chown, cut, cvt, find, grep, head, hexdump, ln, logger, +mkdir, mount, mount.cifs, mv, ping, printf, ps, rmdir, sed, sleep, su, +systemctl, timeout, unlink, xdg-user-dir, xrandr, xterm. + +Two likely candidates are in particular mount.cifs and xdg-user-dir. Do +detect missing binaries it is helpful to start the script openslx with root +permissions by hand and check for "…not found" messages. + + +Log file entries: + +These script do log a multitude of information to syslog. Every log entry is +distinguished by a preceding 'openslx'; the entries are further itemised by: + +'openslx utility script': openslx main script, +'openslx sharemapper': utility to mount network shares, +'openslx resolution utility': utility to set monitor resolution. + + +Included scripts: + This package consists of following scripts: vm_installer: This script is to be started once in a local, permanent (so not within the pool system environment) virtual machine. It - writes three systemd service files and links them, so - following scripts will be started at system startup resp. - shutdown: + writes two systemd service files and links them, so following + scripts will be started at system startup resp. shutdown. + +openslx: The script openslx will be started via systemd service written + by vm_installer. It calls the functions resolution and + mnt_shares. The formerly solitary scripts resolution and + mnt_shares will be necessary no longer. + +umnt_shares: (before shutdown.target): Unmounts given network shares at + virtual machine shutdown. + +resolution_standalone: Standalone version of resolution sctipt. Needs no + preliminary work done by systemd or vm_runtime. It has to be + embedded/startedt via adequate means by hand (eg. + Xsetup/Xreset). + + Annotation: This script will not be maintained regularly, so + it is recommended to use openslx. + + +Obsolete as single scripts: resolution: (after display-manager.service): Sets resolution within the virtual machine according to base system resolution given via @@ -15,12 +64,3 @@ mnt_shares: (after basic.target): Reads entries remapMode (and mounts the shares given by shares.dat according to remapMode. mounts therein given network shares. -umnt_shares: (Before shutdown.target): Umounts given shares at virtual - machine shutdown time . - - -resolution_standalone: Standalone version of resolution sctipt. Needs no - preliminary work done by systemd or vm_runtime. - One has to embed/start it via adequate means by hand - (Xsetup/Xreset). - -- cgit v1.2.3-55-g7522