Merge pull request #614 from i-doit:370-how-to-install-nmap-for-ping-…

…in-ip-lists

added Nmap installation and IP List pinging

docs/de/auswertungen/ip-listen.md

@@ -55,3 +55,53 @@ Die Kategorie **IP-Liste** bietet eine Möglichkeit zum Abgleich zwischen Soll-
 *   **Ping**: ICMP-Paket an IP-Adresse schicken
 *   **NSLOOKUP**: IP-Adresse zum Hostname bestimmen
 *   **Reverse NSLOOKUP**: Hostname zur IP-Adresse bestimmen
+
+## Nmap Installation
+
+### Windows
+
+Lade die neueste stable Version von Nmap auf <https://nmap.org/download.html> herunter und führe die Installation aus.
+
+Falls du die Datei aus irgendeinem Grund nicht direkt herunterladen kannst, kannst du die Kommandozeile verwenden.<br>
+Öffne die Eingabeaufforderung und benutze `bitsadmin`, um das Nmap-Zip-Archiv herunterzuladen
+
+```cmd
+bitsadmin /transfer nmapDownloadJob /download /priority normal https://nmap.org/dist/nmap-7.92-win32.zip C:\nmap-7.92-win32.zip
+```
+
+!!! attention "Aktuell ist die letzte Zip-Datei nicht die neueste stable Version."
+
+Sobald Nmap installiert ist, füge das Nmap-Verzeichnis zur Systemumgebungsvariablen PATH hinzu
+
+```cmd
+setx PATH "%PATH%;C:\nmap"
+```
+
+!!! warning "Stelle sicher, dass der Pfad dem Verzeichnis entspricht, in dem du Nmap extrahiert hast"
+
+### Unix
+
+#### Debian or Ubuntu
+
+```sh
+sudo apt update
+sudo apt install nmap
+```
+
+#### Red Hat Enterprise Linux (RHEL)
+
+```sh
+sudo dnf install nmap
+```
+
+or
+
+```sh
+sudo yum install nmap
+```
+
+## IP-Listen Ping
+
+Sobald Nmap installiert ist, steht die Ping Funktion zur Verfügung.
+
+[![Ping Button in IP list](../assets/images/de/auswertungen/ip-listen/ip-liste-2.png)](../assets/images/de/auswertungen/ip-listen/ip-liste-2.png)

docs/en/evaluation/ip-list.md

@@ -1,23 +1,34 @@
 # IP List
+
 Again and again there is one central issue for the Admin: Which IP addresses are assigned to which host and which addresses can still be assigned? The IP lists in i-doit can be a great help to tackle this question.
 
 A more detailed approach into this matter is provided in the application case for the [IP Address Management (IPAM)](../use-cases/ip-adress-management.md).
 
-IP List Category
-----------------
+## IP List Category
 
-The **IP list** [category](../basics/structure-of-the-it-documentation.md) provides a comprehensive overview of each net. In the default installation of i-doit it is assigned to the [object type](../basics/structure-of-the-it-documentation.md) Layer-3-Net. You can find all [objects](../basics/structure-of-the-it-documentation.md) which are assigned to this net, including their IP address, host name and type of address assignment, in a tabular listing.
+The **IP list** [category](../basics/structure-of-the-it-documentation.md) provides a comprehensive overview of each net. In the default installation of i-doit it is assigned to the [object type](../basics/structure-of-the-it-documentation.md) **Layer-3-Net**. You can find all [objects](../basics/structure-of-the-it-documentation.md) which are assigned to this net, including their IP address, host name and type of address assignment, in a tabular listing.
 
 [![IP List Category](../assets/images/en/evaluation/ip-list/1-il.png)](../assets/images/en/evaluation/ip-list/1-il.png)
 
 The type of address assignment is presented with colors and their respective meaning is explained in a color key on the right of the list:
 
-*   **Green:** Net address / Broadcast
-*   **Yellow:** Default Gateway (This is the object for which you defined in the Host address category that it should act as default gateway.)
-*   **Orange:** unnumbered address range
-*   **Gray:** statically assigned IP addresses
-*   **Blue:** IP addresses which are reserved by the DHCP server (see also **DHCP** category)
-*   **Light blue:** IP addresses which are assigned dynamically by the DHCP server (see also **DHCP** category)
+*   **Green:**<br>
+    Net address / Broadcast
+
+*   **Yellow:**<br>
+    Default Gateway (This is the object for which you defined in the Host address category that it should act as default gateway.)
+
+*   **Orange:**<br>
+    unnumbered address range
+
+*   **Gray:**<br>
+    statically assigned IP addresses
+
+*   **Blue:**<br>
+    IP addresses which are reserved by the DHCP server (see also **DHCP** category)
+
+*   **Light blue:**<br>
+    IP addresses which are assigned dynamically by the DHCP server (see also **DHCP** category)
 
 In order to avoid (unintentional) address conflicts, i-doit points out multiple assigned IP addresses beside the table.
 
@@ -33,16 +44,64 @@ Another table on the right concludes important information about the net:
 *   Superordinate supernets (object type **Supernet**)
 *   Assigned VLANs (object type **Layer-2-Net**)
 
-Object Assignment
------------------
+## Object Assignment
 
 You can expand the list by further objects without using the **Host address** category but by using the **Connect object**  button.
 
-Check of IP Addresses
----------------------
+## Check of IP Addresses
 
 The **IP list** category provides the possibility to make a comparison between the target state and the actual state. In order to check if the documented IP addresses and host names are really assigned, i-doit can send ICMP packets ("Pings") and start a NSLOOKUP. For this purpose, i-doit requires net access. You can check single entries or all entries in a subsequent order. With  **Administration → System settings → Tentantsettings → Options for the IP-List** you can set which command line tools should be applied. The user/ group of the Apache webserver have to have the permission to activate these tools.
 
 *   **Ping**: Send ICMP packet to IP address
 *   **NSLOOKUP**: Specify IP address as host name
-*   **Reverse NSLOOKUP**: Specify host name for IP address
+*   **Reverse NSLOOKUP**: Specify host name for IP address
+
+## Nmap Installation
+
+### Windows
+
+Download the latest stable version of Nmap on <https://nmap.org/download.html> and run the setup.
+
+If for some reason you cannot download it directly, you can use the CLI.<br>
+Open Command Prompt and use `bitsadmin` to download the Nmap Zip archive:
+
+```cmd
+bitsadmin /transfer nmapDownloadJob /download /priority normal https://nmap.org/dist/nmap-7.92-win32.zip C:\nmap-7.92-win32.zip
+```
+
+!!! attention "Currently the last zip file is not the latest stable version."
+
+Once Nmap is installed, add the Nmap directory to the system PATH environment variable
+
+```cmd
+setx PATH "%PATH%;C:\nmap"
+```
+
+!!! warning "Ensure the path matches the directory where you extracted Nmap"
+
+### Unix
+
+#### Debian or Ubuntu
+
+```sh
+sudo apt update
+sudo apt install nmap
+```
+
+#### Red Hat Enterprise Linux (RHEL)
+
+```sh
+sudo dnf install nmap
+```
+
+or
+
+```sh
+sudo yum install nmap
+```
+
+## IP List Ping
+
+Once Nmap is installed, you will find the "Ping" Button available
+
+[![Ping Button in IP list](../assets/images/en/evaluation/ip-list/2-il.png)](../assets/images/en/evaluation/ip-list/2-il.png)