NETCO User Guide
SATEL NETCO SYSTEM
USER GUIDE
Guide v.0.7.3
SATEL NETCO –
User Guide, Version 0.7.3
IMPORTANT NOTICE
All rights to this manual are owned solely by Satel Oy (referred to in this user guide as Satel). All
rights reserved. The copying of this manual (without the written permission from the owner) by
printing, copying, recording or by any other means, or the full or partial translation of the
manual to any other language, including all programming languages, using any electrical,
mechanical, magnetic, optical, manual or other methods or devices is forbidden.
Satel reserves the right to change the technical specifications or functions of its products, or to
discontinue the manufacture of any of its products or to discontinue the support of any of its
products, without any written announcement and urges its customers to ensure, that the
information at their disposal is valid.
Satel software and programs are delivered ”as is”. The manufacturer does not grant any kind of
warranty including guarantees on suitability and applicability to a certain application. Under no
circumstances is the manufacturer or the developer of a program responsible for any possible
damages caused by the use of a program. The names of the programs as well as all copyrights
relating to the programs are the sole property of Satel. Any transfer, licensing to a third party,
leasing, renting, transportation, copying, editing, translating, modifying into another
programming language or reverse engineering for any intent is forbidden without the written
consent of SATEL.
SATEL PRODUCTS HAVE NOT BEEN DESIGNED, INTENDED NOR INSPECTED TO BE USED
IN ANY LIFE SUPPORT RELATED DEVICE OR SYSTEM RELATED FUNCTION NOR AS A PART
OF ANY OTHER CRITICAL SYSTEM AND ARE GRANTED NO FUNCTIONAL WARRANTY IF
THEY ARE USED IN ANY OF THE APPLICATIONS MENTIONED.
Salo, FINLAND 2016
Copyright: 2013-2016 Satel Oy
No part of this document may be reproduced, transmitted or stored in a retrieval system in any form or by any means
without the prior written permission of Satel Oy. This document is provided in confidence and must not be distributed to
third parties without the express permission of Satel Oy.
1
SATEL NETCO –
User Guide, Version 0.7.3
RESTRICTIONS ON USE
SATEL NETCO System is licensed software. (c)2013-2016 www.satel.com, Satel Oy, Finland.
EXPORT RESTRICTIONS
Licensee agrees that it shall not directly nor indirectly export the Licensed program in
contravention of any export law.
FREE OPEN SOURCE SOFTWARE INCLUDED
This product's release package redistributes separate Free and Open source software
components. Users must agree to install those software components and agree to the terms of
that software. If a user does not agree to the terms of that software they must not install them.
The entire rights to these software components belong to their respective copyright holders.
The open source software components distributed alongside with the Satel NETCO System
include:
MongoDB – http://www.mongodb.org
NodeJs - http://www.nodejs.org/
NO WARRANTY
1. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR
THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
PROVIDE THE PROGRAM 'AS IS' WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH
YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
NECESSARY SERVICING, REPAIR OR CORRECTION.
2. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES
ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT
LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES
SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE
WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
2
SATEL NETCO –
User Guide, Version 0.7.3
TABLE OF CONTENTS
IMPORTANT NOTICE .................................................................................................... 1
RESTRICTIONS ON USE ................................................................................................ 2
TABLE OF CONTENTS ................................................................................................... 3
1
INTRODUCTION ............................................................................................. 6
1.1
Terms and abbreviations...................................................................................... 6
1.2
Description of the product .................................................................................... 6
2
INSTALLING AND UPDATING ........................................................................... 7
2.1
Installing the software to the host .......................................................................... 7
2.2
Updating the installed software ............................................................................. 7
3
USER INTERFACE ............................................................................................. 8
3.1
Login page ........................................................................................................ 8
3.2
Welcome page................................................................................................... 8
3.3
Network page .................................................................................................... 9
3.3.1
3.3.1.1
3.3.1.2
3.3.1.3
3.3.1.4
3.3.1.5
3.3.1.6
3.3.1.7
3.3.1.8
3.3.1.9
3.3.1.10
3.3.1.11
3.3.1.12
3.3.2
3.3.3
Main menu functions.................................................................................................. 11
Tools – Select ............................................................................................... 11
Tools – move ................................................................................................ 11
Network and Sync – Create new ..................................................................... 12
Network and Sync – Start or Stop editing ......................................................... 12
Network and Sync – Delete network ................................................................ 12
Network and Sync – Synchronize selected ........................................................ 12
Nodes and Links – Add node ......................................................................... 12
Nodes and Links – Add link ............................................................................ 13
Nodes and Links – Add linked node ................................................................ 13
Admin Tools – Update Netco ......................................................................... 13
Admin Tools – Update License ....................................................................... 13
About .......................................................................................................... 14
Map view controls...................................................................................................... 14
Assist toolbar............................................................................................................. 14
3.3.3.1 Test run ........................................................................................................ 14
3.3.3.2 Run Assists.................................................................................................... 14
3.3.3.3 Stop............................................................................................................. 14
3
SATEL NETCO –
User Guide, Version 0.7.3
3.3.3.4 Selection ...................................................................................................... 14
3.3.4
Property tree editor .................................................................................................... 14
4
NETWORK MANAGEMENT ............................................................................. 17
3.3.4.1 Editing a value .............................................................................................. 15
3.3.4.2 Locked values ............................................................................................... 15
3.3.4.3 Multiple node editing .................................................................................... 16
4.1
Quick Overview ............................................................................................... 17
4.2
List of features .................................................................................................. 17
4.3
Workflow......................................................................................................... 18
4.4
Managing settings manually ............................................................................... 18
4.5
Automatic network design using Assists ................................................................ 19
4.2.1
4.2.2
4.2.3
4.2.4
4.2.5
4.2.6
4.2.7
4.2.8
4.5.1
4.5.2
4.5.3
4.5.4
4.5.5
4.5.6
4.5.6.1
4.5.6.2
4.5.6.3
4.5.6.4
4.5.6.5
5
User accounts ........................................................................................................... 17
Database .................................................................................................................. 17
Web-browser interface ............................................................................................... 17
Multiple networks....................................................................................................... 17
Map-based editing of nodes and links .......................................................................... 18
List of nodes .............................................................................................................. 18
Network Design Assists ............................................................................................... 18
Sending settings to devices.......................................................................................... 18
Accessing Assist settings.............................................................................................. 19
General Assist settings ................................................................................................ 19
RMAC assist .............................................................................................................. 19
PR assist ................................................................................................................... 19
Radio IP assist ........................................................................................................... 20
LAN assist ................................................................................................................. 20
LAN Mode: Manual ...................................................................................... 21
LAN Mode: Routed ....................................................................................... 21
LAN Mode: Proxy ARP ................................................................................... 21
LAN Mode: Bridge Open ............................................................................... 21
LAN Mode: Bridge Restricted .......................................................................... 22
SYNCHRONIZATION ..................................................................................... 23
5.1
Open synchronization dialog.............................................................................. 23
5.2
Connecting to the device ................................................................................... 24
5.3
Device identification .......................................................................................... 27
5.4
Synchronization options ..................................................................................... 28
5.5
Synchronization procedure ................................................................................. 29
5.2.1
5.2.2
Connection string ...................................................................................................... 25
Testing the media ...................................................................................................... 26
4
SATEL NETCO –
User Guide, Version 0.7.3
5.6
Synchronization results ...................................................................................... 29
6
APPENDIX ..................................................................................................... 31
7
VERSION HISTORY ........................................................................................ 32
5
SATEL NETCO –
User Guide, Version 0.7.3
1 INTRODUCTION
Satel Oy is a Finnish electronics and Telecommunications Company specializing in the design
and manufacture of wireless data communication products. Satel designs, manufactures and
sells radio modems intended for use in applications ranging from data transfer to alarm relay
systems. End users of Satel products include both public organizations and private individuals.
Satel Oy is the leading European manufacturer of radio modems. Satel radio modems have
been certified in most European countries and also in many non-European countries.
1.1 Terms and abbreviations
Abbreviation
Description
1.2 Description of the product
Satel NETCO is a network design and management application. It can be installed to a
Windows PC. The user interface of the product is web-browser-based.
NETCO supports designing of Internet Protocol (IP) based networks consisting of radio modems
of the SATELLAR product family, as well as generic IP network components such as switches and
routers.
NETCO allows manual control of all settings of the radio modems, and also includes features to
automatically generate settings such as protocol addresses and routing tables to facilitate the
rapid deployment of devices. NETCO is also used to directly transfer the managed settings to
the actual devices (via Synchronization), with no need to manually enter settings using the
device’s own user interface.
6
SATEL NETCO –
User Guide, Version 0.7.3
2 INSTALLING AND UPDATING
2.1 Installing the software to the host
Satel NETCO system is delivered in an easy setup executable, which guides you thru the setup
process. You only need to run the setup once when initially installing the NETCO for the first
time.
You need a valid NETCO license key and appropriate user group rights to start installation.
Although installation is possible without Internet connection, Satel strongly recommends to install
the system with Internet-connection for the best experience. That way it is also possible to
immediately check for new software updates.
2.2 Updating the installed software
NETCO system software will be updated regularly as new NETCO or Satel Product features
arise. Full support for newest product features requires that you have the NETCO updates
installed from the same period of time.
You need a valid NETCO license key and appropriate user group rights to check for updates
and applying them.
The availability of NETCO Updates depend on the status of your license and if there are new
release packages available. If your license is expired, then you cannot download updates. In
that case contact Satel and ask for NETCO license renewal.
Satel recommends to have Internet-connectivity during checking updates for the easiest
experience, in which case the checking, downloading and running update can happen
automatically. If you are using NETCO in a high security environment without Internet
connection, you can also use the manual update method.
To start checking for updates, go to the Admin tools –section in the main menu and select
“Update NETCO”. If update is available, you can still choose whether to apply or cancel that
update.
7
SATEL NETCO –
User Guide, Version 0.7.3
3 User Interface
The user interface can be accessed using a web browser. Clicking on the installed “Start
NETCO” shortcut in the Windows Start menu, “Satel NETCO” folder will open the user interface
using the default browser.
3.1 Login page
The login page is used to enter the username and password credentials.
Image 1: Login page
The default user name is “admin” and the password is “admin”. Alternatively “user1” and
“pass1” also work. (User management, i.e. adding more user accounts with rights, will appear
in future versions of NETCO).
Select “Sign in” to continue.
3.2 Welcome page
The welcome page is only shown on first startup of NETCO (or after rebooting the PC). It can
later be accessed from the “About->Welcome page” menu.
The welcome page contains generic information about NETCO. Select “Open NETCO” to
continue to the Network page.
8
SATEL NETCO –
User Guide, Version 0.7.3
Image 2: Welcome page
3.3 Network page
The Network-page is currently the main page where network design and synchronization can be
performed. When no Networks have yet been created the main page will look like Image 3. At
this point you may create a new network by selecting “Create new” from the network tools area
to proceed.
9
SATEL NETCO –
User Guide, Version 0.7.3
Image 3: Network page with no networks
After at least one network has been created, the network page will appear as Image 4.
10
SATEL NETCO –
User Guide, Version 0.7.3
Image 4: Network page with one or more networks
3.3.1 Main menu functions
3.3.1.1 Tools – Select
Select (click) this icon to enable selection mode. Using the arrow cursor you can select map
objects (nodes or links). You can also move nodes if the network is in edit mode. You can
choose which types of objects to select from the drop-down list. This is especially useful if
selecting a group of objects and you wish to only select links OR nodes, not both.
3.3.1.2 Tools – move
Select this icon to activate the move tool. You may then drag the whole map easily to view
different areas of a map that is otherwise too big to fit the screen, for example.
11
SATEL NETCO –
User Guide, Version 0.7.3
3.3.1.3 Network and Sync – Create new
Select this icon to instantly create a new Network and switch the view to it.
3.3.1.4 Network and Sync – Start or Stop editing
These buttons are used to toggle the editing or viewing mode. In Viewing mode, no changes
can be made to the network, other than moving and zooming the map view. In editing mode all
settings can be changed and Assists can be run.
3.3.1.5 Network and Sync – Delete network
Select this icon to delete the currently visible network from the database. (Even in View mode).
All information about the network will be removed from the database. NETCO will ask you to
confirm the deletion.
3.3.1.6 Network and Sync – Synchronize selected
Select this icon to start the Synchronization process for all selected synchronizable nodes.
Currently only nodes representing SATEL products can be synchronized. The synchronization
process is explained in detail in chapter 5.
3.3.1.7 Nodes and Links – Add node
Select this icon to activate the Add node tool. Then you can click anywhere on the map to add
one node of the selected type at that location. The node type can be selected from the drop
down list below the “Add node” text.
Node types currently supported:
 SATELLAR XT 5RC – a SATEL radio modem consisting of a CU and a RU
 SATELLAR 2DS – a SATEL radio modem consisting of a CU and a RU
 SATELLAR 20DS – a SATEL radio modem consisting of a CU and a RU
 Generic IP host – a node representing any device that typically has a single IP address
