Server Internes
IN BEARBEITUNG!!!
Inhaltsverzeichnis
- 1 Git-Repository
- 2 Bereitstellung / Initialisierung
- 3 Betrieb / Operating
- 3.1 Salt Basics
- 3.2 Salt - Aufgaben (top.sls)
- 3.2.1 apt
- 3.2.2 remove_pkg
- 3.2.3 install_pkg
- 3.2.4 tools
- 3.2.5 root
- 3.2.6 users
- 3.2.7 bash
- 3.2.8 inputrc
- 3.2.9 locales
- 3.2.10 timezone
- 3.2.11 ntp
- 3.2.12 kernel
- 3.2.13 systemd
- 3.2.14 sudo
- 3.2.15 rsyslog
- 3.2.16 logrotate
- 3.2.17 cron
- 3.2.18 devel
- 3.2.19 bmxd
- 3.2.20 fastd
- 3.2.21 salt-minion
- 3.2.22 ddmesh
- 3.2.23 nvram
- 3.2.24 iproute2
- 3.2.25 network
- 3.2.26 iptables
- 3.2.27 conntrack
- 3.2.28 fail2ban
- 3.2.29 ssh
- 3.2.30 openvpn
- 3.2.31 wireguard
- 3.2.32 bind
- 3.2.33 iperf3
- 3.2.34 apache2
- 3.2.35 php
- 3.2.36 letsencrypt
- 3.2.37 monitorix
- 3.2.38 vnstat
- 4 Development
- 5 Wichig für Communitiy Forks
Git-Repository
Die aktuellste ffdd-server Version sowie Release Informationen findest du direkt auf der Projektseite.
https://github.com/Freifunk-Dresden/ffdd-server
Bereitstellung / Initialisierung
Die Initialisierung des Gateway-Server erfolgt über das init_server.sh Script. Dieses stellt sicher dass der Server auf dem aktuellen Stand ist und alle Abhängigkeiten sowie Konfigurationen vorhanden sind.
Wichtige Punkte sind hier:
- Konfiguration:
- /etc/nvram.conf (Enthält alle Gateway Spezifische Informationen)
- /etc/salt/minion.d/freifunk-masterless.conf (Definiert das Arbeitsverzeichnis für Salt - /srv/ffdd-server/salt/freifunk/base/ )
- Pakete:
- git - für die Bereitstellung und Aktualisierung des Repositories
- salt-minion (Salt) - Automatisierung 'Masterless-Orchestration-Management'
- Bereitstellung des Repositoryies unter
/srv/ffdd-server/
Salt übernimmt nun die weitere Initialisierung des Gateway-Server.
Im init_server.sh Script wird der "salt-call state.highstate --local" Befehl aufgerufen um sicherzustellen das alle Konfigurationen, Paket,.. wie gewünscht auf dem Server bereitgestellt werden.
Dies geschieht im laufenden Betrieb auch regelmäßig über einen Cronjob (siehe: Server_Internes#salt-minion).
Betrieb / Operating
Salt Basics
Salt benötigt seine Konfiguration ( /etc/salt/minion.d/freifunk-masterless.conf )
file_client: local
file_roots:
base:
- /srv/ffdd-server/salt/freifunk/base
und das Arbeitsverzeichnis ( /srv/ffdd-server/salt/freifunk/base/ ) welches einen "Ablaufplan" die top.sls bereitstellt.
Alle hier definierten Aufgaben bekommen je nach Umfang und Komplexität im Arbeitsverzeichnis entweder:
eine Konfigurationsdatei ( ../freifunk/base/AUFGABE.sls )
oder
einen Unterordner ( ..freifunk/base/AUFGABE/ ) welcher eine init.sls enthält.
Desweiteren gibt es noch ein Konfigurationfile, die config.jinja, welche dynamische Variablen enthält. Diese Variablen können in den einzelnen "Aufgaben-Scripten" einfach eingebunden und genutzt werden.
Salt - Aufgaben (top.sls)
apt
Konfiguriert benötigte Pakete um das Betriebssystem des Gateway-Server aktuell zuhalten.
remove_pkg
Entfernt alle Pakete welche die Funktionalität des Servers einschränken könnten.
install_pkg
Installiert alle für den Server nötigen Pakete welche keine zusätzliche Konfiguration benötigen.
tools
Stellt Programme und Verknüpfungen als "Helferlein" für die Unterstützung des Administrators bereit.
root
Hinterlegt für den User 'root' eine .bashrc Konfiguration für die default shell: bash.
In dieser werden unter anderem aliases (Kürzel) bereitgestellt Kommandos abzukürzen.
Es gibt die Möglichkeit auch eigene aliases in der /root/.bash_user_aliases zu definieren. Diese wird in '/root/.bash_aliases' eingebunden und automatisch mitgeladen.
users
Stellt sicher das alle Benutzer für den Betrieb mit den richtigen Berechtigungen vorhanden sind.
bash
Hinterlegt die Standart Konfiguration für "bash".
inputrc
Hinterlegt die Standart Konfiguration für das Console-Verhalten.
locales
Konfiguriert die Server-Ausgabe-Sprache.
timezone
Konfiguriert die Serverzeit.
ntp
Stellt sicher dass die Serverzeit immer aktuell ist.
kernel
kernel.sysctl
systemd
sudo
rsyslog
logrotate
cron
devel
bmxd
fastd
salt-minion
ddmesh
nvram
Die /etc/nvram.conf enthält alle Gateway Spezifische Informationen.
nvram Konfigurtations Optionen
Hier ist eine nvram.conf mit allen verfügbaren Optionen:
# install_dir !Please do not touch! install_dir=/srv/ffdd-server # set autoupdate (0=off 1=on) autoupdate=1 # Git-Branch branch=T_RELEASE_latest # Register key must be uniq. See http://wiki.freifunk-dresden.de/index.php/Technische_Information#Berechnung_IP_Adressen ddmesh_node= ddmesh_registerkey= # If set to 1, vserver will not announce itself as gateway. normally you do not need to change this. ddmesh_disable_gateway=0 # used by webpage and /etc/issue.net servername=VPN Server <number> #vserver network interface; this depends on vserver provider (hoster) ifname=eth0 # this is the secret key which is used to decrypt secured backbone connection # the corresponding public key should be given to the peers, so those can encrpyt/connect to this server # To generate the keys: /etc/init.d/S53backbone-fastd genkey fastd_secret= fastd_public= # to accept all in comming connection, set this to 0 or remove this line. # When set to 1, only already known connections are accepted. this may be used # to prevent overloading a server. fastd_restrict=0 # SSH Password-Authentification # To disable tunneled clear text passwords (0=off 1=on) ssh_pwauth=1 # BMXD #bmxd_prefered_gateway= # gps coordinates. see /var/www/sysinfo.json # this functionality is not part of Basic Vserver installation, as this service should only run on one or an backup server. gps_latitude=51.033865 gps_longitude=13.653252 gps_altitude=0 city=Dresden contact_name= contact_location=your Hosting Provider contact_email= contact_note=VPN X
