Nemo Server 6.1.0 User Guide-June21
Nemo Server 6.1.0 User Guide-June21
User Guide
Notices
U.S.Government Rights Warranty
Copyright Notice
The Software is “commercial computer THE MATERIAL CONTAINED IN THIS
© Keysight Technologies, Inc. 2021 software,” as defined by Federal DOCUMENT IS PROVIDED “AS IS,”
No part of this manual may be Acquisition Regulation (“FAR”) 2.101. AND IS SUBJECT TO BEING
reproduced in any form or by any means Pursuant to FAR 12.212 and 27.405-3 CHANGED, WITHOUT NOTICE, IN
(including electronic storage and retrieval and Department of Defense FAR FUTURE EDITIONS. FURTHER, TO
or translation into a foreign language) Supplement (“DFARS”) 227.7202, the THE MAXIMUM EXTENT PERMITTED
without prior agreement and written U.S. government acquires commercial BY APPLICABLE LAW, KEYSIGHT
consent from Keysight Technologies, as computer software under the same DISCLAIMS ALL WARRANTIES,
governed by United States and terms by which the software is EITHER EXPRESS OR IMPLIED WITH
international copyright laws. customarily provided to the public. REGARD TO THIS MANUAL AND ANY
Accordingly, Keysight provides the INFORMATION CONTAINED HEREIN,
Manual Part Number Software to U.S. government INCLUDING BUT NOT LIMITED TO THE
customers under its standard IMPLIED WARRANTIES OF
NTE00000A-90000 commercial license, which is embodied MERCHANTABILITY AND FITNESS
in its End User License Agreement FOR A PARTICULAR PURPOSE.
Edition (EULA), a copy of which can be found KEYSIGHT SHALL NOT BE LIABLE
Edition 4.2, June 2021 at FOR ERRORS OR FOR INCIDENTAL
Documents Software Version 6.1.0 http://www.keysight.com/find/s OR CONSEQUENTIAL DAMAGES IN
weula. The license set forth in the CONNECTION WITH THE
Published by: EULA represents the exclusive FURNISHING, USE, OR
Keysight Technologies Finland, Ltd. authority by which the U.S. PERFORMANCE OF THIS DOCUMENT
Elektroniikkatie 10 government may use, modify, OR ANY INFORMATION CONTAINED
90590 Oulu, Finland distribute, or disclose the Software. HEREIN. SHOULD KEYSIGHT AND
The EULA and the license set forth THE USER HAVE A SEPARATE
therein, does not require or permit, WRITTEN AGREEMENT WITH
Technology Licenses WARRANTY TERMS COVERING THE
among other things, that Keysight: (1)
Furnish technical information related to MATERIAL IN THIS DOCUMENT THAT
The hardware and/or software described
commercial computer software or CONFLICT WITH THESE TERMS, THE
in this document are furnished under a
commercial computer software WARRANTY TERMS IN THE
license and may be used or copied only
documentation that is not customarily SEPARATE AGREEMENT WILL
in accordance with the terms of such
provided to the public; or (2) CONTROL.
license.
Relinquish to, or otherwise provide,
the government rights in excess of
Declaration of Conformity these rights customarily provided to
Declarations of Conformity for this product the public to use, modify, reproduce,
and for other Keysight products may be release, perform, display, or disclose A CAUTION notice denotes a hazard. It
downloaded from the Web. Go to commercial computer software or calls attention to an operating procedure,
http://www.keysight.com/go/conformity commercial computer software practice, or the like that, if not correctly
and click on “Declarations of Conformity.” documentation. No additional performed or adhered to, could result in
You can then search by product number to government requirements beyond damage to the product or loss of
find the latest Declaration of Conformity. those set forth in the EULA shall apply, important data. Do not proceed beyond a
except to the extent that those terms, CAUTION notice until the indicated
rights, or licenses are explicitly conditions are fully understood and met.
required from all providers of
commercial computer software
pursuant to the FAR and the DFARS
and are set forth specifically in writing
elsewhere in the EULA. Keysight shall A WARNING notice denotes a hazard. It
be under no obligation to update, calls attention to an operating procedure,
revise or otherwise modify the practice, or the like that, if not correctly
Software. With respect to any performed or adhered to, could result in
technical data as defined by FAR personal injury or death. Do not proceed
2.101, beyond a WARNING notice until the
pursuant to FAR 12.211 and 27.404.2 indicated conditions are fully understood
and DFARS 227.7102, the U.S. and met.
government acquires no greater than
Limited Rights as defined in FAR
27.401 or DFAR 227.7103-5 (c), as
applicable in any technical data.
2
Nemo Server User Guide
3
Nemo Server User Guide
Contents
4
Nemo Server User Guide
1.1 Notes
When using the Nemo Server devices for reporting use, the battery operation time is reduced
from normal use. The best operation times will be achieved when the batteries are regularly
charged and discharged as instructed in the device user manual. See also other instructions and
hints from the device user manual regarding the battery use.
Note that in some countries it is illegal to drive a car and operate a device at the
same time.the top of the device screen and check that the mobile data setting is
activated.
Do not operate Nemo Server without reading the User Manual, including its
warnings, for the devices used by Nemo Server.
Always stop using Nemo Server and switch off the Nemo Server device(s) when it is
forbidden to use radio equipment or when it may cause interference or danger.
Do not use the Nemo Server device(s) in a hospital. It may interfere with nearby
electronic devices.
Never use Nemo Server in an aircraft. The use of mobiles in an aircraft may be
dangerous.
Observe restrictions on the use of radio equipment in gas stations, fuel depots,
chemical plants, or sites where blasting operations are in progress.
5
Nemo Server User Guide
2 Introduction
Starting from the 6th generation Nemo Server, the server does not support any kind of physical
PSTN/ISDN adapters and cannot do voice quality testing but data testing only. Since almost all
deployments are virtual nowadays, the Nemo Server platform has evolved from hardware-only
platform towards Cloud- and virtual-based deployments.
This chapter describes the procedures for physical and virtual Nemo Server on-site installation.
The server must be at the final installation location at the customer’s premises.
This manual is for Server v6.10 only and for Dell models T140 and R240.
Note that the physical, Keysight-delivered Nemo Server is properly firewalled using
iptables. For user’s own virtual/physical server installations, the firewall must be set
up and managed by the end-user.
In any case, Keysight is not responsible for the safe operation of the test protocols
and server platforms, and necessary security hardening is left for the end-user.
6
Nemo Server User Guide
Never shut down the server by pressing the power button for a long time. Instead,
shut down the server by using the command: # sudo shutdown -h now
Before connecting the power cable, make sure that the voltage selector of server
power is set according to local mains voltage. By default it is set to 230VAC. Do not
connect the server to the Internet at this time – only connect the LAN interface cable.
The following prompt symbol refers to root console commands from now on:
# passwd
Changing password for user root.
New UNIX password:
Retype new UNIX password:
passwd: all authentication tokens updated successfully.
7
Nemo Server User Guide
The password should have upper and lower case characters, numbers, and special
characters
The following is an example of a valid password (do not use this, as it is the default password
for server 2.01 and earlier versions):
6yV-1pSc
Write the password down and keep it in a safe and secure place! There is no easy
way to retrieve it if it gets lost. In addition, after the root password has been changed,
the server’s superuser account can only be accessed locally with the password.
Please note that Keysight cannot guarantee absolute safety when the server is
connected to the Internet since the server has active, public services such as SSH,
FTP, WWW and Iperf that can be or become vulnerable. However, the server has a
properly configured firewall that should prevent all common intrusions.
In Debian Linux network interfaces are named as shown in table below. The following interfaces
are installed by default: lo for localhost, and eno1 and eno2 for integrated 1 Gbit ports.
The datatest option adds interfaces like enp1s0f0np0 or enp1s0f0 depending on the interface
type.
Interface Description
lo Loop-back interface for local IP traffic
eno1 first integrated port, 1000BASE-T
eno2 second integrated port,1000BASE-T
enp1s0f0np0 first SFP+ interface adapter, 10GBASE-SR/LR
enp1s0f1np1 second SFP+ interface adapter, 10GBASE-SR/LR
enp1s0f0 first Ethernet interface port, 1000BASE-T
enp1s0f1 second Ethernet interface port, 1000BASE-T
enp1s0f2 third Ethernet interface port, 1000BASE-T
enp1s0f3 fourth Ethernet interface port, 1000BASE-T
Following command shows the current network configuration, and can be used for checking the
server’s IP addresses if they are assigned using DHCP:
# ip a
# ip a
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN
group default qlen 1000
8
Nemo Server User Guide
# ip a
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN
group default qlen 1000
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 scope host lo
valid_lft forever preferred_lft forever
inet6 ::1/128 scope host
valid_lft forever preferred_lft forever
2: eno1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP
group default qlen 1000
link/ether 10:98:36:a0:71:0d brd ff:ff:ff:ff:ff:ff
inet 1.2.3.4/24 brd 1.2.3.0 scope global eno1
valid_lft forever preferred_lft forever
3: eno2: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN group
default qlen 1000
link/ether 10:98:36:a0:71:0e brd ff:ff:ff:ff:ff:ff
4: enp3s0f0: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN group
default qlen 1000
link/ether b4:96:91:59:18:a8 brd ff:ff:ff:ff:ff:ff
5: enp3s0f1: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN group
default qlen 1000
link/ether b4:96:91:59:18:a9 brd ff:ff:ff:ff:ff:ff
6: enp3s0f2: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN group
default qlen 1000
link/ether b4:96:91:59:18:aa brd ff:ff:ff:ff:ff:ff
7: enp3s0f3: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN group
default qlen 1000
link/ether b4:96:91:59:18:ab brd ff:ff:ff:ff:ff:ff
9
Nemo Server User Guide
Note also that if Docker is installed, there is an additional interface named as docker0 with
several virtual devices.
# nano /etc/network/interfaces
The file opens for editing, and by default all interfaces except eno1 are configured for DHCP:
source /etc/network/interfaces.d/*
allow-hotplug eno2
iface eno2 inet dhcp
allow-hotplug enp1s0f0np0
iface enp1s0f0np0 inet dhcp
allow-hotplug enp1s0f1np1
iface enp1s0f1np1 inet dhcp
Set up the static addresses where needed by changing the highlighted dhcp to static and
entering address and gateway (and dns name server if needed) like with section eno1, indented
using Tab.
If interface settings were changed, it is required to restart the interface using the following
commands: (this example is for interface enp1s0f0np0):
Note that it is recommended to use a static IP address on the WAN side so that there
is no need to change the IP address into measurement unit configurations in case of
possible later changes to it.
10
Nemo Server User Guide
Recommendation is that the Server should use UTC time whenever Cloud-related
functions are used as UTC is also the time reference for Nemo Cloud backend.
# dpkg-reconfigure tzdata
Then select continent and country. For example, to set UTC timezone, first select None of the
above, then UTC and press Enter.
11
Nemo Server User Guide
Setup scripts install all required operating system service and software components needed for
running the datatest container endpoints on the host. It should be run as root or using sudo.
Supported operating systems are Debian 10 (amd64) and Ubuntu 20.04 LTS (amd64).
Download the install script and run it. This can be done for example at /tmp/ folder.
# sudo ./nemoserver-install.pl
The installation outputs a lot of text and may take long depending on what was already installed.
# less /var/log/dataserver_install.log
The configuration script is used for controlling and updating the datatest endpoints.
# sudo /usr/nemo/nemoserver-config
12
Nemo Server User Guide
Before enabling the actual services, select 2 from main menu to update everything.
13
Nemo Server User Guide
# /usr/nemo/nemoserver-config.sh
When this is done for the first time and each time after updating the Docker image, the vsftpd is
patched to support Nemo diskless FTP. Note that there will be lots of output during the building
but it is normal. The updating and building may take a long time. After it finishes, return to the
main menu by pressing 0.
Note that the starting and stopping of this container may take long time.
14
Nemo Server User Guide
5 Administration
To create a public key, pair login to root console and write the following commands.
# cd /root
# ssh-keygen -b 2048 -t rsa
# cat .ssh/id_rsa.pub >> .ssh/authorized_keys
Copy the private key .ssh/id_rsa to your workstation by using USB media.
Go to folder /root/.ssh
# cd /root/.ssh
# cp id_rsa /media/cdrom/
# umount /media/cdrom
On Windows, run application puttygen.exe - it can be found usually from folder C:\Program Files
(x86)\PuTTY
Press Load and select All Files (*.*) from a dropdown list next to File Name field.
Browse the private key file named as id_rsa
Press OK and the key details should appear.
Now press Save private key and answer Yes
Set name like nemov5_private and press Save
15
Nemo Server User Guide
6 Data Testing
NemoServer v6 datatest endpoints are implemented as Docker containers that are isolated
environments inside the host operating system, so that each test service protocol is a single
Docker container.
There are five running containers for http, ftp, iperf2-nemo, iperf-2.0.14 (latest) and Twamp
protocols.
Test endpoints can be controlled by using nemoserver-config script (see chapter 4.2).
Although the server is capable for 5x1 Gbit/s continuous transfer speed, this has
been measured with Iperf2 protocol that generates the traffic. In real world when for
example FTP is used for speed tests, the server has to read/write files to hard-disk
that may become a bottleneck, and if it happens that will effectively lower the max
obtainable speed. The server should handle approximately 400 MB transfers even if
all transfers are reading/writing different files.
To max out the available bandwidth, there are special methods available for both FTP and
HTTP(S) that effectively eliminate disk access, see chapters below. Other protocols, iperf2 and
twamp, are diskless by default.
6.1 WWW
All files can be accessed via HTTP and via any public IP address of the server.
Standardized test web pages Copernicus, Kepler and Kepler for smartphones are behind URLs:
http://ip.add.re.ss/copernicus
http://ip.add.re.ss/kepler
http://ip.add.re.ss/keplersm
16
Nemo Server User Guide
For diskless transfer, use up.php and gen.php as they save server’s disk I/O resources.
up.php - Receives a file with POST but does not save it. The response message 200
RESPONSE contains the size of the received file.
gen.php?size=n - Generates n kilobytes random data and returns it as file random.bin, for
example: http://192.168.0.1/gen.php?size=1000
6.2 FTP
Only passive FTP mode and diskless transfer method are supported.
If no valid DNS is configured into network settings, the FTP login may become slow.
This is due to reverse DNS lookups that vsftpd does for connecting client IP
addresses. Unfortunately, the vsftpd does not support the disabling of this feature
(reverse_lookup_enable=NO) so the only way to shorten the time is to configure
DNS to network settings.
It can be done as described in chapter 3.5. If no proper DNS servers are available
locally, use Google’s free server at 8.8.8.8.
Diskless uploading
The service accepts file creation only under /pub folder. File will be created when transfer starts
but all received packets are discarded instead of file writing. After the transfer, the created empty
file is removed and success-result sent for the client. Disk is accessed only when file is created
and removed. Multiple sessions can upload to the same target file simultaneously (that is not
possible with standard account).
Diskless downloading
When file is downloaded, the content comes from static 64k memory buffer filled with random
content.
The file request should start with integer/decimal number. The rest of the request filename is
composed of optional size factor and mandatory type modifier. The minimum and maximum
accepted sizes are 1 byte and 5000000000 bytes (5 gigabytes).
Format: n[.mmmmmm][x][t].bin
n[.mmmmm] = integer number, optionally decimal number, max 5 decimals
x is optional size factor (default 1 if omitted): k = 1000, m | M = 1000000, g | G = 1000000000
t Optional type modifier (default is byte if omitted): b | B = bytes and bit = bits = 1/8 bytes
The server sends requested amount in metric bytes as transfer speeds are always presented
within metric system, i.e. 1kb.bin means 1000 bytes and 8kbit.bin means also 1000 bytes. Bit
17
Nemo Server User Guide
amounts are rounded down to nearest byte. The requested filename will be created and written
locally but it depends of course of the used FTP client what it does with the downloaded data.
Examples:
1.bin -> 1 byte 1kb.bin -> 1000 bytes
1mb.bin -> 1000000 bytes 1gb.bin -> 1000000000 bytes
8bit.bin -> 1 byte 1kbit.bin -> 125 bytes
1mbit.bin -> 125000 bytes 1gbit.bin -> 125000000 bytes
1.55kb.bin -> 1550 bytes 1.55kbit.bin -> 193 bytes
6.3 Iperf2-nemo
The server has two Iperf2-nemo services running at port 5001, one in UDP and other in TCP-
mode. Services are available via all connected network interfaces. Iperf2-nemo service is also a
diskless transfer method and very useful, for example, on UDP maximum throughput testing.
iperf2-nemo is not fully compatible with vanilla iperf2 protocol and can be used only
with Nemo products.
When configuring multi-data Iperf-tests with Nemo Outdoor, USE THE SAME IP
ADDRESS FOR EACH TERMINAL. This differs from normal data testing (www, FTP,
etc.) because those have to be configured to use different IP addresses.
6.4 Iperf2-latest
The server has two Iperf2-latest (currently 2.0.14) services running at port 5002, one in UDP and
other in TCP-mode. Services are available via all connected network interfaces. Iperf2-latest
service is also a diskless transfer method and very useful, for example, on UDP maximum
throughput testing.
iperf2-latest requires using iperf2-latest as test protocol as the field test unit side.
6.5 Twamp
The server has Twamp protocol service running at port 862/tcp (control port), and port range
5010-5099/udp (datatest ports) is reserved for connecting clients.
Field test unit side should not select the datatest port, but server assigns and sends
it.
18
Nemo Server User Guide
7 Appendices
The Server does not apply any Nemo SW updates automatically to minimize disruptions for data
testing. To keep the system up to date, run the following commands once per week when Server
is not used for testing.
# apt update
# apt upgrade
All measurements have to be stopped before updating is started as the update may
terminate several services during the updating and therefore open measurements
can be interrupted.
# cd /usr/nemo
# ./nemoserver-config update
This is required only if the server’s hard-disk fails for recovering the system, not for
casual updating. The server image updating method erases all files that are currently
on your server’s hard-disk! Backup all necessary data before continuing with the
update.
1. Shut down the server, open the chassis and remove Ethernet card(s).
2. Start the server and press F11 as soon as the BIOS POST screen appears. Press Ctrl-
Alt-Del to reset if you were not fast enough and Linux already started.
19
Nemo Server User Guide
4. Browse and select the USB from hard disks for boot device, after which Debian Isolinux
should appear on the screen. After a while, there will be a question whether to continue
with hard-disk overwriting. Answer y to continue. Image writing will take max 5 minutes.
5. After the writing is finished, take the USB off, and press the power button for a few
seconds to power off the server, and then start it again.
If BIOS is reset, the system has to be changed to boot from BIOS instead of UEFI.
Also go to Integrated Devices and set Memory Mapped I/O above 4 GB to Disabled.
Sometimes the HW problem occurs only rarely and therefore the diagnostics may not
be able to catch it. This may be the situation if server can be booted up and used for
some time before problem occurs.
MpMemory and Express mode for quicker memory+cpu tests (5-10 minutes)
The last item of system-wide tests will fail in absence of floppy disk but it is normal
since the system does not have floppy disk interface.
INTERNET
20
Nemo Server User Guide
INTERNET
172.16.0.0 -172.31.255.255
192.168.0.0 - 192.168.255.255
No route from the Internet!
Internal use only!
Public address
Private address
62.142.77.198
192.168.200.2
INTERNET
21
Nemo Server User Guide
With virtual interfaces we can map multiple public address to one private. (Nemoserver)
192.168.200.3
22
Nemo Server User Guide
INTERNET
Static NAT
7.4.7 Debugging
What is my ip? http://whatismyip.com
iptstate A top-like display of IP Tables state table entries (not installed by default)
23
Nemo Server User Guide
7.4.8 Static NAT (port forwarding) example with Buffalo access point
24
Nemo Server User Guide
8 Technical Support
If you have questions on or beyond this documentation about Nemo tools, please contact our technical
support service through Nemo Support Portal at http://nemo.support.keysight.com, call us or send us an
email at [email protected]. Note that for full support you need to have the Maintenance
Agreement.
Please go to http://nemo.support.keysight.com to access the portal and click Request access to obtain a
password to the system.
Nemo Support Portal is the preferred channel for technical support requests, but you can also send us an
email to [email protected]. When emailing, please let us know the number of your Software
Maintenance and Support Agreement.
Should the Declaration of Conformity be required, please contact a Keysight Sales Representative, or the
closest Keysight Sales Office. Alternately, contact Keysight at: www.keysight.com.
25
This information is subject to change without notice.
© Keysight Technologies Finland, Ltd. 2019-2021
Published in Finland, March 15, 2021
NTE00000A-90000
www.keysight.com