and no routing capability, a polled device for example. (Not synchronizable by NETCO)
 Generic IP router – a node representing an IP router. (Not synchronizable by NETCO)
 Generic IP switch – a node representing an IP/Ethernet switch or hub. (Not
synchronizable by NETCO)
 Generic folder 1 – a node for storing any miscellaneous information you wish, not
representing any actual device.
12
SATEL NETCO –
User Guide, Version 0.7.3
3.3.1.8 Nodes and Links – Add link
Select this icon to activate the Add link tool. Then you can click two different existing nodes on
the map to create a link between them. The type of link to create depends on the selection that
has been made on the drop down menu below the “Add link” text. Note that if either node does
not support the type of link selected, the link cannot be created.
Link types currently supported:
 SATELLAR XT radio – used to link SATELLAR XT 5RC nodes via radio connection
 SATELLAR 2DS radio – used to link SATELLAR 2DS or 20DS nodes via radio connection
 Ethernet – used to link any devices nodes on the map (i.e. not including the “Generic
Folder 1” node)
There are additional restrictions on links:
 Any number of radio links are allowed between nodes, with the exception that there can
be only one link between any two nodes.
 Radio links can be drawn so that they form circular routes in the map, but the Assist
functions cannot yet generate meaningful PR routing tables from circular drawn routes.
 Only one Ethernet link is allowed per node, except for the Generic IP switch node. This
