documentation: add INCIDENTS.md and some more documentation

README.md

@@ -4,10 +4,56 @@ This repo contains the config and documentation for our installation at the "Ers
 
 ---
 
-**more documentation will follow**
+**more documentation / information will follow**
 
 ---
 
+## Admin Guide
+
+requirements:
+* `ansible`
+* `pass`
+
+### Password Manager
+
+```
+user@freifunk-admin:~/ffl-eae-adp$ . environment 
+user@freifunk-admin:~/ffl-eae-adp$ pass
+Password Store
+├── accesspoints
+│   ├── ap-0b99
+│   ├── ap-1a38
+│   ├── ap-2bbf
+│   ├── ap-8f39
+[...]
+user@freifunk-admin:~/ffl-eae-adp
+```
+
+### SSH
+
+use `playbook_create_ssh_config.yml` to generate an `ssh_config` file that gets linked into your `ssh_config`.
+optionally specify a jumphost (ie. `eae-adp-jump01`)
+
+```
+user@freifunk-admin:~/ffl-eae-adp$ ansible-playbook -e jumphost=eae-adp-jump01 playbook_create_ssh_config.yml 
+
+PLAY [generate ssh_config] ******************************************************************************************************************************************************************************************************
+
+TASK [generate ssh_config file] *************************************************************************************************************************************************************************************************
+changed: [localhost]
+
+TASK [include custom ssh_config] ************************************************************************************************************************************************************************************************
+ok: [localhost]
+
+PLAY RECAP **********************************************************************************************************************************************************************************************************************
+localhost                  : ok=2    changed=1    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   
+
+user@freifunk-admin:~/ffl-eae-adp$ ssh gw-core01 uptime
+ 23:54:52 up  6:49,  load average: 0.05, 0.01, 0.00
+user@freifunk-admin:~/ffl-eae-adp$
+```
+
 ## Links
 
 [Documentation](documentation/README.md)
+[Incidents](documentation/INCIDENTS.md)

documentation/INCIDENTS.md

@@ -0,0 +1,19 @@
+
+Collection of all incidents
+===========================
+
+2022.06.30 17:00 - 18:00 | power issues on gw-core01
+----------------------------------------------------
+
+**issue**:
+
+The protective cap of the power strip yanked the power supply of `gw-core01` out of its socket.
+Therefore `gw-core01` had no power.
+
+**solution**:
+
+Tape back the protective cap of the power strip and reinsert the power supply
+
+**impact**:
+
+No internet access for 2 hours