GP3 Netscan (en): Unterschied zwischen den Versionen

Aus Gemini-Wiki
Zur Navigation springen Zur Suche springen
 
(25 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 manufacturer 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 (en)|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 Settings Automount (en)|Automount Editor]].
 
* Can transfer the found shares directly to the [[GP3 Settings Automount (en)|Automount Editor]].
 
* Supports [http://en.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 ==
−
Install the <code>gemininetscan</code> Plugin via [[GP3 Addons|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.
+
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.
  
 
== Operation ==
 
== Operation ==
−
[[Datei:GP3-Netscan1.png|thumb|right|250px|Scan settings]]
+
[[Datei:GP3-Netscan1.png|thumb|right|250px|Search]]
−
[[Datei:GP3-Netscan2.png|thumb|right|250px|Completed scan]]
+
[[Datei:GP3-Netscan2.png|thumb|right|250px|Completed search]]
−
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 startet with the {{Green|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|red}} button.
+
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.
  
−
==== Settings ====
 
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
−
! width="180"|Entry
+
! width="250"|Entry
 
! width="700"|Description
 
! width="700"|Description
 
|-  
 
|-  
 
| '''Network interface:'''
 
| '''Network interface:'''
−
| selection of the network interface e.g. eth0 or wlan0, which will be used for the scan (if multiple interfaces are available).
+
| 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 {{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.
 +
|}
 +
 
 +
==== Start portscan ====
 +
[[Datei:Netscan Portscan.png|thumb|right|250px|Settings Portscan]]
 +
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.
 +
 
 +
{| class="wikitable" border="1"
 +
! width="250"|Setting
 +
! width="700"|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.
 
|-  
 
|-  
−
| '''Start: / End:'''
+
| '''Standard:'''
−
| range od IP addresses for the scan.
+
| Search for available services and shares
 
|-  
 
|-  
−
| '''Search the Ports:'''
+
| '''1-1023:'''
−
| here you can define which ports will be scanned. Following options are possible:
+
| Search for standard ports ([http://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers#Well-known_ports well known ports]).
−
* standard - search for available services and shares (recommended setting).
 
−
* no portscan - scans for devices, without portscan.
 
−
* 1-1023 - scans for standardized ports ([http://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers#Well-known_ports well known ports]).
 
−
* 1-49151 - scans for standardized and [http://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers#Registered_ports 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?:'''
+
| '''1-49151:'''
−
| here you can indicate if your own Dreambox needs to be scanned, or not ;)
+
| Search for standard ports and [http://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers#Registered_ports registered] ports.
 
|-  
 
|-  
−
| '''Don't display devices without services:'''
+
| '''1-65535:'''
−
| devices without services can be displayed or hidden with this setting.
+
| Scan complete port range (standard, registered and dynamic).
 
|}
 
|}
  
−
{{Achtung|users with a Fritzbox from AVM, should not scan the port range 1-49151 or 1-65535.}}
+
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.
  
 
==== Shares ====
 
==== Shares ====
 
[[Datei:GP3-Netscan3.png|thumb|right|250px|Shares]]
 
[[Datei:GP3-Netscan3.png|thumb|right|250px|Shares]]
−
To see the the shares, select a device from the list and push the {{Taste|OK}} button. It's also possible to filter the list over the {{Green|green}} button, to see only the NFS and SMB shares. Keep in mind, the WinXP shares will not be displayed, only the pure NFS and [[Samba Server (en)|Samba Server]] 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>.
 
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>.
Zeile 63: Zeile 77:
 
==== Wake up ====
 
==== Wake up ====
 
[[Datei:GP3-Netscan5.png|thumb|right|250px|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.
+
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.
−
 
 
−
==== Shutdown / Reboot ====
 
−
[[Datei:GP3-Netscan4.png|thumb|right|250px|Shutdown]]
 
−
For this function, a telnet server needs to be installed on the device (e.g. Dreambox, PC, NAS, ...). The <code>gemininetscan</code> Plugin performs a login with user name and password via [[Telnet (en)|Telnet]] on the remote device and executes the command for the shutdown / reboot. The following articles explain how to install a telnet server on [http://en.wikipedia.org/wiki/Ubuntu_%28operating_system%29 Ubuntu] (Linux), [http://en.wikipedia.org/wiki/OS_X Mac OS], or [http://en.wikipedia.org/wiki/Microsoft_Windows Windows].
 
−
 
 
−
* [http://www.cyberciti.biz/faq/ubuntu-linux-enable-telnet-service/ Ubuntu]
 
−
* [http://support.apple.com/kb/TA20443 Mac OS X]
 
−
* [http://technet.microsoft.com/en-gb/library/cc770501%28v=ws.10%29.aspx Windows]
 
−
 
 
−
The shutdown (or reboot) is initiated over the {{Blue|blue}} button, where the required informations e.g. port, user name, password, ... needs to be entered. Push the {{Green|green}} button, to shutdown the device. The following table explains the required informations.
 
−
 
 
−
{| class="wikitable" border="1"
 
−
! width="180"|Eingabe
 
−
! width="700"|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 <code>gemininetscan</code> bereitgestellten Befehle für den Neustart und das Herunterfahren.
 
−
* 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.
 
−
|}
 
  
 
== Configuration file ==
 
== Configuration file ==
−
The informations of the scanned network is stored in the [http://en.wikipedia.org/wiki/JSON JSON] file <code>netscan.json</code> in the [[GP3 general settings (en)#Path for Gemini-Cache|Gemini Cache]].
+
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]].
  
 
== Scan via Terminal ==
 
== 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:
 
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>
−
gnetscan -d eth0 -f 192.168.1.1 -l 192.168.1.254 -o '/home/root/.geminicache/netscan.json'
+
gnetscan -d eth0 -f 192.168.1.1 -l 192.168.1.254 -o '/home/root/.geminicache/gnetscan.json'
−
</syntaxhighlight>
 
−
 
 
−
== Deinstallation ==
 
−
Removing the plugin is done via [[GP3 Addons|Addons]]. In the category '''Gemini Plugins''' select <code>gemininetscan</code> with the {{Taste|OK}} button and start the deinstallation with the {{Green|green}} button. After installing the plugin an [[Enigma2]] restart or reboot of the Dreambox is required. It's also possible to remove the plugin via [[Telnet (en)]] or SSH:
 
−
<syntaxhighlight>
 
−
opkg remove gemininetscan
 
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
[[Kategorie:GP3 (en)]]
 
[[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'
Abgerufen von „http://wiki.blue-panel.com/index.php?title=GP3_Netscan_(en)&oldid=18024“