GP3 Netscan (en): Unterschied zwischen den Versionen

Aus Gemini-Wiki
Zur Navigation springen Zur Suche springen
 
(51 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 2: Zeile 2:
 
  |[[Bild:deutsch.png]] - [[GP3 Netscan|in Deutsch]]
 
  |[[Bild:deutsch.png]] - [[GP3 Netscan|in Deutsch]]
 
  |[[Bild:english.png]] - [[GP3 Netscan (en)|in English]]
 
  |[[Bild:english.png]] - [[GP3 Netscan (en)|in English]]
  |}  
+
  |}
== Netscan ==
+
[[Datei:GP3-Netscan2.png|thumb|right|400px|Overview of the found devices]]
 +
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).
|-
+
* Executes a port scan for the discovered devices.
|-valign="top"
+
* 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].
|[[Bild:GP3-Netscan1.png|left|thumb|500px|Netscan search]] || [[Bild:GP3-Netscan2.png|left|thumb|500px|Overview of the found devices, the green point indicates the device is online]]
+
* 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]].
 +
* Supports [http://en.wikipedia.org/wiki/Wake-on-LAN WOL], to wake up devices.
 +
* Displays active / inactive devices ([[Datei:state_green.png|text-center]] = online / [[Datei:state_red.png|text-center]] = offline).
 +
 
 +
== Installation / Deinstallation ==
 +
The <code>gemininetscan</code> plugin can be installed / removed in different ways:
 +
{{Hauptbeitrag (en)|GP3 Addons (en){{!}}GP3 Addons| - Category: Gemini Plugins}}
 +
{{Hauptbeitrag (en)|WebAdmin (en){{!}}WebAdmin| - Package name: <code>gemininetscan</code>}}
 +
{{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 ==
 +
[[Datei:GP3-Netscan1.png|thumb|right|250px|Search]]
 +
[[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 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.
 +
 
 +
{| class="wikitable" border="1"
 +
! width="250"|Entry
 +
! width="700"|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 {{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]]
|-valign="top"
+
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.
|[[Bild:GP3-Netscan3.png|left|thumb|500px|Found services on a device]] || [[Bild:GP3-Netscan4.png|left|thumb|500px|Devices can be shutdown, if a Telnet server is running on the device. Tested with Windows7, Ubuntu and Android.
 
  
For windows Windows you can install a Telnet server as follows.http://technet.microsoft.com/de-de/library/cc770501%28WS.10%29.aspx
+
{| class="wikitable" border="1"
For Ubuntu:
+
! width="250"|Setting
http://www.cyberciti.biz/faq/ubuntu-linux-enable-telnet-service/]]
+
! 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.
 +
|-
 +
| '''Standard:'''
 +
| Search for available services and shares
 +
|-
 +
| '''1-1023:'''
 +
| Search for standard ports ([http://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers#Well-known_ports well known ports]).
 +
|-
 +
| '''1-49151:'''
 +
| Search for standard ports and [http://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers#Registered_ports registered] ports.
 +
|-  
 +
| '''1-65535:'''
 +
| Scan complete port range (standard, registered and dynamic).
 
|}
 
|}
  
{|  
+
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.
|-
+
 
|-valign="top"
+
==== Shares ====
[[Bild:GP3-Netscan5.png|left|thumb|300px|Start device with Wakeon LAN]]
+
[[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.
 +
 
 +
== Configuration file ==
 +
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 ==
 +
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>
 +
gnetscan -d eth0 -f 192.168.1.1 -l 192.168.1.254 -o '/home/root/.geminicache/gnetscan.json'
 +
</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'