NetIO-GUI_En

Copyright © 2019 by Markus Busche and burgon. All Rights Reserved.

 NetIO-GUI_En

Inhaltsverzeichnis

Introduction ........................................................................................................................... 3
Licenses ............................................................................................................................. 3
What's new ........................................................................................................................ 3
thanksgiving ....................................................................................................................... 4
Download and Contact ........................................................................................................ 5
Getting Started ...................................................................................................................... 5
System requirements .......................................................................................................... 5
Installation ......................................................................................................................... 6
How-To .............................................................................................................................. 6
Server-Mode .................................................................................................................... 6
Client-Mode ..................................................................................................................... 7
Results database ............................................................................................................. 7
Extras .............................................................................................................................. 8
Settings ........................................................................................................................... 9
Extended ........................................................................................................................... 9
Settings via INI file .......................................................................................................... 9
Commandline parameter ................................................................................................ 10

2 / 11
 NetIO-GUI_En

Introduction

Introduction
NetIO GUI
How fast is fast enough?

NetIO GUI is a graphical user interface for the command line tool 'netio.exe' by Kai Uwe Rommel.

NetIO GUI is used to determine bandwidth between two network peers for different protocols and packet
sizes. It is ideal for assessing the available network speed, e.g. between two VPN sites or troubleshooting
the LAN.

In addition to the functions of netio.exe, NetIO GUI determines ping statistics for different packet sizes,
calculates averages, and stores all measurement results in a database for later comparison. Exporting the
results of a measurement to a text file is also possible.
Created with the Personal Edition of HelpNDoc: Free help authoring tool
Copyright © <Dates> by <Authors>. All Rights Reserved.
Created with the Personal Edition of HelpNDoc: Free Kindle producer

Licenses

Licenses
Introduction ››

NetIO GUI is freeware (free software). The author disclaims all liability for any problems arising from the
use of NetIO GUI.

(c) NetIO GUI 2012 Markus Busche, [email protected]

NetUI GUI does not contain any functional restrictions. If you have paid something for NetIO GUI, please
report the source to the author.
Created with the Personal Edition of HelpNDoc: Full-featured Kindle eBooks generator
Copyright © <Dates> by <Authors>. All Rights Reserved.
Created with the Personal Edition of HelpNDoc: Single source CHM, PDF, DOC and HTML Help creation

What's new

What's new
Introduction ››

Version 1.0, 23.06.2012

First version

3 / 11
 NetIO-GUI_En

Version 1.0.1, 30.06.2012

Debugging.
Dialog box for basic settings.
"Downgrade" to .NET 3.5 - less is not possible.
Optional AutoIT launcher, which checks the installed .NET version and, if necessary, redirects to the
Microsoft download page.
Handbook revised.
Start parameter -d (database file).

Version 1.0.2, 02.07.2012

Startup parameter -i (INI file to use).

Start parameter -z (destination IP address). New Menu Help - What's new
If the application directory is not writable, the folder '% APPDATA% \ NetIO-GUI' is created for storing
the INI file, log file and database file (installed mode).
Publication as portable version (self-extracting ZIP file) and as installable version (setup file).
Start parameter -a ('Force% APPDATA% \ NetIO GUI' as location).
Database results are sorted correctly (numerically) after clicking on column (delete old <1.0.2 .sqlite file if
necessary!).
NetIO server service via 'Extras' - Menu start and end.

Version 1.0.3, 05.07.2012

NetIO-GUI is now multilingual, supports German and English.

The mode in which NetIO GUI starts (client or server) is now adjustable.
Before uninstalling the 'netio' service, the service is now stopped.

Version 1.0.4, 05.07.2012

Prevent start in unsupported language (fallback on en-US)

Menu extension Help - License (s): NetIO GUI license and netio (new)
New Menu: Help - What's new
Export of the results database as an Excel file or CSV file
Created with the Personal Edition of HelpNDoc: Write EPub books for the iPad
Copyright © <Dates> by <Authors>. All Rights Reserved.
Created with the Personal Edition of HelpNDoc: Full-featured Help generator

