Icon-5066 Eval Guide - Isode · Adding Node 1 Click on [Add New Node] and in the pop-up (Image 4)...

Isode

Icon-5066 Evaluation Guide Configuring R1.0 Release of Isode's Icon-5066 Server on Windows and Linux Platforms for use with applications requiring a single STANAG 5066 node or multiple STANAG 5066 nodes.

Isode

Evaluation Guide: Icon-5066 of 20

Contents Introduction.....................................................................................................................3Objectives.................................................................................................................................3UsingIsodeSupport..................................................................................................................3

Preparation......................................................................................................................4IsodeProducts..........................................................................................................................4CreatingandstartingServices(Windows)................................................................................4Creating&StartingServices(Linux)..........................................................................................5

Adding&ConfiguringNodes............................................................................................6AddingNode1..........................................................................................................................6ConfiguringNode1...................................................................................................................7Adding&ConfiguringNode2.................................................................................................11

StartingMoRaSky&Icon-5066CoreProtocolServer....................................................13

TestingtheConfigurationwiththeS5066Console........................................................15InstalltheS5066Console........................................................................................................15StarttheS5066Console.........................................................................................................16ConfiguretheS5066Console.................................................................................................16TestingwiththeS5066Console..............................................................................................17

WhatNext?....................................................................................................................19Whitepapers...........................................................................................................................19

Copyright........................................................................................................................20

Isode


Introduction

This guide is intended to give the reader basic information on how to configure Release 1.0 of Isode's Icon-5066 Server Product. Icon-5066 is a STANAG 5066 Server that can support multiple STANAG 5066 nodes on a single server.

Supporting multiple nodes on a single server is very helpful in Lab Environments which this guide is aimed at. In a Live Environment it is likely that different nodes will be on different networks and locations, as such in this scenario an Icon-5066 Server will be required for each node.

More information on Icon5066 can be found at www.isode.com/products/icon-5066.html.

Objectives

In this guide you will be shown how to configure two STANAG 5066 nodes that are connected to Isode's Modem Radio Sky Simulator (MoRaSky).

The diagram below gives an overview of this setup.

By the end of this guide you will have:

1. Installed the Icon-5066 Server Software and started the Icon-5066 Services

2. Used the Web Based User Interface to configure S5066 Node 1 and S5066 Node 2 that are connected to each other via a local Isode MoRaSky instance.

3. Connected the S5066 Console GUI to S5066 Node 1 and S5066 Node 2 to test data throughput.

For the purposes of this evaluation we have assumed this is a "clean" installation of Icon-5066 on to a physical or virtual machine. If you have previously installed Icon-5066 on the hardware or VM you are using for this evaluation, please make sure you have completely uninstalled that version before proceeding.

Using Isode Support

You will be given access to Isode support resources when carrying out your evaluation. Any queries you have during your evaluation should be sent to [email protected]. Please note that access to the Self-Service Portal for web-based ticket submission and tracking is not available to evaluators.

Isode


Preparation

You should visit www.isode.com/products/supported-platforms.html to discover which operating systems are supported for Isode evaluations. Please note that in addition to the server platforms listed, we support the use of Isode servers on Windows 8, Windows 8.1 and Windows 10 for simple evaluations and demonstrations.

Isode Products

Many Isode management tools are written in Java, so you should install Java before installing the Isode packages. You can obtain the required packages (Java SE 8 - JRE) from www.oracle.com/technetwork/java/javase/downloads/index.html.

Note for Windows Users: You will need to install Visual C++ Redistributable Packages, which can be downloaded from https://www.microsoft.com/en-

us/download/details.aspx?id=48145. You want the "vc_redist.x64.exe" for 64-bit Windows.

If you're running Windows 7, 8 or 10 you will need to run Isode Management tools (like S5066 Console and Isode Service Configuration Tool) as an Administrator. You

can do this by right-clicking on the program icons and choosing 'Run as administrator' from the pop-up.

Isode binaries can be obtained by clicking on the links appropriate for your platform at the following URL - https://www.isode.com/customer/binary/Icon5066/index.html. Please note that this is a password protected page and you should have been given access details by your Account Manager.

You should download all the packages for your platform. On Windows you should install the Icon-5066 software with the default settings and the M-Switch Software with a custom installation (instructions for the M-Switch installation will be given later). On Linux install all the RPMs as root with the command:

# rpm -i ISD*.rpm

Creating and starting Services (Windows)

Once you have installed the Icon5066 software you need to create the Icon-5066 Distributed Data Service & Icon-5066 Core Protocol Server services.

From the Start Menu select “All Programs>Icon5066 1.0>Services>Install Icon-5066 Services” (Image1). Note if you are running this on a Windows 7, 8 or 10 Operating system you will need to "Run as Administrator")

