GP3 Netscan (en): Unterschied zwischen den Versionen

Aus Gemini-Wiki
Zur Navigation springen Zur Suche springen
 
(17 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 to 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 discovered 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 / Deinstallation ==
 
== Installation / Deinstallation ==
Zeile 19: Zeile 18:
 
{{Hauptbeitrag (en)|GP3 Addons (en){{!}}GP3 Addons| - Category: Gemini Plugins}}
 
{{Hauptbeitrag (en)|GP3 Addons (en){{!}}GP3 Addons| - Category: Gemini Plugins}}
 
{{Hauptbeitrag (en)|WebAdmin (en){{!}}WebAdmin| - Package name: <code>gemininetscan</code>}}
 
{{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>}}
 
{{Hauptbeitrag (en)|OPKG (en){{!}}OPKG| - Package name: <code>gemininetscan</code>}}
 
Restart [[Enigma2 (en)|Enigma2]] after the installation, or reboot the Dreambox.
 
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 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 services, MAC addresses, .... 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
 
|-  
 
|-  
Zeile 35: Zeile 34:
 
| 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: / End:'''
+
| '''Start IP: / End IP:'''
 
| Range or IP addresses for the scan.
 
| Range or IP addresses for the scan.
 
|-  
 
|-  
| '''Search the Ports:'''
+
| '''Use Upnp and Zerokonf/Bonjour:'''
| Here you can define which ports will be scanned. Following options are possible:
+
| 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.
* 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]).
+
==== Start portscan ====
* 1-49151 - scans for standardized and [http://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers#Registered_ports registered] ports.
+
[[Datei:Netscan Portscan.png|thumb|right|250px|Settings Portscan]]
* 1-65535 - scan complete (standardized, registered and dynamic) port range.
+
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.
* Shares - scans only for NFS and SMB shares. Keep in mind, Windows XP shares are not detected.
+
 
 +
{| class="wikitable" border="1"
 +
! width="250"|Setting
 +
! width="700"|Description
 
|-  
 
|-  
| '''Scan own IP?:'''
+
| '''Shares (NFS, SMB, FTP):'''
| Here you can indicate if your own Dreambox needs to be scanned, or not ;)
+
| Search only for NFS, SMB and FTP shares. Keep in mind, SMB shares from Windows XP upwards are not displayed.
 
|-  
 
|-  
| '''Don't display devices without services:'''
+
| '''Standard:'''
| Devices without services can be displayed or hidden with this setting.
+
| 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).
 
|}
 
|}
  
{{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 65: Zeile 78:
 
[[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"|Entry
 
! width="700"|Description
 
|-
 
| '''IP:'''
 
| IP adress of the remote device.
 
|-
 
| '''Port (default 23):'''
 
| Port number which is used for the telnet server to connect (default port 23).
 
|-
 
| '''Telnet user:'''
 
| User name, which is used to login onto the telnet server. the user needs the appropriate user rights (root / admin), to shutdown the device!
 
|-
 
| '''Telnet password:'''
 
| Password of the user.
 
|-
 
| '''Command:'''
 
| Selection of the command for the shutdown or reboot. Different commands for Linux devices, Mac OS and Windows. It's recommended to test the command, after a successful login onto the telnet server with the user name and password. This way you can check the user rights and the command for the shutdown. The following list gives an overview of the commands offered by <code>gemininetscan</code> to initiate a shutdown or reboot.
 
* Linux - shutdown: <code>shutdown</code>
 
* Linux - shutdown: <code>poweroff</code>
 
* Linux - shutdown: <code>halt</code>
 
* Linux - reboot: <code>reboot</code>
 
* Mac OS - shutdown: <code>shutdown -h now</code>
 
* Mac OS - reboot: <code>shutdown -r now</code>
 
* Windows - shutdown: <code>shutdown -s -f</code>
 
* Windows - reboot: <code>shutdown -r -s -f</code>
 
Additionally the plugin offers the selection <code>[https://help.ubuntu.com/community/RootSudo sudo]</code> for linux e.g. for Ubuntu. With this command it's possible to shutdown the computer without activating the <code>root</code> account. But it's required to modify the <code>sudoers</code> file with the command <code>sudo visudo</code>, and add the line <code>'''your_user_name ALL = NOPASSWD:/sbin/shutdown'''</code> at the end. This way you can execute the shutdown command (e.g. sudo shutdown -h now) without password.
 
|}
 
  
 
== 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>
 
</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'