Kirale Technologies KTBRN1 Quick Start Manual

Border router

Advertisement

Quick Links

KTBRN1 Border Router
Quick Start Guide

Introduction

Installation and setup of the KTBRN1 Thread Backbone
Border Router.

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the KTBRN1 and is the answer not in the manual?

Questions and answers

Summary of Contents for Kirale Technologies KTBRN1

  • Page 1: Introduction

    KTBRN1 Border Router Quick Start Guide Introduction Installation and setup of the KTBRN1 Thread Backbone Border Router.
  • Page 2: Disclaimer

    Kirale Technologies. Kirale® and Kirale Technologies logos are registered trademarks of Kirale Technologies S.L. Other trademarks are the property of their respective owners. Contact Information Kirale Technologies S.L.
  • Page 3: Table Of Contents

    KTBRN1 Quick Start Guide April 2020, v2.1 Contents Introduction ................................1 Disclaimer .................................. 2 Trademarks and Copyright ............................. 2 Contact Information ..............................2 Contents ....................................3 Revision History ................................. 4 1. Required Components ..............................5 2. Installation Guide ................................ 6 2.1.
  • Page 4: Revision History

    KTBRN1 Quick Start Guide April 2020, v2.1 Revision History Date Revision Changes 08/2019 Initial release. 10/2019 Updated content with more explanations and screenshots. 02/2020 New version 2.0 04/2020 New features and contents added © Kirale Technologies...
  • Page 5: Required Components

    KTBRN1 Quick Start Guide April 2020, v2.1 1. Required Components Before beginning with KTBRN1 installation, it is recommended to have the following list of components in place:  A KTBRN1 device. A micro SD card, recommended class 10 A1-rated and at least 2 GB of capacity.
  • Page 6: Installation Guide

    April 2020, v2.1 2. Installation Guide 2.1. Download required software Make sure you get the latest release of our Debian-based image for KTBRN1 that includes KiBRA software, which you will can find on our website, in the following URL. ...
  • Page 7: First Time Installation

    5) Eject the SD card from the computer and place it in the KTBRN1 card holder. 2.3. First time installation Connect a USB cable to the KTBRN1 and to PC or USB hub. The first time you turn on the KTBRN1 device, it will take about a couple of minutes to be ready to accept connections.
  • Page 8 KTBRN1 Quick Start Guide April 2020, v2.1 2.3.1. Connecting via USB Serial port Pi USB to Serial A new serial device should be listed ( ) depending on your OS. It may be required to install the driver for the USB Serial port, so check if the device has been recognized by your PC.
  • Page 9 KTBRN1 Quick Start Guide April 2020, v2.1 Once you have got access to KTBRN1 via USB serial, launch MobaXterm and open a new Serial session with the new listed port and speed 115200, then a login console should appear after clicking enter. Login with user root, password kirale123.
  • Page 10 KTBRN1 Quick Start Guide April 2020, v2.1 The welcome screen will show you information about IP addresses configured in KTBRN1 and what KiBRA version is running. By default, the provided image comes configured with a static IPv4 address for Ethernet interface: IPv4 address: 192.168.75.84/24...
  • Page 11: Web Administration Panel

    KTBRN1 Quick Start Guide April 2020, v2.1 3. Web Administration Panel The access to the Web Administration Panel is available in port 8000 of KTBRN1. Type http://192.168.75.84:8000 http://[IPv6]:8000 in your browser (preferably Chrome or Firefox for compatibility reasons) and the login page should be shown.
  • Page 12: Change Network Configuration

    In the picture above, the new IPv4 address acquired by DHCP is 10.1.1.163. It is now possible to connect to KTBRN1 through SSH client to this IPv4 address or also to IPv6 link-local address if the PC is connected to the same network. Besides KiBRA will use this exterior IPv4 address for its NAT64 function.
  • Page 13: Update Kibra

    This can be done by going to “KiBRA” menu and clicking the “Upgrade” icon which is located next to the KTBRN1 picture in “System” section. Then select the KiBRA-v2.x.x.zip file from the PC, click the “Install” bottom and follow the instructions that will appear on the screen.
  • Page 14: Configure Border Router

    KTBRN1 Quick Start Guide April 2020, v2.1 3.3. Configure Border Router Click the “Settings” sub-menu under the “KiBRA” menu to access the configuration page. If an input field is shown in red colour, a right value will be required to be set before saving changes.
  • Page 15 KTBRN1 Quick Start Guide April 2020, v2.1 • Autostart: if this option is checked, Border Router will try to automatically join to Thread network after the next reboot. • Out-of-band Commissioning: it allows selecting the kind of attaching that Border Router will make when it starts up.
  • Page 16 KTBRN1 Quick Start Guide April 2020, v2.1 Once Border Router has been configured with desired parameters, save the changes. © Kirale Technologies...
  • Page 17: Start-Up Border Router

    KTBRN1 Quick Start Guide April 2020, v2.1 3.4. Start-up Border Router Go to “KiBRA” menu in order to start Border Router Engine. After clicking the start button, the device either will join the selected network or form a new one, depending on settings configured by the administrator.
  • Page 18 KTBRN1 Quick Start Guide April 2020, v2.1 If you go back to the “Settings” sub-menu, it is possible to see the rest of Thread network configuration parameters that have been configured either by the administrator or by the system itself on startup.
  • Page 19 KTBRN1 Quick Start Guide April 2020, v2.1 Here you can gather the information needed to attach other devices to the same network. There is a button below called “Export Settings” which allows copying commissioning information, required to provision a new device into the network, by means of KiNOS commands.
  • Page 20 KTBRN1 Quick Start Guide April 2020, v2.1 © Kirale Technologies...
  • Page 21: Services

    KTBRN1 Quick Start Guide April 2020, v2.1 3.5. Services The administrator can see what services are being provided by Border Router right now and their current state in “Services” sub-menu under the “KiBRA” menu. There are four sections which show different services that Border Router is able to provide to.
  • Page 22 KTBRN1 Quick Start Guide April 2020, v2.1 3.5.2 DHCP If DHCP option was selected at the time of configuring the network prefix, this page will show the list of nodes which have acquired its IPv6 address via DHCP and what it is.
  • Page 23 KTBRN1 Quick Start Guide April 2020, v2.1 3.5.4 Commissioner The Border Router can also act as Commissioner within the Thread network. Once this function is enabled, the administrator can set up the steering data in order to allow new devices to attach to the network.
  • Page 24 KTBRN1 Quick Start Guide April 2020, v2.1 © Kirale Technologies...
  • Page 25: Visual Network

    KTBRN1 Quick Start Guide April 2020, v2.1 3.6. Visual Network The network topology map is a map that allows an administrator to see the physical layout of connected devices. Having the map of a network’s topology on hand is very useful for understanding how devices connect to each other and the best techniques for troubleshooting.
  • Page 26: Logs

    KTBRN1 Quick Start Guide April 2020, v2.1 3.7. Logs The administrator can look into system logs through the “Logs” sub-menu under the “KiBRA” menu. It allows filtering logs by severity level and category. © Kirale Technologies...
  • Page 27: A Brief Insight

    KTBRN1 Quick Start Guide April 2020, v2.1 4. A brief insight In order to gather a deeper knowledge of how KTBRN1 works, a detailed description of the system, what tools are available and a few tips for troubleshooting are provided. 4.1. Advanced filesystem KTBRN1 device is a Linux-based system which has the peculiarity that its filesystem is running from a SD card.
  • Page 28: Inter-Process Communication

    The administrator can manually start up “kibra” application by means of following commands: root@KTBRN1:~# service kibra stop root@KTBRN1:~# source /opt/kirale/py3env/bin/activate (py3env) root@KTBRN1:~# python -m kibra –-log debug In the case of “ajenti” application, the administrator should use the following commands: root@KTBRN1:~# service ajenti stop root@KTBRN1:~# source /opt/kirale/py2env/bin/activate (py2env) root@KTBRN1:~# ajenti-panel --dev 4.3.
  • Page 29 KTBRN1 Quick Start Guide April 2020, v2.1 END OF THIS DOCUMENT © Kirale Technologies...

Table of Contents