NetDisco auf Ubuntu 18.04 LTS

(Dieser Beitrag wurda am 26. Oktober 2020 aktualisiert.)

Very Easy mit einem Installer Script

Warum ausgerechnet Ubuntu 18.04 LTS?

Es ist natürlich möglich Netdisco manuell auf diversen Distributionen bereitzustellen. In Anbetracht der Tatsache, dass es massive Abhängigkeiten von verfügbaren Paketen gibt, empfehle ich Administratoren Ubuntu 18.04 LTS einzusetzen, denn für diese Distribution (und nur für dieses Release!) existiert ein Install Script, welches die gesamte Installation – incl. aller Abhängigkeiten – automatisch durchführt. Man ist im Prinzip bis zum Mittag mit der Integration durch. Den Rest des Tages kann man dann schon "customizen".

–> Getestet auf Ubuntu Server 18.04 LTS -> Geht
–> Getestet auf Ubuntu Server 20.04 LTS -> Geht nicht (aufgrund diverser Abhängigkeiten zum Paket "snmp-libs" fehlgeschlagen)
–> Alle anderen Distributionen fallen leider ebenfalls raus – hier ist also die manuelle Installation durchzuführen.

Vorbereitungen

Beitrag auf Github vom Entwickler:
https://github.com/netdisco/netdisco/issues/692
Detaillierte Erläuterungen auf Github:
https://github.com/netdisco/netdisco/wiki/Install-Tips#easy-install-script-on-ubuntu

Infos, die vor dem Start des Installationsskripts zu sammeln und zu dokumentieren sind:

  • SNMP Community String (Read Only reicht) der Netzwerk-Umgebung
  • FQDN der lokalen Domain (optional)
  • Name des Admin Accounts für den Netdisco Login (gespeichert in netdiscoweblogin.txt)
  • Passwort des Admin Accounts für den Netdisco Login
  • Passwort für den Netdisco User auf der Postgres DB

Jetzt kann man loslegen…

Hinweis:
Falls der Server keinen Internet Zugriff hat, hier lesen!

sudo su root
curl -O https://raw.githubusercontent.com/netdisco/upstream-sources/master/contrib/ubuntu-install-script-692/netdisco_install_script.sh
chmod +x ./netdisco_install_script.sh
./netdisco_install_script.sh

Fragen beantworten, dann dauerte es bei mir ca. 8 Minuten…

Anschließend sollte das Web-Frontend unter HTTP, Port 5000 erreichbar sein…

Nacharbeiten / Administration

Anschließend als Netdisco User fortfahren, denn in diesem Kontext werden künftig die wichtigtsten Administrationsaufgaben erledigt…

su netdisco

Status des Netdisco Frontend prüfen:

~/bin/netdisco-web status --path=/netdisco2

Status des Netdisco Backend prüfen:

~/bin/netdisco-backend status --path=/netdisco2

Weitere Administrationsaufgaben

(dann immer im Kontext des Netdisco Users):

su netdisco

Netdisco Frontend starten, stoppen, neustarten:

~/bin/netdisco-web start --path=/netdisco2
~/bin/netdisco-web stop --path=/netdisco2
~/bin/netdisco-web restart --path=/netdisco2

Netdisco Backend starten, stoppen, neustarten:

~/bin/netdisco-backend start --path=/netdisco2
~/bin/netdisco-backend stop --path=/netdisco2
~/bin/netdisco-backend restart --path=/netdisco2

Konfiguration bearbeiten

su netdisco
nano ~/environments/deployment.yml

Tipp, zeige alle Tabellenzeilen an (Default 10):

table_pagesize: -1

Tipp, aktiviere LDAP Auth am DC:
Einfach diese Zeilen am Ende der Config Datei einfügen… (meine.domain.local durch die eigene Domain und den Server durch den eigenen FQDN des DC ersetzen)

# ---------------------------------------------------------------
# LDAP Authentication meine.domain.local
# ---------------------------------------------------------------

ldap:
  servers:
    - 'DC-01.meine.domain.local'
  user_string: '%USER%@meine.domain.local'
  opts:
  debug: 0
#
#
#

Ändern des Ports des Netdisco Frontend (hier bspw. auf Port 80):

~/bin/netdisco-web stop
~/bin/netdisco-web start --port=80

Scan eines Devices via CLI:

~/bin/netdisco-do -D discover -d 192.0.2.1

Update Netdisco:

~/bin/localenv cpanm --notest App::Netdisco
ln -sf ~/perl5/bin/{localenv,netdisco-*} ~/bin/

Noch mehr Infos…

Installationsanleitung Manuell:
https://metacpan.org/pod/App::Netdisco
Tipps zur Installation:
https://github.com/netdisco/netdisco/wiki/Install-Tips
Troubleshooting Tipps:
https://github.com/netdisco/netdisco/wiki/Troubleshooting
Konfigurationsoptionen komplett:
https://github.com/netdisco/netdisco/wiki/Configuration