means that to connect more than one Ethernet/IP device to a SATELLAR, for example,
you must first connect the SATELLAR to a Generic IP Switch, then connect all the other IP
nodes to the switch.
3.3.1.9 Nodes and Links – Add linked node
Select this icon to activate the Add linked node tool. This is a more convenient way of adding
many nodes and links of the same type in succession. First click an existing node, the click the
target point for the new node. The new node and a link connecting the old and new nodes are
created. The types of new nodes and links are determined by the selections made under the Add
node and Add link tools’ drop down lists, respectively. All the same restrictions apply to this tool
as those in the Add node and Add link tools.
3.3.1.10
Admin Tools – Update Netco
Select this button to start the NETCO software update process. NETCO will automatically check
SATEL servers to see if a new version of NETCO is available and then ask you if you wish to
update or not. Any data in the database will not be removed. (Note that if you choose to
uninstall NETCO via the Windows Add or Remove programs function instead, data WILL be
removed!)
3.3.1.11
Admin Tools – Update License
13
SATEL NETCO –
User Guide, Version 0.7.3
Select this button to start the license update process. In some cases SATEL Customer Support
may instruct you to run this process if your license has expired or there has been another
problem with the license.
3.3.1.12
About
This toolbar page displays NETCO version information and license information. There is also a
link to the welcome page, see 3.2.
3.3.2 Map view controls
Use these controls to zoom and center the map view
3.3.3 Assist toolbar
This area is used to control running of the NETCO Assist functions.
3.3.3.1 Test run
Select this icon to run Assists and get Notification Log messages, but do not save any changes to
the database. This is useful to test your settings without any risk of losing the current setup.
3.3.3.2 Run Assists
Select this icon to run Assists and have any generated values stored into the database.
3.3.3.3 Stop
Select this icon to stop any Assist currently running, Any changes so far generated will NOT be
stored into the Database.
3.3.3.4 Selection
This edit box will display the currently selected node identifiers. Any Assist Run or Test Run will
only affect the selected nodes, all other nodes are considered to be fully locked by NETCO
Assist. NETCO Assist will however check all nodes for compatibility of values as normal, even if
they are unselected, and if any conflicts are found the process will be halted and error messages
will be shown in the Notification Log.
3.3.4 Property tree editor
Each node (including the network settings node or icon) contains properties which you can edit.
On device nodes, such as the various SATELLAR nodes, practically all properties correspond
directly to a setting of the actual radio modem. On Generic IP nodes the properties are more
like information and parameters to or from NETCO Assists, or for your own convenience.
The Network Settings node’s properties control the Assist function and also include connection
settings for synchronization of devices.
14
SATEL NETCO –
User Guide, Version 0.7.3
Image 5: Property editor
The property tree editor (Image 5: Property editor) is a hierarchical representation of the settings
in a node. You can open and close the branches of the tree by clicking on the small arrow icons
and .
SATELLAR nodes consists of two devices, the Radio Unit and the Central Unit. Opening a device
will show the setting categories, which are the same categories as appear in the SATELLAR Web
interface and User Manual. Opening the categories will reveal the settings. Some settings are
lists (or arrays) that contain multiple values. In this case the main setting will appear ampty and
the values will be revealed by clicking the arrow symbol.
3.3.4.1 Editing a value
Settings may be edited by clicking on the values in the Value column. NETCO will validate the
value while you type so you know when the value format is correct.
To add an item to an array-type setting, click the small plus icon . To remove a row from an
array, click the minus icon .
3.3.4.2 Locked values
Whenever a value is edited by you, NETCO will mark it as locked and it will not be changed by
NETCO Assists while it is locked. To unlock a value and allow NETCO Assists to modify it again,
uncheck the checkbox in the locking column (to the right from the value).
In addition, values edited by you, the user, will be marked by an orange rectangle . Values
generated by NETCO Assist will be marked with a blue rectangle .
15
SATEL NETCO –
User Guide, Version 0.7.3
3.3.4.3 Multiple node editing
You may also edit multiple nodes at the same time. Just select the nodes you wish to edit from
the map by drawing a selection rectangle using the selection tool. Then a combined view of the
selected nodes will appear on the property tree editor. If you then edit a value, all the selected
nodes will receive the same value. This is especially useful for editing radio settings.
16
SATEL NETCO –
User Guide, Version 0.7.3
4 NETWORK MANAGEMENT
The main purpose of NETCO is to make the management of your network’s settings as easy and
safe as possible. NETCO will help you by automatically assigning working settings to your
devices, or alternatively allow you to manage all settings manually. If you prefer, you can even
control some settings manually while others are validated and/or automatically assigned by
NETCO’s Assist functions.
4.1 Quick Overview
Using NETCO can be very simple. A basic workflow example:
 Start NETCO
 Create a new network
 Add SATELLAR modem icons and radio links between them
 Select the Run Assists button
