= BEHEER = [[PageOutline(1-5,Contents,pullout)]] ---- Note: Per 1 januari 2016 maken we gebruik van: [https://wirelessleiden.nl/support/ Request Tracker] voor het registreren van storingen. De [https://www.wirelessleiden.nl/projects/beheer/wiki/WikiStart#OpenstaandeTicketsinTrac bestaande tickets] die zijn gemaakt in Trac zijn onderaan deze pagina te vinden.[[BR]] ---- = Verandering SSID = We gaan de ssids voor de gebruikerstoegang veranderen, zie [https://www.wirelessleiden.nl/projects/beheer/wiki/SsidChange SSIDChange]. = Eerstelijnsbeheer = == Organisatie == Eerstelijnsbeheer wordt gedaan door een aantal nog-niet-zo-ervaren vrijwilligers. Deze vrijwilligers kijken ieder een (vaste) dag in de week naar [http://huubs.xs4all.nl:2311/nagios/ Nagios] en voeren kleine reparaties uit op de nodes, zoals het starten van de node-webserver als die er mee gestopt is. Ze besteden hieraan ongeveer 20 minuten per week (meer mag natuurlijk ook). De voordelen van deze opzet zijn: - vrijwilligers die nog niet zo ervaren / niet zo deskundig zijn kunnen toch een heel nuttige bijdrage leveren - vrijwilligers kunnen wat leren m.b.t. freebsd en ook over hoe het netwerk in elkaar zit en ze kunnen mogelijk doorgroeien - er wordt regelmatig naar Nagios gekeken, zodat storingen die eenvoudig zijn op te lossen ook relatief *snel* worden opgelost en in ieder geval snel gesignaleerd - de 2e-lijnsbeheerders krijgen meer tijd voor de lastiger problemen. == Informatiebronnen == Node configuratie files welke worden gebruikt door Genesis zijn in [http://svn.wirelessleiden.nl/svn/node-config/genesis/nodes Subversion] te vinden. De node-specifieke configuratiebestanden, gegenereerd uit [http://wirelessleiden.nl/config/ Genesis]. Monitoring met behulp van Nagios is toegankelijk via de [http://huubs.xs4all.nl:2311/nagios/ Nagios Pagina].[[BR]] Voor elke Node is een aparte NodeOverzicht gemaakt met verwijzingen en informatie over de betreffende Node en de locatie. == Werkwijze == 1. Maak via **ssh** vanaf internet een verbinding met wleiden.net via een van de proxies. Bijvoorbeeld (in terminal) via proxy1: {{{ssh -A root@213.124.17.164}}} Je ssh-key moet bekend zijn op deze proxy. Een tweedelijnsbeheerder kan hierbij helpen. 2. Check **'services'** in [http://huubs.xs4all.nl:2311/nagios/ Nagios] Check als eerste of er **rode** vakjes zijn in de lijst van nodes, prioriteit hebben **'hosts down'**. Kijk ook hoe vaak deze service gecheckt is, een foutmelding kan veroorzaakt zijn door het tijdelijk niet bereikbaar zijn van de node. **Node down** **Let op:** 'down' betekent: niet bereikbaar voor de nagios server (sunny, verbonden met node UniGorN). Het kan dus ook een routeringsprobleem zijn, of de bereikbaarheid van de node/proxy is afhankelijk van een andere node die down is. Bij een proxy die 'down' is: check eerst of de bijbehorende node ook down is en los dat eerst op. Sommige nodes (WP, Cam, Drijfhuis, Recpark, Spoortje,...) hebben maar een interlink en zijn dus afhankelijk van de betreffende buurnode. Ook foutmeldingen over services kunnen veroorzaakt worden door een (tijdelijke) storing in de routering, waardoor een nagios check eventjes niet werkt. Zoek in genesis op welke buren deze node heeft en log in bij een van deze buurnodes. Check of je de node kunt pingen op het interlink-ip-adres (zie genesis). Lukt dit niet, probeer dan een van de ander buurnodes. Als geen van de interlinks werkt, check dan of je de nano's wel kunt pingen. ''nanostations pingen'' ''Interlinks hebben een /29 subnet voor de node-interfaces en voor de nanostations. De conventie is dat de ip-adressen zijn toegekend in de volgorde: node-interface - nanostation in ap-modus - nanostation in station modus - node-interface. Als alle nano's down zijn wijst dit op een stroomstoring: maak een ticket aan, dat wordt fietsen! '' Bij een werkende interlink: inloggen op de node met ssh. Als inloggen met ssh niet lukt dan ligt dat aan het ontbreken van je ssh-key op de node. Als sshd gestopt zou zijn gaat de node automatisch rebooten (watchdog op de node). Maak eventueel een ticket aan. Na inloggen check dmesg voor 'vreemde boodschappen'. Paardenmiddel is een soft reboot. Als het probleem de routering is dan kan eleganter en met minder verstoring van het netwerk geprobeerd worden: - lvrouted interface info opnieuw laten lezen {{{ kill -HUP }}}; lvrouted pid vind je via {{{ps -ax|grep lvrouted}}} - lvrouted opnieuw starten: {{{/usr/local/etc/rc.d/lvrouted restart}}} Uitloggen en vanaf de buurnode kijken of het pingen van de nodenaam werkt. Bekende oorzaken van routeringsproblemen zijn het vollopen van /var (dat geeft een foutmelding bij de 'services' in Nagios) of een verkeerde tijd op de node (geeft ook een foutmelding in Nagios). Vollopen van /var wordt verholpen door een reboot. Maak wel een ticket aan (waarschijnlijk is de /etc/newsyslog.conf file niet de laatste versie). Verkeerde tijd komt op een aantal nodes voor na een stroomstoring (op sommige alix-bordjes zit geen bios-batterijtje). **HTTP Connection refused** Waarschijnlijke oorzaak: thttpd is gestopt. Inloggen op de betreffende node. Een van de recente boodschappen van 'dmesg' zal bijvoorbeeld zijn: ''pid 1675 (thttpd), uid 0: exited on signal 6''. Start thttpd op: ''service thttpd start''. **NTP CRITICAL: Offset unknown** Waarschijnlijke oorzaak: ntpd is gestopt of niet gestart. Inloggen op de betreffende node. Controleer of nptd draait: ''ps ax | grep ntpd''. Start ntpd door middel van: ''service ntpd start'' ** wlan0 no carrier** Inloggen op node en (bij link via wlan interfaces aan beiden kanten, eerst AP en dan STA): $ ifconfig wlan0 destroy\\ $ /etc/rc.d/netif restart ath0 en waarschijnlijk lvrouted opnieuw starten nodig. = Rapporteren storingen = We gebruiken [https://wirelessleiden.nl/support/ Request Tracker]. Maak een ticket aan om een incident/storing te melden (hiervoor moet u wel [Aanmelden met uw WL-vrijwilligersgegevens])[[BR]] Voor het gebruik van Request Tracker is een [http://svn.wirelessleiden.nl/svn/node-config/ops/papers/nodebeheer/handleiding_request_tracker.pdf handleiding] geschreven. Vemeld hierbij de volledige nodenaam (Cetim1, Huub etc....) en de volledige "Host State Information". Bijvoorbeeld: {{{ Host Status: DOWN (for 3d 3h 28m 15s) Status Information: PING CRITICAL - Packet loss = 100% Performance Data: rta=5000.000000ms;3000.000000;5000.000000;0.000000 pl=100%;80;100;0 Current Attempt: 1/10 (HARD state) Last Check Time: 01-24-2015 14:44:50 Check Type: ACTIVE Check Latency / Duration: 0.135 / 15.085 seconds Next Scheduled Active Check: 01-24-2015 22:45:10 Last State Change: 01-21-2015 14:43:10 Last Notification: N/A (notification 0) Is This Host Flapping? NO (3.88% state change) In Scheduled Downtime? NO Last Update: 01-24-2015 18:11:20 ( 0d 0h 0m 5s ago) }}} Het laatste veld "Last Update" is namelijk het enige veld waaruit je achteraf kunt bepalen wanneer een storing gestart is. Dit kan erg nuttige informatie zijn op het moment dat contact moet worden opgenomen met een gebouwbeheerder. Kijk in [report:1 rapport 1] voor alle openstaande gerapporteerde storingen. = Hulpmiddelen = == Check op dubbele ips == Om een check te draaien op het voorkomen van dubbele ip-adressen, zie tools in genesis: {{{ .../genesis/nodes$ ../tools/batch-cmd grep 'inet ' * | awk '{print $3}' | sort | uniq -c | sort -n }}} == Controle werking proxy-server == Je kunt controleren of de pen_wrapper op de node (die de snelste proxy selecteert) naar behoren werkt. {{{ env HTTP_PROXY=http://proxy.wleiden.net:3128 fetch -o - http://tinyproxy.stats }}} Het leuke van de file is dat je ook kunt zien op de proxy welke nodes op dat moment de desbetreffende proxy als primair hebben staan. == Workaround Ziggo modem MAC cache == Issue waarbij verkeer tussen de node met static IP adress en Ziggo modem met firmware 9.9.6004 lijkt te stoppen na een variabele tijd. Die MAC cache van die Ubee modem op firmware 9.9.6004 is echt niet lekker meer. Na 30 seconden lijkt het een MAC te vergeten en dan gaat de modem niet zelf actief pollen om het MAC opnieuw te achterhalen. Door de MAC cache erg kort te zetten op de node, zal er regelmatig een ARP request/reply komen en is de modem weer gelukkig. Voor statische IP addressen: sysctl net.link.ether.inet.max_age=30 Regel net.link.ether.inet.max_age=30 in /conf/base/etc/sysctl.conf toevoegen om het permanent te maken. == Power cycle van interface via RB PoE-switch == Procedure: Use with care! disabling the wrong one will lock you out without possibility to recover except for replacing the device. Bouw tunnel op naar de node:[[BR]] client$ ssh -L 1234:192.168.88.1:80 Stop diensten en bereid interfaces voor:[[BR]] * node# service pf stop[[BR]] * node# ifconfig re0 alias 192.168.88.10/24[[BR]] Verander de link:[[BR]] * Browse to http://localhost:1234 username/passwd: admin/ * Toggle power state of affected link to off. Zet de boel weer terug zoals het was:[[BR]] node# ifconfig re0 -alias 192.168.88.10 node# service pf start == DNS voor wleiden.net == Lokale wleiden.net-zonefiles worden automatisch gegenereerd uit genesis met /usr/local/tools/named_update.sh script op de dns-server (Sunny). Checken op foutjes in de config file dmv[[BR]] root@sunny:~ # env FORCE=1 sh -x /usr/local/tools/named_update.sh == Nanostation firmware opnieuw flashen == Als een nanostation 'dood' is kan opnieuw flashen van de firmware helpen. Zoals op [https://help.ubnt.com/hc/en-us/articles/204911324-airMAX-How-to-reset-your-device-with-TFTP-firmware-recovery TFTP-firmware-recovery] staat: Generic Linux distributions have an integrated command line TFTP client. From a PC running Linux, you can upload via TFTP by typing into Terminal the following commands: {{{ root@ubuntu:tftp 192.168.1.20 tftp> bin tftp> trace tftp> put XS2.ar2316.v3.4-rc.4351.090504.2146.bin Sent 1965199 bytes in 35.2 seconds tftp> exit }}} = Openstaande Tickets in Trac = Er kunnen in Trac geen nieuwe tickets meer worden aangemaakt.[[BR]] Hiervoor gebruiken we per 1 januari 2016 [https://wirelessleiden.nl/support/ Request Tracker] voor in de plaats. [[TicketQuery(status!=closed,order=id,desc=1,format=table,col=summary|status|owner|reporter|keywords|component,group=location)]] ------------- = Voor trac hulp = * TracGuide -- Built-in Documentation * [http://trac.edgewall.org/ The Trac project] -- Trac Open Source Project * [http://trac.edgewall.org/wiki/TracFaq Trac FAQ] -- Frequently Asked Questions * TracSupport -- Trac Support For a complete list of local wiki pages, see TitleIndex.