Isode


Image1:InstallServices

You should then use the Windows Services Administrative Tool to Start and Stop the services (Image 2).

Image2:Start&StopServices

You should now start just the Icon-5066 Distributed Data Service.

Creating & Starting Services (Linux)

To start the Icon-5066 Distributed Data Service on Linux run the command (as root):

# systemctl start isode.icon.ddsd"

Isode


Adding & Configuring Nodes

The Icon5066 Server can support multiple S5066 Nodes (on separate ports) on a single server. These nodes are configured using Icon-5066 Console, a Web-based management tool. In this section we’re going to add 2 Nodes.

In this guide we’re going to configure nodes to use Isode’s MoRaSky (Modem Radio Sky), a software tool provided by Isode to help test Isode HF products. MoRaSky

provides a service equivalent to HF modems connected to Radios and operating over the Ionosphere. It enables sophisticated testing of Icon-5066 and the applications it

supports, without use of hardware or Over the Air transmission.

If your intention is to use physical modems in place of MoRaSky, please consult Section 3.7.2 of the Icon-5066 Administration Guide in conjunction with this section.

Launch Icon-5066 Console by bringing up a web browser and entering either http://myserver.hostname:4001 from a remote machine or http://localhost:4001 from the server itself (Image 3)

Image3:Icon-5066Console

Adding Node 1

Click on [Add New Node] and in the pop-up (Image 4) fill in the fields as follows:

• Enter a Friendly Name for Name, we will use "Node 1 MoRaSky - 1"

• Enter the Node Address (typically 10.50.66.1 for the first node), Node Addresses must be unique and are similar to IPv4 syntax, but the first octet has max value of 15. The choice for demos is arbitrary, but live deployments have rules for international allocation.

• Enter the SIS Host (the hostname of your Icon-5066 Server), this is optional and if left

Isode


blank Icon5066 will listen on all IP Addresses, if your server has multiple IP Addresses and you want each node to listen on a specific IP Address then you should enter the IP Address or hostname here.

• Enter the SIS Port, 5066 is the standard port for this protocol but if you are configuring multiple nodes on this server you will need different Ports for each node.

Image4:AddNewNode

Click [Add] to commit this change.

Configuring Node 1

Each node consists of a core configuration together with a number of devices that are used by, or control the behaviour of, the S5066 node. Each working node configuration must define the following set of mandatory services.

• Modem device that defines how to communicate with the underlying modem (simulated or real).

• Rate Change device controls the rate at which data can be sent to the modem.

• Transmission Control device controls the pattern of data transmission.

Back in the main screen select “Modem > morasky” from the Add new device dropdown for your

Isode


new node (Image 5).

In this evaluation we will be using the Pre-Configured "MoRaSky clear channel, 2 Radios" option that uses Waveform 4539, 9600 bps and Small Interleaver.

Image5:AddingtheModemdeviceforNode1

For MoRaSky Modem on the first node (Image 6) the "RAP1 interface IP address" is 127.0.0.1 and the "RAP1 interface port number" is 58001.

Image6:ConfiguringtheModemforNode1


Next add the Rate Change device. Select "Add new device > Rate Change > fixed" (Image 7). Using fixed is a good simple choice for initial testing. However, SNR is usually the best choice for many deployments as it enables speed to adapt to conditions.

Isode


Image7:AddingtheRateChangedeviceforNode1

As in Image 8, select a "Waveform" from the Dropdown menu that contains the "Waveform" (wf), "Bits per second" (bps) and "Interleaver" (ilv), the Waveform needs to be the same for both Modems. With Autobaud Waveforms, such as 4539 the speed (bps) and Interleaver (ilv) can be different.

The pre-installed 2 Radio Clear Channel MoRaSky program has a default setting of wf=4539, bps=9600 and ilv=S but will change to whatever you select here for the Waveform.

Isode


Image8:ConfiguringtheRateChangedeviceforNode1


Finally, for Node 1, add the Transmission Control device. Select "Add new device > Transmission Control > si gaps" (Image 9), "si gaps" is "Simplex" (two modems talking in turn) and "gaps" (only transmit when there is data to send).

Isode


Image9:AddingtheTransmissionControlDeviceforNode1

In the Add device pop-up (Image 10), make no changes and click [Add]

Image10:ConfiguringtheTransmissionControlDeviceforNode1

You have now finished configuring Node 1.

Adding & Configuring Node 2

Add and configure Node 2 in the same way as Node 1 but using the following parameters:

• Node Address: 10.50.66.2

• Node Port: 6066

• MoRaSky Port: 58002

