GP3 Netscan (en): Unterschied zwischen den Versionen

Aus Gemini-Wiki
Zur Navigation springen Zur Suche springen
 
(46 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 4: Zeile 4:
 
  |}
 
  |}
 
[[Datei:GP3-Netscan2.png|thumb|right|400px|Overview of the found devices]]
 
[[Datei:GP3-Netscan2.png|thumb|right|400px|Overview of the found devices]]
The <code>gemininetscan</code> Plugin scans the local network for available devices. subsequently (depending on the settings) a port scan is performed do discover open [http://en.wikipedia.org/wiki/Port_%28computer_networking%29 Ports].  The result is displayed on the TV screen. Following functions are covered by the plugin:
+
The <code>'''gemininetscan'''</code> Plugin scans the local network for available devices with <code>[http://fping.sourceforge.net/ fping]</code>. Subsequently a port scan can be performed to discover shares (with [https://www.thc.org/thc-amap/ amap]) or open [http://en.wikipedia.org/wiki/Port_%28computer_networking%29 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).
 
* Scan the local network for available devices (via eth0 or wlan0).
* List the services of the discoverd devices.
+
* Executes a port scan for the discovered devices.
* Display the [http://en.wikipedia.org/wiki/MAC_address MAC adresses] of the devices, including the [http://en.wikipedia.org/wiki/Organizationally_Unique_Identifier manufacturar info].
+
* Display the [http://en.wikipedia.org/wiki/MAC_address MAC addresses] of the devices, including the [http://en.wikipedia.org/wiki/Organizationally_Unique_Identifier manufacturer info].
* Scans for available [[Samba Server|Samba]] and [[NFS]] shares.
+
* Scans for available [[Samba Server (en)|Samba]], NFS and [[FTP (en)|FTP]]shares.
* Can transfer the found shares directly to the [[GP3 Einstellungen Automount|Automount Editor]].
+
* Can transfer the found shares directly to the [[GP3 Settings Automount (en)|Automount Editor]].
* Supports [http://de.wikipedia.org/wiki/Wake_On_LAN WOL], to wake up devices.
+
* Supports [http://en.wikipedia.org/wiki/Wake-on-LAN WOL], to wake up devices.
* Can initiate a shutdown or reboot, if a Telnet server is installed on the device.
+
* Displays active / inactive devices ([[Datei:state_green.png|text-center]] = online / [[Datei:state_red.png|text-center]] = offline).  
* Displays active / inactive devices ([[Datei:Dot_green.png|13px|text-top]] = online / [[Datei:Dot_red.png|13px|text-top]] = offline).  
 
  
== Installation ==
+
== Installation / Deinstallation ==
Installiert das <code>gemininetscan</code> Plugin via [[GP3 Addons|Addons]] im Blue Panel. Das Paket befindet sich in der Kategorie '''Gemini Plugins'''. Führt nach der Installationen einen [[Enigma2]] Neustart aus, oder startet die Dreambox neu. Alternativ kann das Plugin auch via [[Telnet]] oder [[SSH]] mit folgendem Befehl installiert werden.
+
The <code>gemininetscan</code> plugin can be installed / removed in different ways:
<syntaxhighlight>
+
{{Hauptbeitrag (en)|GP3 Addons (en){{!}}GP3 Addons| - Category: Gemini Plugins}}
opkg update && opkg install gemininetscan
+
{{Hauptbeitrag (en)|WebAdmin (en){{!}}WebAdmin| - Package name: <code>gemininetscan</code>}}
</syntaxhighlight>
+
{{Hauptbeitrag (en)|APT (en){{!}}APT| - Package name: <code>gemininetscan</code>}}
 +
{{Hauptbeitrag (en)|OPKG (en){{!}}OPKG| - Package name: <code>gemininetscan</code>}}
 +
Restart [[Enigma2 (en)|Enigma2]] after the installation, or reboot the Dreambox.
  
== Bedienung ==
+
== Operation ==
[[Datei:GP3-Netscan1.png|thumb|right|250px|Scan Einstellungen]]
+
[[Datei:GP3-Netscan1.png|thumb|right|250px|Search]]
[[Datei:GP3-Netscan2.png|thumb|right|250px|Abgeschlossener Scan]]
+
[[Datei:GP3-Netscan2.png|thumb|right|250px|Completed search]]
Nach dem Start des Plugins, könnt ihr mit der {{Red|roten}} Taste die Einstellungen öffnen. Die folgende Tabelle zeigt die verschiedenen Optionen. Startet nach den Einstellungen das scannen mit der {{Green|Start}} Taste. Nach dem Durchsuchen des Netzwerkes, erscheint eine Liste der gefunden Geräte, inklusive Informationen zu den Diensten, MAC Adresse, usw. Eine weitere Suche, kann zu jederzeit mit der {{Red|roten}} Taste gestartet werden.
+
After starting the plugin, you can open the settings with the {{Red|red}} button. The following table lists the different options. The scan can be started with the {{Green|Start}} button. Once the scan of the network is completed, a list of available devices is displayed. Including the informations concerning the manufacturer, MAC addresses, .... An additional scan can be started at any moment over the {{Red|red}} button.
  
==== Einstellungen ====
 
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
! width="180"|Eingabe
+
! width="250"|Entry
! width="700"|Beschreibung
+
! width="700"|Description
|-
 
| '''Netzwerkadapter:'''
 
| Auswahl des Netzwerkadapters z.B. eth0 oder wlan0, worüber gesucht werden soll (sofern mehrere verfügbar sind).
 
|-
 
| '''Start: / Ende:'''
 
| IP Adressen Bereich für das Scannen eingeben.
 
 
|-  
 
|-  
| '''Durchsuche die Ports:'''
+
| '''Network interface:'''
| Hier könnt ihr definieren, nach welchen Ports gesucht werden soll. Als Auswahl stehen folgende Optionen zur Verfügung:
+
| Selection of the network interface e.g. eth0 or wlan0, which will be used for the scan (if multiple interfaces are available).
* Standard - Suche nach verfügbaren Diensten und Freigaben (empfohlene Einstellung).
 
* Kein Portscan - Sucht nur nach Geräten, ohne Portscan.
 
* 1-1023 - Suche nach Standardisierten Ports ([http://de.wikipedia.org/wiki/Liste_der_standardisierten_Ports#Standardisierte_Ports_.280.E2.80.931023.29 well known ports]).
 
* 1-49151 - Suche nach Standardisierten und [http://de.wikipedia.org/wiki/Liste_der_standardisierten_Ports#Registrierte_Ports:_1024.E2.80.9349151 Registrierten] Ports.
 
* 1-65535 - Kompletter (Standardisierte, Registrierte und Dynamische) Port Bereich absuchen.
 
* Freigaben - Sucht nur nach NFS und SMB Freigaben. Beachtet bitte, dass Freigaben ab Windows XP nicht angezeigt werden.
 
 
|-  
 
|-  
| '''Eigene IP scannen?:'''
+
| '''Start IP: / End IP:'''
| Hier könnt ihr die eigene Dreambox scannen, oder eben nicht ;)
+
| Range or IP addresses for the scan.
 
|-  
 
|-  
| '''Geräte ohne Service nicht anzeigen:'''
+
| '''Use Upnp and Zerokonf/Bonjour:'''
| Geräte ohne Dienste können mit dieser Einstellung ein- oder ausgeblendet werden.
+
| If the setting is {{Taste|on}}, the devices are searched via Upnp/Avahi. Use {{Taste|off}} if the search initiates a router crash (e.g. Fritzbox). In this case the search is performed via DNS functions ([http://de.wikipedia.org/wiki/Nslookup nslookup]) and Samba.
 
|}
 
|}
  
{{Achtung|Benutzer mit einer Fritzbox von AVM, sollten keinen Scann mit der Portauswahl 1-49151 und 1-65535 durchführen.}}
+
==== Start portscan ====
 
+
[[Datei:Netscan Portscan.png|thumb|right|250px|Settings Portscan]]
==== Freigaben ====
+
A portscan for the found devices can be executed. Select the wanted device with the {{Taste|OK}} button. In the following window, it is possible to perform a scan for the device with the following settings (see below). Use the navigation buttons {{Taste|}} {{Taste|}}, to change the settings.
[[Datei:GP3-Netscan3.png|thumb|right|250px|Freigaben]]
 
Um Freigaben zu sehen, müsst ihr in der Liste, das gewünschte Gerät mit der {{Taste|OK}} auswählen. Ihr könnt anschliessend auch den Filter mit der {{Green|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 {{Red|rote}} Taste. Die Freigabe wird so automatisch an den [[GP3 Einstellungen Automount|Automount Editor]] übergeben. Ändert im Editor noch die gewünschten Einstellungen und schon könnt ihr das Gerät via <code>/media/net/mountpunkt</code> erreichen.
 
 
 
==== Aufwecken ====
 
[[Datei:GP3-Netscan5.png|thumb|right|250px|Aufwecken]]
 
Aufwecken von Geräten erfolgt in der Liste über die {{Green|grüne}} Taste. Beachtet aber, dass die Geräte [http://de.wikipedia.org/wiki/Wake_On_LAN WOL] unterstützen müssen und die Funktion muss natürlich aktiviert sein. Lest dazu bitte die [http://de.wikipedia.org/wiki/Betriebsanleitung Betriebsanleitungen] eurer verwendeten Geräte. Um Geräte aufzuwecken, wird der <code>/usr/bin/ether-wake</code> Befehl der [[Busybox]] verwendet.
 
 
 
==== Herunterfahren / Neustart ====
 
[[Datei:GP3-Netscan4.png|thumb|right|250px|Herunterfahren]]
 
Für die Funktion, muss ein Telnet Server auf dem Gerät (z.B. Dreambox, PC, NAS, usw.) installiert sein. Das <code>gemininetscan</code> 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 [http://de.wikipedia.org/wiki/Ubuntu Ubuntu] (Linux), [http://de.wikipedia.org/wiki/Mac_OS_X Mac OS], oder [http://de.wikipedia.org/wiki/Windows Windows] eingerichtet wird.
 
 
 
* [http://www.cyberciti.biz/faq/ubuntu-linux-enable-telnet-service/ Ubuntu]
 
* [http://support.apple.com/kb/TA20443 Mac OS X]
 
* [http://technet.microsoft.com/de-de/library/cc770501%28WS.10%29.aspx Windows]
 
 
 
Das Herunterfahren (oder Neustart) erfolgt über die {{Blue|blaue}} Taste, wo anschliessend die benötigten Informationen z.B. Port, Benutzername, Passwort, usw. eingegeben werden müssen. Drückt nachher die {{Green|grüne}} Taste, um das Gerät auszuschalten. Die folgende Tabelle beschreibt die benötigten Informationen.  
 
  
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
! width="180"|Eingabe
+
! width="250"|Setting
! width="700"|Beschreibung
+
! width="700"|Description
 
|-  
 
|-  
| '''IP:'''
+
| '''Shares (NFS, SMB, FTP):'''
| IP Adresse des auszuschaltenden Gerätes eingeben.
+
| Search only for NFS, SMB and FTP shares. Keep in mind, SMB shares from Windows XP upwards are not displayed.
 
|-  
 
|-  
| '''Port (Standard 23):'''
+
| '''Standard:'''
| Portnummer eingeben, auf welchen der Telnet Server lauscht (Standard Port 23).
+
| Search for available services and shares
 
|-  
 
|-  
| '''Telnet Nutzer:'''
+
| '''1-1023:'''
| Benutzername eingeben, welcher auf den Telnet Server einloggen soll. Der Benutzer benötigt entsprechende Rechte (root / admin), um das Gerät auszuschalten!
+
| Search for standard ports ([http://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers#Well-known_ports well known ports]).
 
|-  
 
|-  
| '''Telnet Passwort:'''
+
| '''1-49151:'''
| Passwort des Benutzer eingeben.
+
| Search for standard ports and [http://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers#Registered_ports registered] ports.
 
|-  
 
|-  
| '''Befehl:'''
+
| '''1-65535:'''
| 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 <code>gemininetscan</code> bereitgestellten Befehle für den Neustart und das Herunterfahren.
+
| Scan complete port range (standard, registered and dynamic).
* Linux - ausschalten: <code>shutdown</code>
 
* Linux - ausschalten: <code>poweroff</code>
 
* Linux - ausschalten: <code>halt</code>
 
* Linux - Neustart: <code>reboot</code>
 
* Mac OS - ausschalten: <code>shutdown -h now</code>
 
* Mac OS - Neustart: <code>shutdown -r now</code>
 
* Windows - ausschalten: <code>shutdown -s -f</code>
 
* Windows - Neustart: <code>shutdown -r -s -f</code>
 
Zusätzlich gibt es für Linux die Auswahl mit <code>[http://wiki.ubuntuusers.de/sudo sudo]</code> z.B für Ubuntu. Damit könnt ihr den Rechner herunterfahren, ohne den <code>root</code> Account aktivieren zu müssen. Man muss aber mit dem Befehl <code>sudo visudo</code> die <code>sudoers</code> Datei anpassen und am Ende eine Zeile mit <code>'''euerusername ALL = NOPASSWD:/sbin/shutdown'''</code> einfügen. So könnt ihr den shutdown Befehl (z.B. sudo shutdown -h now) ohne Passwort ausführen.
 
 
|}
 
|}
  
== Konfigurationsdatei ==
+
After the selection is made, the portscan can be started with {{Green|Save}}, or the {{Taste|OK}} button. After the search is finished, the found info (services, shares) are displayed on the screen.
Die Informationen des gescannten Netzwerks, werden in die [http://de.wikipedia.org/wiki/JavaScript_Object_Notation JSON]-Datei <code>netscan.json</code> im [[GP3 Einstellungen Allgemein #Speicherort für Gemini-Cache|Gemini Cache]] geschrieben.
+
 
 +
==== Shares ====
 +
[[Datei:GP3-Netscan3.png|thumb|right|250px|Shares]]
 +
After the portscan is completed, the found SMB or NFS shares are identified with the text '''Share:'''. It's possible to use a filter with the {{Green|green}} button (only shares). This will only display the found NFS and SMB shares. Use the {{Green|green}} button (show all) again, to see all informations.
 +
 
 +
Keep in mind, the WinXP shares will not be displayed, only the pure NFS and [[Samba Server (en)|Samba Server]] shares.
 +
 
 +
Mounting a NFS or SMB share is easy. Select the share and push the {{Red|red}} button. The share will be transfered to the [[GP3 Settings Automount (en)|Automount Editor]]. Modify the settings and the device can be reached over <code>/media/net/mountpoint</code>.
 +
 
 +
==== Wake up ====
 +
[[Datei:GP3-Netscan5.png|thumb|right|250px|Wake up]]
 +
Wake up of devices is performed in the list with the {{Green|green}} button. Keep in mind, the devices should support [http://en.wikipedia.org/wiki/Wake-on-LAN WOL] and the function needs to be activated. Please read the [http://en.wikipedia.org/wiki/User_guide manual] of your used devices. To wake up devices, the <code>/usr/bin/ether-wake</code> command of [[BusyBox (en)|BusyBox]] is used.
  
== Scannen via Terminal ==
+
== Configuration file ==
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:
+
The informations of the scanned network is stored in the [http://en.wikipedia.org/wiki/JSON JSON] file <code>gnetscan.json</code> in the [[GP3 general settings (en)#Path for Gemini-Cache|Gemini Cache]].
<syntaxhighlight>
 
gnetscan -d eth0 -f 192.168.1.1 -l 192.168.1.254 -o '/home/root/.geminicache/netscan.json'
 
</syntaxhighlight>
 
  
== Deinstallation ==
+
== Scan via Terminal ==
Deinstallation erfolgt über die Kategorie '''Gemini Plugins''' in den [[GP3 Addons|Addons]]. Wählt das <code>gemininetscan</code> Plugin mit der {{Taste|OK}} Taste und startet die Deinstallation mit der {{Green|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]]:
+
It's also possible to scan the network via [[Telnet (en)]] or SSH, e.g. for testing purposes. Use your IP range, the used interface (e.g. eth0, wlan0, br0, ...). The command is:
 
<syntaxhighlight>
 
<syntaxhighlight>
opkg remove --autoremove gemininetscan
+
gnetscan -d eth0 -f 192.168.1.1 -l 192.168.1.254 -o '/home/root/.geminicache/gnetscan.json'
 
</syntaxhighlight>
 
</syntaxhighlight>
  
[[Kategorie:GP3]]
+
[[Kategorie:GP3 (en)]]

Aktuelle Version vom 4. September 2016, 18:36 Uhr

Deutsch.png - in Deutsch English.png - in English
Overview of the found devices

The gemininetscan Plugin scans the local network for available devices with fping. Subsequently a port scan can be performed to discover shares (with amap) or 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).
  • Executes a port scan for the discovered devices.
  • Display the MAC addresses of the devices, including the manufacturer info.
  • Scans for available Samba, NFS and FTPshares.
  • Can transfer the found shares directly to the Automount Editor.
  • Supports WOL, to wake up devices.
  • Displays active / inactive devices (text-center = online / text-center = offline).

Installation / Deinstallation

The gemininetscan plugin can be installed / removed in different ways:

Hauptbeitrag.png see article: GP3 Addons - Category: Gemini Plugins
Hauptbeitrag.png see article: WebAdmin - Package name: gemininetscan
Hauptbeitrag.png see article: APT - Package name: gemininetscan
Hauptbeitrag.png see article: OPKG - Package name: gemininetscan

Restart Enigma2 after the installation, or reboot the Dreambox.

Operation

Search
Completed search

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

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 IP: / End IP: Range or IP addresses for the scan.
Use Upnp and Zerokonf/Bonjour: If the setting is on, the devices are searched via Upnp/Avahi. Use off if the search initiates a router crash (e.g. Fritzbox). In this case the search is performed via DNS functions (nslookup) and Samba.

Start portscan

Settings Portscan

A portscan for the found devices can be executed. Select the wanted device with the OK button. In the following window, it is possible to perform a scan for the device with the following settings (see below). Use the navigation buttons , to change the settings.

Setting Description
Shares (NFS, SMB, FTP): Search only for NFS, SMB and FTP shares. Keep in mind, SMB shares from Windows XP upwards are not displayed.
Standard: Search for available services and shares
1-1023: Search for standard ports (well known ports).
1-49151: Search for standard ports and registered ports.
1-65535: Scan complete port range (standard, registered and dynamic).

After the selection is made, the portscan can be started with Save, or the OK button. After the search is finished, the found info (services, shares) are displayed on the screen.

Shares

Shares

After the portscan is completed, the found SMB or NFS shares are identified with the text Share:. It's possible to use a filter with the green button (only shares). This will only display the found NFS and SMB shares. Use the green button (show all) again, to see all informations.

Keep in mind, the WinXP shares will not be displayed, only the pure NFS and Samba Server shares.

Mounting a NFS or SMB share is easy. Select the share and push the red button. The share will be transfered to the Automount Editor. Modify the settings and the device can be reached over /media/net/mountpoint.

Wake up

Wake up

Wake up of devices is performed in the list with the green button. Keep in mind, the devices should support WOL and the function needs to be activated. Please read the manual of your used devices. To wake up devices, the /usr/bin/ether-wake command of BusyBox is used.

Configuration file

The informations of the scanned network is stored in the JSON file gnetscan.json in the Gemini Cache.

Scan via Terminal

It's also possible to scan the network via Telnet (en) or SSH, e.g. for testing purposes. Use your IP range, the used interface (e.g. eth0, wlan0, br0, ...). The command is:

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