Split machine-specific notes

5 files changed, 289 insertions, 0 deletions

diff --git a/guides/sysadmin/machines/little-buster/README.org b/guides/sysadmin/machines/little-buster/README.org
new file mode 100644
index 0000000..3d6cd54
--- /dev/null
+++ b/guides/sysadmin/machines/little-buster/README.org
@@ -0,0 +1,8 @@
+Aka =nc10-laptop=.  A hand-me-down Samsung NC10 I used from 2016
+to 2020.  Served valiantly; probably still works, but have been afraid
+to boot it since the fan started to [[https://bugs.gnu.org/45705#41][sound like]] it is trying to open a
+gateway to Hellas Planitia.
+
+Initially went with Bunsenlabs, then vanilla Debian/XFCE during a
+reinstall.  Fairly low-end, no SSD, but tiny & cute; a perfectly
+serviceable travel companion.
diff --git a/guides/sysadmin/machines/little-buster/fonts.md b/guides/sysadmin/machines/little-buster/fonts.md
new file mode 100644
index 0000000..30e7739
--- /dev/null
+++ b/guides/sysadmin/machines/little-buster/fonts.md
@@ -0,0 +1,49 @@
+Fonts I find useful, plus messy configuration details.
+
+# Symbola
+
+Symbola seems to cover most characters I care about (although it does
+not handle fancy emoji ligatures), and new versions are released
+fairly soon after each revision of the Unicode standard.
+
+Since distributions may not include the latest version, I often get it
+directly from [the author's website](http://users.teilar.gr/~g1951d/).
+
+# Installing fonts with Fontconfig
+
+Gee, it sure is convenient to be able to install new fonts simply by
+dropping them in `~/.fonts` and running `fc-cache`!
+
+`/etc/fonts/fonts.conf`:
+
+    	<!-- the following element will be removed in the future -->
+    	<dir>~/.fonts</dir>
+
+😨
+
+Bunsenlabs symlinks `~/.fonts` to `~/.local/share/fonts`, but this
+path is not mentioned anywhere in `/etc/fonts`.  What's the deal?
+
+`/etc/fonts/fonts.conf`:
+
+    	<dir prefix="xdg">fonts</dir>
+
+fonts-conf(5):
+
+> ## `<DIR PREFIX="DEFAULT">`
+>
+> This element contains a directory name which will be scanned for
+> font files to include in the set of available fonts. If 'prefix' is
+> set to "xdg", the value in the `XDG_DATA_HOME` environment variable
+> will be added as the path prefix. please see XDG Base Directory
+> Specification for more details.
+
+[XDG Base Directory Specification](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html):
+
+> `$XDG_DATA_HOME` defines the base directory relative to which user
+> specific data files should be stored. If `$XDG_DATA_HOME` is either
+> not set or empty, a default equal to `$HOME`/.local/share should be
+> used.
+
+Seems legit then.
+
diff --git a/guides/sysadmin/machines/little-buster/install.org b/guides/sysadmin/machines/little-buster/install.org
new file mode 100644
index 0000000..18bfda7
--- /dev/null
+++ b/guides/sysadmin/machines/little-buster/install.org
@@ -0,0 +1,132 @@
+* installer
+Touchpad is not recognized, for some reason.
+* first boot
+#+BEGIN_QUOTE
+A start job is running for Load AppArmor profiles
+#+END_QUOTE
+Disappeared after ≈30s 🤷
+
+Wooh touchpad works!  Although the sensitivity is a bit low.
+*NB: solved below.*
+
+Wifi LED is on, whatever that means.
+
+Brightness function keys do not work on the login screen.
+
+Using default XFCE config to get four workspaces.
+
+Brightness and sound function keys work! 🙌
+
+Touchpad click and scroll do not work.
+*NB: solved below.*
+
+Wifi function key does not work.
+
+Battery life seems somewhat shorter than with Bunsenlabs, even after
+applying all powertop tricks in the book.
+* apt install (1/n)
+git greybird-gtk-theme elementary-xfce-icon-theme emacs
+
+git suggests git-doc: why of course, good idea!
+
+emacs suggests emacs-common-non-dfsg: right, what was that again?
+Documentation, IIRC?  What does APT have to say?
+
+#+BEGIN_EXAMPLE
+$ apt show emacs-common-non-dfsg
+Package: emacs-common-non-dfsg
+State: not a real package (virtual)
+N: Can't select candidate version from package emacs-common-non-dfsg as it has no candidate
+N: Can't select versions from package 'emacs-common-non-dfsg' as it is purely virtual
+N: No packages found
+#+END_EXAMPLE
+
+… What does https://packages.debian.org/emacs-common-non-dfsg say?
+
+#+BEGIN_QUOTE
+*[non-free]*
+#+END_QUOTE
+
+[[https://www.debian.org/vote/2006/vote_001][Oh.]]  Well then,
+
+#+begin_src sh
+$ sudo sed -ri 's/^([^#].+ main)$/\1 contrib non-free/' /etc/apt/sources.list
+$ # While in there…
+$ sudo sed -ri 's/^(deb|deb-src) http:/\1 https:/' /etc/apt/sources.list
+#+end_src
+
+What now?
+
+#+BEGIN_EXAMPLE
+$ sudo apt update
+[…]
+Err:4 https://security.debian.org/debian-security buster/updates Release
+  Certificate verification failed: The certificate is NOT trusted. The certificate issuer is unknown. The name in the certificate does not match the expected.  Could not handshake: Error in the certificate verification. [IP: 217.196.149.233 443]
+[…]
+E: The repository 'https://security.debian.org/debian-security buster/updates Release' no longer has a Release file.
+N: Updating from such a repository can't be done securely, and is therefore disabled by default.
+N: See apt-secure(8) manpage for repository creation and user configuration details.
+#+END_EXAMPLE
+
+🤨
+
+#+begin_src sh
+$ sudo sed -ri 's/security\.debian\.org/deb.debian.org/' /etc/apt/sources.list
+#+end_src
+
+[[https://wiki.debian.org/SourcesList#Example_sources.list][🤷]]
+
+* tweak dotfiles
+Set EMAIL in .profile; copy .profile to .xsessionrc (AFAICT XFCE does
+not read ~/.config/environment.d) to get PATHs.
+
+In .bashrc, enable globstar and autocd, uncomment grep and ls aliases,
+source personal .bash_prompt.
+
+Fun fact!  git can guess user.email from $EMAIL and user.name from the
+[[https://en.wikipedia.org/wiki/Gecos_field][GECOS field]].
+* apt install (2/n)
+#+BEGIN_QUOTE
+E: Package 'gcc-doc' has no installation candidate
+#+END_QUOTE
+gcc-doc is only available in /backports/?
+* configure XFCE
+** Mouse and Touchpad
+- Move sliders a bit to no avail, restore defaults.
+- Google around.
+- Why do my XFCE settings not have this "Touchpad" tab?
+- apt install xserver-xorg-input-synaptics
+- Log out and in again.
+- Woah the pointer is much faster now.
+- And the "Touchpad" tab is here now!
+🎉
+** Panels
+Remove bottom panel: I'd rather remember a few Super-… shortcuts to
+launch these applications rather than waste all this vertical space.
+** Appearance
+*** Style
+Greybird
+
+Patch the xfwm-tabwin style to prevent the mouse from screwing with
+Alt-Tab:
+
+#+begin_src diff
+diff -u /usr/share/themes/Greybird/gtk-2.0/gtkrc.bkp /usr/share/themes/Greybird/gtk-2.0/gtkrc
+--- /usr/share/themes/Greybird/gtk-2.0/gtkrc.bkp
++++ /usr/share/themes/Greybird/gtk-2.0/gtkrc
+@@ -897,8 +897,8 @@
+ 
+ 	bg[NORMAL]	= shade (0.15, @text_color)
+ 	bg[ACTIVE]	= shade (0.65, @selected_bg_color)
+-	bg[PRELIGHT]	= shade (0.75, @selected_bg_color)
+-	bg[SELECTED]	= shade (0.55, @bg_color)
++	bg[PRELIGHT]	= shade (0.55, @bg_color)
++	bg[SELECTED]	= shade (0.75, @selected_bg_color)
+ 
+ 	fg[NORMAL]	= shade (0.8, @base_color)
+ 	fg[ACTIVE]	= @base_color
+#+end_src
+* configure more stuff
+** lightdm
+Debian [[https://wiki.debian.org/LightDM#Enable_user_list][hides the list of users]] on the login screen; Bunsenlabs [[https://github.com/BunsenLabs/bunsen-configs/blob/9.6-1/lightdm.conf.d/50_bunsen.conf][enables
+it]] and I kind of like it (fewer keystrokes, and a cute avatar).
diff --git a/guides/sysadmin/machines/little-buster/maintenance.org b/guides/sysadmin/machines/little-buster/maintenance.org
new file mode 100644
index 0000000..bdee12a
--- /dev/null
+++ b/guides/sysadmin/machines/little-buster/maintenance.org
@@ -0,0 +1,58 @@
+* Configuration
+** Bunsenlabs
+*** Keyboard
+Cf. keyboard(5):
+
+- add =ctrl:nocaps= in =/etc/default/keyboard=
+- run =udevadm trigger --subsystem-match=input --action=change=
+- run =setupcon= in a TTY
+
+*** Desktop
+**** Conky
+- see dotfiles
+
+**** ClipIt
+- disable hotkeys
+
+**** Openbox
+***** =rc.xml=
+- comment A-m and A-r out
+- undecorate all windows:
+
+#+begin_src xml
+<application class="*">
+  <decor>no</decor>
+</application>
+#+end_src
+
+***** WM preferences
+- appearance: uncheck "windows retain a border when undecorated"
+- desktops: 4
+
+**** tint2
+- remove launcher and exit panel items
+- add date (time2)
+
+**** Calendar
+Make weeks begin on Monday by using the British locale:
+
+- uncomment =en_GB.UTF-8 UTF-8= in /etc/locale.gen
+- =sudo locale-gen=
+- =force_lang = en_GB.utf8= in =~/.config/gsimplecal/config=
+
+* Hiccups
+** fix xfce4-terminal opening links with firefox-esr
+** fix Thunar opening images with Firefox instead of Ristretto
+** fix Ristretto thumbnails
+** fix Ethernet after suspend
+Workaround:
+#+begin_src sh
+$ sudo modprobe -r sky2 && sudo modprobe -i sky2
+#+end_src
+References:
+- https://bugs.launchpad.net/ubuntu/+source/linux/+bug/1841304
+- https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=895378
+- https://bugs.launchpad.net/ubuntu/+source/linux/+bug/1798921
+- https://bugs.launchpad.net/ubuntu/+source/linux/+bug/1809843
+- https://askubuntu.com/questions/1029620/ubuntu-18-04-lts-sky2-ethernet-stops-working-after-system-resume-from-suspend
+- https://bbs.archlinux.org/viewtopic.php?id=234725
diff --git a/guides/sysadmin/machines/little-buster/package-management.md b/guides/sysadmin/machines/little-buster/package-management.md
new file mode 100644
index 0000000..6906253
--- /dev/null
+++ b/guides/sysadmin/machines/little-buster/package-management.md
@@ -0,0 +1,42 @@
+Here are some things that I do often enough that I want to remember
+how to do them properly, yet rarely enough that I will probably forget
+this stuff if I do not write it down.
+
+# Package managers
+
+## APT
+
+Add deb-src repositories to get:
+
+- `changelog`
+- `build-dep`
+- `source`
+
+# Installing stuff under `$HOME`
+
+E.g. pandoc (compiled from source tarball with stack because there is
+no 32-bit release) and ripgrep:
+
+- programs:
+    - install in `~/.local/bin`
+    - add this folder to `$PATH` (in `.profile` and `.xsessionrc`)
+
+- manpages:
+    - install in `~/.local/share/man/man1`
+    - in `~/.manpath`:
+
+            MANPATH_MAP	~/.local/bin	~/.local/share/man
+
+    - run `mandb --user-db`
+
+- bash completion scripts:
+    - install in `~/.local/share/bash-completion`
+    - in `~/.bash_completion` (sourced by
+      `/usr/share/bash-completion/bash_completion`):
+
+        ``` bash
+        for f in ~/.local/share/bash-completion/*
+        do
+            [ -f "$f" ] && . "$f"
+        done
+        ```