##Installatie handleiding voor server monitoring ### Agent setup De agent setup is zeer simpel. Je kopieert de agent folder naar een server die je wil monitoren. Voordat je de script uitvoert moet je nog wel de configuratie file aanpassen. #### Master address In de config.xml van de agent kan je het address van de master server aanpassen en ook eventueel de poort. De agent maakt gebruik van geruliere HTTP requests dus als dit beveiligd moet met HTTPS moet dat ook in het adres ingevult worden. #### Agent name Zonodig kan de agent name verandert worden. Doe dit wel voor de eerste run en nooit erna. Anders loopt de logging mis doordat het met servernamen werkt. #### Task Op die server stel je dan een reguliere task of cronjob in die de script automatisch uitvoert. Een voorbeeld van een cronjob die elke minuut de script uitvoert als root. ``` * * * * * root python /opt/agent/run.py >/dev/null 2>&1 ``` #### Windows De agent kan ook op een Windows Server draaien zonder problemen. Dan moet de python interpeter wel geinstalleerd zijn op de server samen met de dependencies. #### 3rd party libraries Agent Zorg ervoor dat de volgende libraries beschikbaar zijn op de server waar de agents op draaien. - requests(https://pypi.org/project/requests/) ### Master Om de monitoring master klaar te zetten moet er op de server een python interpeter geinstalleerd zijn met de onderstaande libraries. Om de server te laten draaien moet je naast de run.py een lege sqlite3 database hebben, een lege DB is meegeleverd via git. Daarna kan je de server starten met de volgende commando. Je kunt ook eventuele configuratie opties veranderen in config.xml ```shell python run.py ``` ### 3rd party libraries Master Zorg ervoor dat de volgende libraries beschikbaar zijn op de server waar de master op draait. - Flask(https://pypi.org/project/Flask/) - Matplotlib(https://pypi.org/project/matplotlib/) ## Deployment Meegegeven in de git repo is een salt state file. Die kun je makkelijk toevoegen aan de salt master. Om de monitoring-agent toe te voegen aan minions moet je naast de salt state file een mapje met de run.py en config.xml van de agent aanmaken. Daarna wordt automatisch de run.py elke minuut uitgevoerd. Vergeet niet voor het deployen de config.xml aan te passen naar alle juiste waardes.