and NETCO will generate routing settings
 Synchronize your devices
This will provide a working, if basic, network of SATELLAR devices using default radio settings.
In practice however, it will be necessary to input your radio frequency and other radio-related
settings as well as IP addresses. We will discuss the workflow in more detail below in chapter
4.5.
4.2 List of features
This is an overview of the major features of NETCO.
4.2.1 User accounts
Currently there is no support for user management. All users may log in using these credentials:
Username “admin” and password: “admin”. Alternatively, username “user1” and password
“pass1” may be used.
4.2.2 Database
NETCO is using a database to store its internal data, including all information about the
networks.
4.2.3 Web-browser interface
NETCO is controlled using a browser-based interface. The browser communicates with a server
component running (typically) in the same machine. The interface can be accessed using the
“Start NETCO” windows shortcut found in the Windows Start Menu, in the “Satel NETCO”
folder, which is created during installation.
Supported browsers are Mozilla Firefox and Google Chrome (recommended).
See 3 for details.
4.2.4 Multiple networks
Multiple networks can be created and managed. Networks can also be renamed and deleted.
The currently shown network can be selected from a drop-down menu at the top of the Web
Interface.
17
SATEL NETCO –
User Guide, Version 0.7.3
4.2.5 Map-based editing of nodes and links
An intuitive map view of the network is provided. Controls for zooming and panning the map
make it easy to manage even large networks.
4.2.6 List of nodes
Alternatively to the map view, a searchable list of network nodes can be used to quickly find the
correct device in large networks.
4.2.7 Network Design Assists
The Assist system significantly speeds network design and deployment by automating the work of
calculating IP addresses, routing tables etc. It works by taking the current network and additional
parameters and then generates routing settings for all the devices in the network. The results are
stored directly into the settings of the device nodes in the NETCO database. (A separate
synchronization step is required before the actual devices start working).
You can manually override any IP address of any device in the network and let NETCO generate
the rest automatically. In the event of IP or LAN address conflicts, NETCO will print out a
warning or error.
4.2.8 Sending settings to devices
Also called synchronization, this feature makes sure all NETCO-managed settings are correctly
stored into your devices without needing to use any management interfaces (such as web pages)
of the devices manually. Currently only SATELLAR devices are supported.
4.3 Workflow
The typical workflow to design a network using NETCO is as follows:
1. Acquire all required information about your network, including radio frequency,
bandwidth and maximum TX Power, as well as IP settings you need to use.
2. Design the network by drawing nodes and links on the network map
3. Select all SATELLAR devices and input radio settings using the Property Tree editor
4. Select the Network Settings icon and choose suitable values for Design Assistance
settings. You may also skip this step at first and just see what gets generated…
5. Enter any individual IP Addresses you wish by selecting the desired node and entering the
IP address
6. Run Assists by clicking on the arrow icon
to automatically generate routing settings.
We recommend familiarizing yourself with the workflow, especially the Assist functions, by
designing some practice networks before designing your actual network.
4.4 Managing settings manually
Some settings need to be entered manually. At minimum, these include the radio settings.
To enter settings manually, select one or more nodes from the map and use the Property editor
(see chapter 3.3.2) to enter the needed values.
18
SATEL NETCO –
User Guide, Version 0.7.3
4.5 Automatic network design using Assists
NETCO is capable of assisting users in the most laborious and error-prone tasks of network
design.
Currently NETCO Assist can perform the following tasks:
 Assigning unique Radio Medium Access Control (RMAC) addresses to each Radio Unit
