mirror of
https://github.com/iiab/iiab.git
synced 2025-03-09 15:40:17 +00:00
Test 'pandoc README.rst -o README.adoc' in 1-prep & 2-common
This commit is contained in:
parent
1c1d4e0d58
commit
5767fb91f8
4 changed files with 58 additions and 0 deletions
37
roles/1-prep/README.adoc
Normal file
37
roles/1-prep/README.adoc
Normal file
|
@ -0,0 +1,37 @@
|
||||||
|
== 1-prep README
|
||||||
|
|
||||||
|
This 1st
|
||||||
|
https://github.com/iiab/iiab/wiki/IIAB-Contributors-Guide#ansible[stage]
|
||||||
|
(1-prep) arranges low-level things like remote support infra, DNS prep,
|
||||||
|
hardware, low-level OS quirks, and basic security:
|
||||||
|
|
||||||
|
* SSHD
|
||||||
|
* OpenVPN if/as needed later for remote support
|
||||||
|
* https://github.com/iiab/iiab/tree/master/roles/iiab-admin#iiab-admin-readme[iiab-admin]
|
||||||
|
username and group, to log into Admin Console
|
||||||
|
* dnsmasq (install now, configure later!)
|
||||||
|
* Universally unique identifier: /etc/iiab/uuid
|
||||||
|
* Ubermix (distro) needs /etc/tmpfiles.d/iiab.conf to create essential
|
||||||
|
/var/log subdirs on each boot
|
||||||
|
* {blank}
|
||||||
|
+
|
||||||
|
Hardware actions:::
|
||||||
|
** {blank}
|
||||||
|
+
|
||||||
|
link:tasks/raspberry_pi.yml[raspberry_pi.yml]:;;
|
||||||
|
*** RTC (real-time clock): install udev rule, configure, enable
|
||||||
|
*** {blank}
|
||||||
|
+
|
||||||
|
Install packages related to:::
|
||||||
|
**** growpart
|
||||||
|
**** swapfile
|
||||||
|
**** fake-hwclock (as RTC is often missing or dead!)
|
||||||
|
**** Wi-Fi
|
||||||
|
*** Increase swap file size
|
||||||
|
*** https://github.com/iiab/iiab/blob/master/roles/1-prep/templates/iiab-rpi-max-rootfs.sh[rootfs
|
||||||
|
auto-resizing]
|
||||||
|
** NUC 6 Wi-Fi firmware
|
||||||
|
|
||||||
|
Recap: Similar to 0-init, 2-common, 3-base-server, 4 server-options and
|
||||||
|
5-xo-services — this 1st stage installs core server infra (that is not
|
||||||
|
user-facing).
|
21
roles/2-common/README.adoc
Normal file
21
roles/2-common/README.adoc
Normal file
|
@ -0,0 +1,21 @@
|
||||||
|
== 2-common README
|
||||||
|
|
||||||
|
This 2nd
|
||||||
|
https://github.com/iiab/iiab/wiki/IIAB-Contributors-Guide#ansible[stage]
|
||||||
|
is for OS-level basics _common_ to all platforms, i.e. core
|
||||||
|
prerequisites to building up a functioning
|
||||||
|
https://internet-in-a-box.org/[Internet-in-a-Box (IIAB)] server.
|
||||||
|
|
||||||
|
These are (partially) put in place:
|
||||||
|
|
||||||
|
* IIAB directory structure (link:tasks/fl.yml[file layout])
|
||||||
|
* Common https://en.wikipedia.org/wiki/APT_(software)[apt] software
|
||||||
|
packages
|
||||||
|
* Networking (including the
|
||||||
|
https://en.wikipedia.org/wiki/Iptables[iptables] firewall)
|
||||||
|
* link:tasks/iiab-startup.yml[/usr/libexec/iiab-startup.sh] similar to
|
||||||
|
AUTOEXEC.BAT and /etc/rc.local, in order to run jobs on boot
|
||||||
|
|
||||||
|
Recap: As with 0-init, 1-prep, 3-base-server, 4-server-options and
|
||||||
|
5-xo-services — this 2nd stage installs core server infra (that is not
|
||||||
|
user-facing).
|
Loading…
Add table
Add a link
Reference in a new issue