thanksgiving

thanksgiving
Introduction ››

The author thanks:

4 / 11
 NetIO-GUI_En

Kai Uwe Rommel for the tool 'netio' (http://www.ars.de/ars/ars.nsf/docs/netio).

http://www.iconarchive.com/ for the some symbols.
The NLog Project team for the NLog library.
Anton Kovalenko for 'winserv.exe'.
mawnkay for the control IP textbox.
the SQLite team.
The WANem project for testing different bandwidths.
IBE SOFTWARE for helpndoc.
CalmRadio and TapinRadio for relaxing sound during troubleshooting and documentation.
Created with the Personal Edition of HelpNDoc: Free EPub and documentation generator
Copyright © <Dates> by <Authors>. All Rights Reserved.
Created with the Personal Edition of HelpNDoc: Full-featured Help generator

Download and Contact

Download and Contact

Introduction ››

The current version of NetUI GUI can soon be downloaded from the Heise Online Download Directory.

The author can be contacted by email at the address [email protected].

The author operates under the address http://forum.exilostfriesen.de/ a forum for this and other programs
of the author.
Created with the Personal Edition of HelpNDoc: Free EPub and documentation generator
Copyright © <Dates> by <Authors>. All Rights Reserved.
Created with the Personal Edition of HelpNDoc: Free help authoring tool

Getting Started

Getting Started
Created with the Personal Edition of HelpNDoc: Generate EPub eBooks with ease
Copyright © <Dates> by <Authors>. All Rights Reserved.
Created with the Personal Edition of HelpNDoc: Produce Kindle eBooks easily

System requirements

System requirements
Getting Started ››

NetIO GUI requires the following system requirements:

· Operating system: Microsoft Windows XP or later (tested on Windows XP 32-bit, Windows Vista 32-
bit, Windows 7 32-bit and 64-bit, Windows Server 2003 32-bit, Windows Server 2008 64-bit)
· Microsoft's .NET Framework 3.5 Client Profile (Microsoft Download Page)
Created with the Personal Edition of HelpNDoc: Full-featured Kindle eBooks generator

5 / 11
 NetIO-GUI_En

Copyright © <Dates> by <Authors>. All Rights Reserved.

Created with the Personal Edition of HelpNDoc: Free EBook and documentation generator

Installation

Installation
Getting Started ››

NetIO GUI is delivered as a self-extracting 7-zip file 'netio-gui_v [version number] _portable.exe'. The
installation is done by starting the file. All required files are unpacked into any folder.

NetIO-GUI is designed as a portable application, so it can be used on a removable disk on different PCs.
Because of this, NetIO GUI requires write access to the folder where it was installed.

The program is started by calling 'NetIO-GUI.exe or the launcher' check_dotnet35_and_launch_netio-

gui.exe '(see operation).
Created with the Personal Edition of HelpNDoc: Generate EPub eBooks with ease
Copyright © <Dates> by <Authors>. All Rights Reserved.
Created with the Personal Edition of HelpNDoc: Generate Kindle eBooks with ease

How-To

How-To
Getting Started ››

Getting Started >> Parent Previous Next NetIO GUI must be started on two PCs. One PC acts as a server,
the other as a client. The measurement is performed on the client PC. There, the database with the
measurement results is stored.

NetIO can be started by directly running NetIO-GUI.exe or the launcher

check_dotnet35_and_launch_netio-gui.exe. The latter checks the system for the required Microsoft .NET
3.5 client profile and then starts NetIO-GUI or points to Microsoft's download page.
Created with the Personal Edition of HelpNDoc: Free Qt Help documentation generator
Copyright © <Dates> by <Authors>. All Rights Reserved.
Created with the Personal Edition of HelpNDoc: Free HTML Help documentation generator

Server-Mode

Server-Mode
Getting Started ›› How-To ››

The server is started by clicking on the 'Server mode' option and then clicking on 'Start server'. This makes
the server ready for operation and answers network requests from the client.

In the 'Settings' area, the TCP / IP port and an IP address on which the server responds can be set. By
default, the server binds to all existing network adapters (IP addresses). If the port is changed, the client
must be set to the same port. The server always responds to TCP and UDP requests.

6 / 11
 NetIO-GUI_En

Enabled server mode

Note: The NetIO GUI Server requires an exception rule for 'netio.exe' and for incoming ICMP (Ping)
packets when Windows Firewall is activated. The rule for 'netio.exe' may be requested automatically
when the server is started. If this does not happen, an appropriate exemption rule can be set manually via
the menu item 'Firewall settings'. The exception rule for incoming ICMP packets is not automatically
created and should be set up the same way once. The menu item 'Firewall Settings' is only available in
activated server mode.

Any installed third-party firewall software should be disabled for the duration of the measurement.
Created with the Personal Edition of HelpNDoc: Easily create PDF Help documents
Copyright © <Dates> by <Authors>. All Rights Reserved.
Created with the Personal Edition of HelpNDoc: Easily create CHM Help documents

Client-Mode

Client-Mode
Getting Started ›› How-To ››

After activating the client mode different settings and input fields are activated:

IP address: enter the IP address of the server here (see status bar on the server page)
Protocol: The measurement can be done either via TCP or UDP protocol
Unit of measurement: Measurement unit for the measurement results (can also be switched after the
measurement has been carried out)
Tests Ping, NetIO: tests to be performed

Enabled client mode

By clicking on the 'Start Client' button, the selected tests are performed. The results are entered in the
fields at runtime and the progress is displayed using a progress bar.

Completed measurement

After successful completion of the measurement, the measurement results are entered in a database file.
Here it is possible to enter a comment for the measurement:

Comment entry

As long as measurement results are displayed in windows, it is possible to write the results in a text file
(Menu 'File' - 'Save results as text file').
Created with the Personal Edition of HelpNDoc: Produce online help for Qt applications
Copyright © <Dates> by <Authors>. All Rights Reserved.
Created with the Personal Edition of HelpNDoc: Easy CHM and documentation editor

Results database

7 / 11
 NetIO-GUI_En

Results database
Getting Started ›› How-To ››

NetIO GUI stores every successful measurement in a database file 'NetIO-GUI.sqlite' in the application
directory. The results can be clearly displayed, sorted and filtered via the menu item 'File' - 'Results
database':

Results database

By default, only the measurements made to the destination host with the IP address in the main window
are displayed. With the filter selection boxes and buttons other filters can be activated or all existing
measurement results can be displayed. Sorting is possible by clicking on the respective column header.

The database view supports the export of the current data selection either as a Microsoft Excel file or as a
CSV file (Character Separated Values). The respective format is determined by the selected file type of
the file save dialog.

NOTE: Microsoft Excel must be installed to export the data as a Microsoft Excel document.
Created with the Personal Edition of HelpNDoc: Create cross-platform Qt Help files
Copyright © <Dates> by <Authors>. All Rights Reserved.
Created with the Personal Edition of HelpNDoc: Free PDF documentation generator

Extras

Extras
Getting Started ›› How-To ››

All menu items in the 'Extras' section require increased privileges as administrator. If NetIO GUI detects
that it has not started with sufficient privileges, it restarts with elevated privileges. A dialog of the
Windows User Account Control appears, which has to be confirmed. Afterwards the desired function must
be called again.

Firewall settings

8 / 11
 NetIO-GUI_En

With the 'Extras' - 'Firewall Settings' function, the setting of the Windows Firewall can be adjusted for the
operation of the 'netio' server. We recommend an exception rule for incoming ICMPv4 packets (ping) and
for the 'netio' server itself. The latter rule triggers the 'netio.exe' file in the application directory.

NetIO server service

With NetIO-GUI it is possible to install the program 'netio.exe' as a Windows service and thus to run
permanently (even if the user is not logged in). Via the menu item 'Netio server service' the service can be
installed, configured, started, stopped and also uninstalled again. The netio service is installed with the
settings enabled in the main window (affects only the port).

Important instructions:
1. The program 'netio' is not designed as a Windows service. We use a trick ('winserv.exe') to install 'netio'
as a windows service. About the reliability of this service at runtime, the author can make no statement.
In the event of misconduct, stop the service if necessary and then restart it again.
2. When the netio Server service is installed and started, uninstalling NetIO GUI fails because two files are
locked by the operating system. Please first stop the service via the 'Tools' menu, uninstall it and then
uninstall the NetIO GUI.
Created with the Personal Edition of HelpNDoc: Free EBook and documentation generator
Copyright © <Dates> by <Authors>. All Rights Reserved.
Created with the Personal Edition of HelpNDoc: Produce online help for Qt applications

Settings

Settings
Getting Started ›› How-To ››

Under the menu item 'File' - 'Settings' some presettings can be made. The settings are stored in the file
'NetIO-GUI.INI' in the application directory (see 'Settings via INI file'). Closing the dialog box with the
'Ok' button saves and activates the new settings.
Created with the Personal Edition of HelpNDoc: Create help files for the Qt Help Framework
Copyright © <Dates> by <Authors>. All Rights Reserved.
Created with the Personal Edition of HelpNDoc: Create cross-platform Qt Help files

Extended

Extended
Getting Started ››

Created with the Personal Edition of HelpNDoc: Free PDF documentation generator
Copyright © <Dates> by <Authors>. All Rights Reserved.
Created with the Personal Edition of HelpNDoc: Easy EPub and documentation editor

Settings via INI file

Settings via INI file

Getting Started ›› Extended ››

9 / 11
 NetIO-GUI_En

NetIO-GUI creates an INI file with some default settings when first launched in the application directory.
This file can be customized with a text editor according to your own needs:

Values in section [Settings]:

· lastip: last used IP address in client mode, is automatically entered at startup
· showhint: once displays the 'About NetIO GUI' dialog
· databasefile: refers to the database file to use. The file can also reside on a shared network drive and be
used by different instances of NetIO GUI.
· autostartserver: 'true' or 'false'. If true NetIO-GUI starts directly in activated server mode
· protocol: by default, the network protocol to be used for the measurement
· language: currently 'de-DE' or 'en-US'

Example file 'NetIO-GUI.ini'

[Settings]
lastip=192.168.0.1
databasefile=D:\netio-gui\NetIO-GUI.sqlite
autostartserver=false
serverport=18767
protocol=tcp
showhint=False
language=de-DE

Created with the Personal Edition of HelpNDoc: Easy CHM and documentation editor
Copyright © <Dates> by <Authors>. All Rights Reserved.
Created with the Personal Edition of HelpNDoc: iPhone web sites made easy

Commandline parameter

Commandline parameter
Getting Started ›› Extended ››

NetIO GUI currently supports four command line parameters for specifying various options. The
parameters can be freely combined with each other. All values should be in quotation marks.

NetIO-GUI -d="Pfad und Dateiname der Datenbankdatei" -i="Pfad zur INI-Datei" -z="Ziel IP-Adresse" -
a

Specifying the database file or destination IP address via command line overwrites the setting in the INI
file.

The parameter -a forces the non-portable mode: files are stored in '% APPDATA% \ NetIO-GUI',
regardless of the write permissions in the application directory.
Created with the Personal Edition of HelpNDoc: Produce electronic books easily

10 / 11
 NetIO-GUI_En

Copyright © <Dates> by <Authors>. All Rights Reserved.

Created with the Personal Edition of HelpNDoc: Easily create Qt Help files

11 / 11