(RU) in the network
 Generating Packet Routing (PR) tables for each RU
 Generating Internet Protocol (IP) addresses for the radio-side interfaces of each Central
Unit (CU)
 Generating IP routing tables so all CUs can route IP traffic to each other
 Generating IP addresses for Ethernet (eth0) interfaces of CUs, as well as user’s routers
and other IP devices, based on a choice of network LAN mode, either Routed, Proxy ARP
or Bridge mode
 Also generate all necessary routing tables in Routed, Proxy ARP or Bridge mode based on
information given
 Generate VLAN settings and tables in Routed, Proxy ARP or Bridge modes, if required.
While generating these settings, the Assist feature also allows users to manually override any and
all IP addresses and other settings by a locking mechanism. Assist will give an error message if
any user-entered settings would result in conflicts and cause a non-working network to be
defined.
4.5.1 Accessing Assist settings
Settings and parameters controlling the Assist functions are located in the Network Settings,
accessible by selecting the network settings icon. The Assist settings can be found under the
Design Assistance heading, which can be opened by clicking the arrow button .
The settings are listed below, with explanations. Default values are printed in bold.
4.5.2 General Assist settings
 Run delay: If run mode is set to automatic, run delay specifies the time after last change
NETCO will wait before starting the Assist process.
 Run mode: Automatic/Manual
4.5.3 RMAC assist
These settings control how radio unit RMAC addresses are generated.
 RMACs: ON/OFF
 RMAC settings – Start: 1. First numeric value to assign as RMAC address. Change this to
instruct NETCO to assign RMAC addresses starting from an address other than 1.
4.5.4 PR assist
These settings control how radio unit Packet Routing routes are generated.
 PR: ON/OFF
19
SATEL NETCO –
User Guide, Version 0.7.3


