GP3 Netscan (en)

- in Deutsch

- in English

Overview of the found devices

The gemininetscan Plugin scans the local network for available devices. subsequently (depending on the settings) a port scan is performed do discover open Ports. The result is displayed on the TV screen. Following functions are covered by the plugin:

• Scan the local network for available devices (via eth0 or wlan0).
• List the services of the discoverd devices.
• Display the MAC adresses of the devices, including the manufacturer info.
• Scans for available Samba and NFS shares.
• Can transfer the found shares directly to the Automount Editor.
• Supports WOL, to wake up devices.
• Can initiate a shutdown or reboot, if a Telnet server is installed on the device.
• Displays active / inactive devices ( = online / = offline).

Installation

Install the gemininetscan Plugin via Addons in the Blue Panel. The package is in the category Gemini Plugins. After installing the plugin an Enigma2 restart or reboot of the Dreambox is required. It's also possible to install the plugin via Telnet (en) or SSH with the following command.

opkg update && opkg install gemininetscan

Operation

Scan settings

Completed scan

After starting the plugin, you can open the settings with the red button. The following table lists the different options. The scan can be startet with the Start button. Once the scan of the network is completed, a list of availiable devices is displayed. Including the informations concerning the services, MAC adresses, .... An additional scan can be started at any moment over the red button.

Settings

Entry	Description
Network interface:	selection of the network interface e.g. eth0 or wlan0, which will be used for the scan (if multiple interfaces are available).
Start: / End:	range od IP addresses for the scan.
Search the Ports:	here you can define which ports will be scanned. Following options are possible: standard - search for available services and shares (recommended setting). no portscan - scans for devices, without portscan. 1-1023 - scans for standardized ports (well known ports). 1-49151 - scans for standardized and registered ports. 1-65535 - scan complete (standardized, registered and dynamic) port range. shares - scans only for NFS and SMB shares. Keep in mind, Windows XP shares are not detected.
Scan own IP?:	here you can indicate if your own Dreambox needs to be scanned, or not ;)
Don't display devices without services:	devices without services can be displayed or hidden with this setting.

users with a Fritzbox from AVM, should not scan the port range 1-49151 or 1-65535.

Freigaben

Freigaben

Um Freigaben zu sehen, müsst ihr in der Liste, das gewünschte Gerät mit der OK auswählen. Ihr könnt anschliessend auch den Filter mit der grünen Taste aktivieren, somit werden nur gefundene NFS und SMB Freigaben angezeigt. Beachtet bitte, dass Freigaben ab WinXP nicht angezeigt werden, sondern nur reine NFS- und Samba Server Freigaben.

Einbinden von NFS oder SMB Freigaben ist auch einfach möglich. Wählt eine Freigabe und drückt die rote Taste. Die Freigabe wird so automatisch an den Automount Editor übergeben. Ändert im Editor noch die gewünschten Einstellungen und schon könnt ihr das Gerät via /media/net/mountpunkt erreichen.

Aufwecken

Aufwecken

Aufwecken von Geräten erfolgt in der Liste über die grüne Taste. Beachtet aber, dass die Geräte WOL unterstützen müssen und die Funktion muss natürlich aktiviert sein. Lest dazu bitte die Betriebsanleitungen eurer verwendeten Geräte. Um Geräte aufzuwecken, wird der /usr/bin/ether-wake Befehl der Busybox verwendet.

Herunterfahren / Neustart

Herunterfahren

Für die Funktion, muss ein Telnet Server auf dem Gerät (z.B. Dreambox, PC, NAS, usw.) installiert sein. Das gemininetscan Plugin loggt sich mit Benutzername und Passwort via Telnet auf das Zielgerät ein und führt anschliessend den Befehl für das Herunterfahren / Neustart aus. Die folgenden Beschreibungen zeigen euch, wie ein Telnet Server unter Ubuntu (Linux), Mac OS, oder Windows eingerichtet wird.

• Ubuntu
• Mac OS X
• Windows

Das Herunterfahren (oder Neustart) erfolgt über die blaue Taste, wo anschliessend die benötigten Informationen z.B. Port, Benutzername, Passwort, usw. eingegeben werden müssen. Drückt nachher die grüne Taste, um das Gerät auszuschalten. Die folgende Tabelle beschreibt die benötigten Informationen.

Eingabe	Beschreibung
IP:	IP Adresse des auszuschaltenden Gerätes eingeben.
Port (Standard 23):	Portnummer eingeben, auf welchen der Telnet Server lauscht (Standard Port 23).
Telnet Nutzer:	Benutzername eingeben, welcher auf den Telnet Server einloggen soll. Der Benutzer benötigt entsprechende Rechte (root / admin), um das Gerät auszuschalten!
Telnet Passwort:	Passwort des Benutzer eingeben.
Befehl:	Auswahl des Befehls für den Neustart oder das Herunterfahren. Unterschieden werden die Befehle für Linux basierende Geräte, Mac OS und Windows. Am besten testet ihr die Befehle, nachdem ihr euch mit dem Benutzer / Passwort am Telnet Server angemeldet habt. So könnt ihr die Rechte und den Befehl für das Herunterfahren überprüfen. Die folgende Liste, zeigt die vom gemininetscan bereitgestellten Befehle für den Neustart und das Herunterfahren. Linux - ausschalten: shutdown Linux - ausschalten: poweroff Linux - ausschalten: halt Linux - Neustart: reboot Mac OS - ausschalten: shutdown -h now Mac OS - Neustart: shutdown -r now Windows - ausschalten: shutdown -s -f Windows - Neustart: shutdown -r -s -f Zusätzlich gibt es für Linux die Auswahl mit sudo z.B für Ubuntu. Damit könnt ihr den Rechner herunterfahren, ohne den root Account aktivieren zu müssen. Man muss aber mit dem Befehl sudo visudo die sudoers Datei anpassen und am Ende eine Zeile mit euerusername ALL = NOPASSWD:/sbin/shutdown einfügen. So könnt ihr den shutdown Befehl (z.B. sudo shutdown -h now) ohne Passwort ausführen.

Konfigurationsdatei

Die Informationen des gescannten Netzwerks, werden in die JSON-Datei netscan.json im Gemini Cache geschrieben.

Scannen via Terminal

Via Telnet oder SSH könnt ihr auch das Netzwerk durchforsten, z.B. für Testzwecke. Passt dazu euren IP Bereich an, wie auch die benutze Netzwerkschnittstelle (z.B. eth0, wlan0, br0, usw.). Befehl ist wie folgt:

gnetscan -d eth0 -f 192.168.1.1 -l 192.168.1.254 -o '/home/root/.geminicache/netscan.json'

Deinstallation

Deinstallation erfolgt über die Kategorie Gemini Plugins in den Addons. Wählt das gemininetscan Plugin mit der OK Taste und startet die Deinstallation mit der grünen Taste. Führt nach der Deinstallationen einen Enigma2 Neustart aus, oder startet die Dreambox neu. Oder deinstalliert das Plugin via Telnet oder SSH:

opkg remove --autoremove gemininetscan