Isode


At the end of this process, Icon-5066 Console should display 2 Nodes, as in Image 11.

Image11:NodeConfigurationComplete

Isode


Starting MoRaSky & Icon-5066 Core Protocol Server

Start MoRaSky on Windows by using the MoRaSky Clear Channel, 2 Radios option as in Image 12:

Image12:StartingMoRaSky(Windows)

To start MoRaSky on Linux run the command:

# /opt/isode/sbin/morasky -W -wf "wf=4539 bps=9600 ilv=S" -P 2 0.0.0.0

You will see confirmation as in Image 13.

Image13:MoRaSkystarted(Linux)

On Linux you should now install the “Icon-5066 Core Protocol Server” service by clicking on the server management icon in the top right of the configuration UI and selecting [Install Icon-5066 Server]. Note that this last step is not needed on Windows.

You can then start the service by selecting [Start Icon-5066 Server] from the same location (Image 14).

Isode


Image14:ServerManagement

You’ll see the nodes connect, as in Image 15.

Image15:ConnectedNodes

Back in the Icon-5066 Console, following a refresh, both nodes will be shown as in Image 16.

Image16:Icon-5066Console

Isode


Testing the Configuration with the S5066 Console

Tow test that the two nodes connect, we’re going to use the S5066 Console, which is installed as part of Isode’s M-Switch MTA.

Install the S5066 Console

Start M-Switch and, when asked for a Setup Type, choose [Custom] as in Image 17.

Image17:CustomM-SwitchInstallation

In the Custom Setup screen (Image 17) disable all of the features except for “Messaging Graphical Tools” by selecting, for every other option, the “Entire Feature will be unavailable” option, as in Image 18.

Image18:CustomSetup

With only “Messaging Graphical Tools” selected for installation, click [Next] on this screen and all subsequent screens until reaching [Finish], which you should also click.

Isode


Start the S5066 Console

Start the S5066 Console on Windows by selecting it from the menu (Image 19).

Image19:StartS5066Console(Windows)

To start S5066 Console on Linux, run the command:

# /opt/isode/bin/s5066console

Configure the S5066 Console

From the main S5066 Console screen (Image 19) select “Server > New”.

Image20:AddnewServer

In the New S5066 Server screen (Image 21) enter the following details:

• Friendly Name: Icon 5066 Node1

• Hostname: ICON-5066

• Port: 5066

Tick the "Auto-discover" Checkbox and then click [OK].

Isode


Image21:ConfiguringNode1inS5066Console

Now repeat this New Server process for Node 2, using the details that follow:

• Friendly Name: Icon 5066 Node2

• Hostname: ICON-5066

• Port: 6066

Tick the "Auto-discover" Checkbox and then click [OK].

Both nodes will now appear as separate tabs in the S5066 Console.

Testing with the S5066 Console

Clicking [Discover Peers], will allow you to see Icon 5066 Node 1 showing on Node 2 (Image 22) and Icon 5066 Node 2 showing on Node 1 (not shown but accessible on the Icon 5066 Node2 tab.

Isode


Image22:DiscoverPeers

Simultaneously you will see activity within MoRaSky (Image 23).

Image23:MoRaSkyactivity

You could also run a Throughput Test by clicking on the Throughput tab of either Node and clicking [Start] as in Image 24.

Image24:Throughputtest

Isode


What Next?

More information on Icon-5066 can be found on the Isode website at www.isode.com/products/icon-5066.html.

Detailed configuration and operational information Icon-5066 can be found in the Icon-5066 Administration Guide available from the Isode website at www.isode.com/Documentation/ICON5066ADM.pdf.

Whitepapers

Isode regularly publishes whitepapers on technical and market topics related to its products. A full list of these can be found at www.isode.com/whitepapers/.

Isode


Copyright

The Isode Logo and Isode are trade and service marks of Isode Limited.

All products and services mentioned in this document are identified by the trademarks or service marks of their respective companies or organizations, and Isode Limited disclaims any responsibility for specifying which marks are owned by which companies or organizations.

Isode software is © copyright Isode Limited 2002-2018, All rights reserved.

Isode software is a compilation of software of which Isode Limited is either the copyright holder or licensee. Acquisition and use of this software and related materials for any purpose requires a written licence agreement from Isode Limited, or a written licence from an organization licensed by Isode Limited to grant such a licence.

This manual is © copyright Isode Limited 2018.

Icon-5066 Eval Guide - Isode · Adding Node 1 Click on [Add New Node] and in the pop-up (Image 4)...

Documents

Transcript of Icon-5066 Eval Guide - Isode · Adding Node 1 Click on [Add New Node] and in the pop-up (Image 4)...