PR Settings – Mode: Tree/All. Select the route generation method (see below)
Root Node: 1. Set the root node id for Tree mode. (See below). If a SATELLAR modem
with this node ID does not exists in the network, an error occurs during Assist run. (unless
Mode is set to All)
Route generation methods: In Tree mode PR routes are generated so the Root Node can
communicate directly to all other nodes linked to directly it and all of nodes linked to those
nodes etc. In contrast all the other nodes can only communicate with the root node and any
nodes along the path from them to the root, NOT with nodes in other branches of the “tree”.
The benefit of this method is that the number of routing table entries is kept to a minimum and
in the event of changes to the network, such addition or deletion of a modem, only a limited
number of Radio Units need to be re-synchronized.
In All mode, all nodes will receive routes to all other nodes in the network. The drawback is the
large number of routes required in each Radio Unit, and the need to synchronize every Radio
Unit when even a simple change (such as addition of a modem to the network) occurs.
4.5.5 Radio IP assist
These settings control how central unit IP settings for the radio (tun0) interface are generated.
 Radio IP: ON/OFF
 Radio IP settings – Base addr: 10.10.32.0/19 tun0. This is the LAN address of the
SATELLAR CU’s tun0 radio subnet. Each CU will receive an IP address from this subnet,
with the individual part of the address corresponding to the RMAC address of the Radio
Unit. (See SATELLAR user manual for more information.) It may become necessary in
some cases to change this value if your network is using this address space for other
purposes.
 Radio IP settings – Route mode: Tree/All. In Tree mode IP routes are generated from
Root Node to all other nodes, and from all other nodes to root node. There will be no
routes generated from remote radio station LANs to other radio station LANs, only to the
root node’s LAN. In All mode all LANs can communicate with each other.
 Radio IP settings – Root Node: 1. The node ID of the root node, required by NETCO if
Route mode is set to Tree. It must be a SATELLAR node.
 Radio IP settings – WAN target: OFF/ON: Set this to ON to add an additional routing
table row to each SATELLAR. Limited to one additional row per modem. Note that a
better way to do this is to add Generic IP Router nodes and modify their “Networks”
properties, this way you can add any number of external route targets.
 Radio IP settings – WAN tgt addr: 123.123.1.0/24 192.168.1.1: If WAN target is set to
ON, this value will be added as a routing table row to each SATELLAR CU.
4.5.6 LAN assist
These settings control how central unit IP settings for the Ethernet (eth0) interface and the CU IP
Routing tables are generated. You may choose one LAN mode for either routed, Proxy ARP or
Bridge functionality. Optionally, VLANs may also be generated.
 LAN Mode: Manual/Routed/Proxy ARP/Bridge Open/Bridge Restricted. See below for
details.
 LAN Settings – Addr. template: 192.168.0.0/24. Controls address space of the LAN or
LANs that are generated, depending on the chosen mode. See below for details.
20
SATEL NETCO –
User Guide, Version 0.7.3


LAN Settings – CU addr. offset: 1. By default, CUs are assigned addresses from the start
of the LAN address space. Change this value to start the CU addresses from another
offset.
LAN Settings – VLAN Addr. template: (empty). If given, a VLAN corresponding to the
template will be created in the CUs. To add a VLAN template, click the ‘+’ sign beside
the ‘VLAN Addr. template’ row. By default, the template looks like this: 0.0.0.0/24 eth0
vlan0 1 0 0 0. The IP address with mask will be used as the VLAN subnet address space.
Individual CU’s will be assigned IP addresses from this address space, modified by the
CU Offset value. Any IP Hosts connected to CU’s will be given an address from the
space beginning at offset 1. The ‘eth0’ text should be left as is. The ‘vlan0’ is the name
of the VLAN for information purposes only. The first number, ‘1’ by default, is VLAN ID
and it should be assigned a valid value corresponding to your network plan. The last
three zeros will be overwritten and should be left as they are.
4.5.6.1 LAN Mode: Manual
In this mode, NETCO will not generate Ethernet IP Addresses for any devices.
4.5.6.2 LAN Mode: Routed
In this mode, NETCO will generate one LAN for each CU in the network, based on the given
template. The LANs will be assigned in the order of Node ID of the CUs.
For example, if mask is /24, and IP is 192.168.0.0, LANs will be in the format192.168.1.0/24,
192.168.2.0/24 and so forth. In the first LAN, the CU will receive IP address 192.168.1.1, if
the offset is 1, and 192.168.1.50 if the offset is 50.
Example 2: If mask is /29, LANs will be 192.168.0.0/29, 192.168.0.8/29, 192.168.0.16/29,
etc.
Please ensure that CU offset is not too big to fit in the LAN, as limited by the mask. For example,
a mask of /24 will allow device addresses in the range of *.1 to *.254.
4.5.6.3 LAN Mode: Proxy ARP
In this mode, NETCO will generate one LAN address space and all CUs, IP Hosts and IP Routers
will receive an IP Address from this same LAN. Additionally, SATELLAR CUs will be set into the
Proxy ARP mode and all necessary routing tables generated so that all IP traffic to all defined IP
Hosts and IP Routers will work. Due to the nature of the Proxy ARP mechanism, all IP addresses
must be added to the routing tables, therefore, you must add all of your devices as either IP
Hosts or IP Routers and ensure that NETCO is aware of their actual IP Addresses, either by
entering them manually to each IP device, or lettings NETCO generate the IP addresses and
then copying the settings to your devices.
SATELLAR CUs will received IP addresses modified by the CU Offset value, all other devices will
receive IP addresses starting from the first available address of the LAN.
4.5.6.4 LAN Mode: Bridge Open
In this mode, NETCO will generate one LAN address space in the same way as in the Proxy ARP
mode. SATELLAR CU’s will be put into Bridge mode, please consult the SATELLAR user manual
for details. In Bridge Open mode, any and all IP traffic will be transmitted via the radio interface,
even unneeded traffic typically caused by Windows machines. In addition it will take some time
21
SATEL NETCO –
User Guide, Version 0.7.3
before ARP tables are replicated to all Central Units, which means a delay after switching on the
network and before traffic will actually start working.
4.5.6.5 LAN Mode: Bridge Restricted
In this mode, NETCO will generate one LAN address space in the same way as in Proxy ARP
and Bridge Open modes. In addition, the Bridge modules of SATELLAR CUs will be set to
restricted mode, and allow lists will be calculated based on IP Hosts and Routers present in the
network map. Therefore, you need to add all your IP devices as either IP Host or IP Router nodes
with correct addresses to the map. All other IP addresses will be blocked.
22
SATEL NETCO –
User Guide, Version 0.7.3
5 Synchronization
Synchronization is most commonly copying settings from NETCO Database to a Node (Device)
which is considered as the "normal" direction. The other possibility is to copy settings from Node
(Device) to NETCO Database. Synchronization is a generic procedure in NETCO which in
theory should be possible to apply to all Node types which support Synchronization, not just
radio modems.
5.1 Open synchronization dialog
Once all the Nodes and Links are created and configured it's possible to synchronize the
physical devices.
It is recommended to use "Local Connection" mode, since "Network connection" mode is not
fully supported. "Local connection" means simply that there is no radio network or intermediate
Nodes between the NETCO system and the target Node. In practice, the Nodes are configured
in an office or laboratory environment by connecting them one-by-one to the same cable, which
is connected to the PC running NETCO.
To start synchronization, select the Node or Nodes you wish to synchronize and click the
"Synchronize Selected" tool in the Tool area (under the Network and Sync heading). For
individual nodes synchronization can be started from context menu (see Image 6).
Then just follow the steps provided by the synchronization wizard.
23
SATEL NETCO –
User Guide, Version 0.7.3
Image 6: Open synchronization dialog
5.2 Connecting to the device
The first view of synchronization wizard allows the user to select the type of connection to the
device.
The following connection types are available:
- Local connection. The Node (Device) is connected locally (not via the radio network) to
the NETCO and local addressing mode (i.e. local address) can be used to communicate
with the device instead of its Network address (i.e. previously configured address). With
Satel radio modems, the local address is equal to having RMAC=0 in the Satel NMS
Protocol messages. Local connection using serial media is the most reliable way to
configure Nodes (devices) because it allows the most reliable connection to change for
example target Node addresses without losing contact with the Node in the midst of the
process. Local connection to a node resembles the way how the Network Interface node
is connected to the next upper layer system.
The connection string (see 5.2.1) is specified in Network settings > Local connection.
24
SATEL NETCO –
User Guide, Version 0.7.3
-
Network connection. The target Node (Device) is not directly accessible i.e. is "behind" a
Network Interface Node and network addressing mode (i.e. network address, RMAC >
0) must be used to communicate with the device. Network connection requires that the
network addresses of the target Node are in the same values as they are currently
defined in NETCO because network addresses of the device are used to communicate
with it. Since network address of the device is used in communication it is possible, that
the connection is lost during configuration changes. This method is used for already
existing physical networks and assumed for updating of individual settings but not for full
device synchronization.
The connection string (see 5.2.1) is specified in Network settings > Network connection.
-
Custom. The connection string (see 5.2.1) is not defined in the Network settings but
should be typed manually, as well as access method and address usage can be selected.
Image 7: Connection methods
5.2.1 Connection string
Each of the methods requires a media connection string which specifies the access to the device.
NETCO supports currently two different media to connect to a Node (Device) or Network. You
can use serial media i.e. (USB) serial port connection or TCP socket media i.e. with Ethernet/IP
connection.
Connection string format is specified in the Table 1.
25
SATEL NETCO –
User Guide, Version 0.7.3
Note:
- Serial port parameters are optional, i.e. if a parameter is missing from the connection
string, then its default value is applied.
- Connection string should not contain spaces
Connection string examples:
serial:port=COM22,baud=115200
sockettcp:ip=192.168.0.68,port=55555
Table 1: Connection string
Serial port
Format
serial:port=<serial_port_name>[,<param_name>=<value>,…]
Parameters
Name
port
baud
data or databits
stop or stopbits
parity
hs or handshake
rts
dtr
Value format
port name, e.g. COM1
Baud rate in one of the following
formats:
115000 or
115.2k or
115k2 or
115k
7, 8 or 9
0, 1, 1.5 or 2
none, odd or even
None, RequestToSend,
RequestToSendXOnXOff or
XOnXOff
true or false
true or false
Default value
9600
8
1
n
None
true
true
TCP socket
Format
sockettcp:ip=<ip_address>,port=<port>
Parameters
Name
ip
port
Value format
IP address
port
Default value
127.0.0.1
8181
5.2.2 Testing the media
Selected media connection string can be tested by clicking of “Test” button.
Note that it tests only serial port or TCP socket existence, but not communication with device.
26
SATEL NETCO –
User Guide, Version 0.7.3
5.3 Device identification
Once connection method is selected, click “Next” button to go to the next view where nodes can
be selected and synchronized one-by-one (see Image 8).
Image 8: Node selection
Select a Node from the list, make sure that the physical device associated with the Node is
completely booted and properly connected. Click “Identify” button to start communication with
device.
Typically, if connection succeeded and the device is connected locally, identification lasts about
2 seconds.
If identification fails, error message will be displayed. Possible reasons of failure:
- Connected device has not booted completely yet.
- There is no connection to the device because of wrong media connection string
parameters or due to other connection problems between NETCO and the device.
- Connected device and selected NETCO node are inconsistent to each other (different
types).
In all above case synchronization is not possible.
If identification succeeds, synchronization wizard displays device info (see Image 9).
27
SATEL NETCO –
User Guide, Version 0.7.3
Image 9: Identification succeeded
If during identification are detected situations that user should pay attention for, warning
message will be displayed to help the user to avoid human mistakes. Those possible situations
are:
- Connected device has been already synchronized with another NETCO node
- Selected NETCO node has been already synchronized with another device
5.4 Synchronization options
Once identification succeeded, settings can be transferred to/from device.
The following synchronization options are available (see Image 9):
- Ignore errors. If checkbox is checked, the synchronization would continue regardless of
amount of errors. Allowed amount of errors is limited by two. If the checkbox is
unchecked and limit of errors is reached, then synchronization is aborted.
- Verify data. This option is applicable for downstream (i.e. from NETCO to Device)
synchronization only. If checkbox is checked, then all settings written to the device are
read back and values are compared to the values from NETCO DB.
- Optimized. This option is applicable for downstream (i.e. from NETCO to Device)
synchronization only and enabled if the Node was fully and successfully synchronized
previously and there are no local changes detectable in the device. If checkbox is
28
SATEL NETCO –
User Guide, Version 0.7.3
checked, then NETCO will write only settings that have been changed after that last
successful synchronization. This way synchronization will happen more quickly. SATELLAR
products support detecting local changes efficiently and therefore they support optimized
synchronization with NETCO. Optimized synchronization is especially useful feature when
using Network Connection with existing network and when the changes to network
configuration is mainly managed by NETCO.
5.5 Synchronization procedure
Synchronization is started by clicking “Synchronize” button. Progress bar is shown on the screen.
The synchronization procedure depends on selected direction:
-
Upstream (from Device to NETCO): all readable device settings are fetched from the
device and saved into the NETCO database.
Downstream (from NETCO to Device ): all read-only settings (e.g. for SATELLAR readonly settings are Serial Number, Modem Model, etc.) are fetched from the device and
saved into the NETCO database and all writable settings are copied from NETCO
database and written to the device. After that, device type specific commands are sent to
the device, for example for SATELLAR devices “save” command is sent to each subunit
(CU and RU) and then “reset” command is sent to the radio unit (RU) only.
The order of subunits (i.e. in which order subunits are being configured) depends on
Connection method. The “closest” or “connected” subunit is configured last. For
example for SATELLAR, in Local Connection case, Central unit (CU) is considered to be
closest, so the Radio unit (RU) is configured first, then it is reset and then CU is
configured. In case of Network connection, RU is the closest subunit, so settings are
written to CU first.
5.6 Synchronization results
Once the synchronization is done, notification about synchronization result is shown to the user.
The wizard goes back to Node selection view, where next node in the list is selected (see Image
10). For just synchronized Node status, total amount of settings and amount of failed settings
are displayed in the Node grid. Detailed synchronization results can be checked by clicking
“info” icon (see Image 10).
Later, after synchronization wizard is closed, detailed synchronization results are available in
“Node List” tab view.
29
SATEL NETCO –
User Guide, Version 0.7.3
Image 10: Synchronization result
30
SATEL NETCO –
User Guide, Version 0.7.3
6 APPENDIX
31
SATEL NETCO –
User Guide, Version 0.7.3
7 VERSION HISTORY
Version history:
Version:
Date:
0.5
0.6
22.01.2016
25.01.2016
0.7
25.01.2016
0.7.1
0.7.2
0.7.3
25.01.2016
25.01.2016
27.01.2016
Remarks:
First public version
- Reference to Synchronization chapter was corrected
- Irrelevant text and chapters were removed
More content to 2.1 installing and 2.2. updating. “Main page” ->
“Network page”.
Minor fixes and improvements
Logo added
5.2 Reference error fix: removed failing reference.
32
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertisement