Skip to main content

Installation and upgrade procedures

This page describes the manual installation procedure.

Nevertheless, you may leverage the zero-touch/automated installation procedure provided by Infrastructure Commissioning Service (ICS), for this, please contact your ThingPark Support Team.

For an upgrade, you must follow the same steps as for the installation procedure, and you must reboot the box at the end of the procedure.

Installation Requirements

  • The installation described hereafter is manual, you need to have SSH access to the Base Station box, and have the root password.

  • In case of problems, you might have to use an FTDI cable to directly connect on the box.

  • You need to have at least 500MB free disk space.

  • You need to have the relevant installation package for your hardware:

    scheme: TAO_<manufacturer>.<BS_PROFILE>_<version>

Latest releases

ManufacturerTAO packageReferenceNotes
UfiSpaceTAO_ufispace.UFISP_FCPICO.1_1.4.0Ufispace Pico/Enterprise
TAO_ufispace.UFISP_FCMLB.1_1.4.0Ufispace MACRO V1.5
GemtekTAO_gemtek.GMTK_ODU.1_1.4.0Browan OutDoor Micro
TAO_gemtek.GMTK_FMTO.1_1.3.1Browan indoor Femto
KerlinkTAO_kerlink.KERL_NANO.1_1.4.0Kerlink Wirnet iFemtoCellkernel: keros 4.3.3
TAO_kerlink.KERL_NANO.2_1.4.0Kerlink Wirnet iFemtoCell-Evolutionkernel: keros 5.10.1
TAO_kerlink.KERL_ISTA.1_1.4.0Kerlink Wirnet iStationkernel: keros 4.3.3
TAO_kerlink.KERL_IBTS.1_1.4.0Kerlink Wirnet iBTSkernel: keros 4.3.3
MilesightTAO_milesight.MILEST_UG65.1_1.4.0Milesight UG65/UG67

Installation Steps

  1. Copy the installation package on your box under /

    scp TAO_<manufacturer>.<BS_PROFILE>_<version>  <admin>@<box ip>:/
  2. Execute the installation package

    ssh <admin>@<box ip>
    cd /
    chmod u+x ./TAO_<manufacturer>.<BS_PROFILE>_<version>
    ./TAO_<manufacturer>.<BS_PROFILE>_<version>

    Here is the output of a Kerlink wirfevo installation, the output will certainly be different in your case:

    root@klk-fevo-0404B3:/ # ./TAO_kerlink.KERL_NANO.2_1.3.1

    Self Extracting Installer

    ./
    ./rootfs-patch-tao-1.3.1-wirfevo.tar.gz
    ./install.autorun
    Execute tao-install.sh
    LRR custom configuration
    -> TAO fresh install, add complete lrr custom folder
    ipsec is in /etc, need to clean files and folder
    System characteristics: setting file not present: automatic creation ...
    -----------------------------------------------------------
    Checking consistency of system definition
    OK: SYSTEM defined: wirfevo
    OK: MANUFACTURER defined: kerlink
    OK: FIRMWARE defined: keros
    OK: MANUFACTURER_OUI defined: 7076ff
    OK: SEMTECH_REFDESIGN: 1.5 in (1.0 1.5 2.1)
    OK: at least one option set in [SEMTECH_V1_0 SEMTECH_V1_5 SEMTECH_V2_1]
    OK: TERMINFO defined: export TERMINFO=/etc/terminfo/
    OK: NETSTAT defined: netstat -an
    OK: VIEW_NTP_CONF defined: cat /etc/ntp.conf
    OK: TRACE_BACKUP_DIR defined: /user/actility/traces
    OK: at least one option set in [TAR_OPTION_X TAR_OPTION_EXCLUDE]
    OK: NETWORK_INTERFACE_FILE: valid file /etc/network/interfaces
    OK: SYSTEM_ETC: valid directory /etc
    OK: IPSEC: valid executable /usr/sbin/ipsec
    OK: IPSEC_CONF: valid file /etc/ipsec.conf
    OK: NTP_SERVICE: valid file /etc/init.d/ntpd
    OK: SFTP: valid executable /user/actility/lrr/sftp/sftp
    OK: IPTABLES_BIN: valid executable /usr/sbin/iptables
    OK: NETWORK_INTERFACE_FILE defined: /etc/network/interfaces
    -----------------------------------------------------------
    /user/actility used as root directory
    System : wirfevo
    ROOTACT not present in /etc/profile : add it
    New installation mechanism detected
    create service checkntp
    create service checktls
    create service checkvpn2
    create service gwmgr_restore
    create service ipfailover2
    create service lrr
    create service lrrplan
    Stopping Kerlink firewall
    Flushing iptable rules.
    Set default policy to 'ACCEPT'
    Flushing ip6table rules.
    Setting default IPv6 policy to 'ACCEPT'
    Starting LRR firewall
    Thu Apr 27 10:32:22 2023 [/etc/rcU.d/S89lrrfirewall] Info: create /var/run/lrrsystem: ROOTACT=/user/actility
    /etc/rcU.d/S89lrrfirewall: line 53: /user/actility/var/log/lrr/iptablesfrom.log: No such file or directory
    iptables are installed
    Keros system setting
    Restarting OpenBSD Secure Shell server: sshdstopped /usr/sbin/sshd (pid 980)
    .
    Fix /etc/nsswitch.conf issue
    LRR characteristics: setting file not present: automatic creation ...
    -----------------------------------------------------------
    Checking consistency of lrr definition
    OK: CHECKVPN_SERVICE: valid executable /etc/rcU.d/S90checkvpn2
    OK: IPFAILOVER_SERVICE: valid executable /etc/rcU.d/S90ipfailover2
    OK: SYSTEM_LOG: valid file /var/log/messages
    -----------------------------------------------------------
    execute postinstall script /user/actility/lrr/postinstall/ipfailover2.sh
    execute postinstall script /user/actility/lrr/postinstall/migrate2nfr920.sh
    82 - checkvpn2: Can't find vpn.cfg to migrate, no conversion to be done...
    ; Defines the principal interface
    principal=eth0
    ; Defines the bandwidth constraint to be applied on the principal interface (0: No constraint, 1: Limited bandwidth, 2: Very limited bandwidth)
    bandwidthconstraint_principal=0
    [bandwidthconstraint_principal:0]
    ; In seconds, defines at which frequency we test connectivity on principal interface when principal interface is used
    ; In seconds, defines at which frequency we test connectivity on principal interface when rescue interface is used
    ; In seconds, defines the ping timeout used for testing connectivity on principal interface
    ; Defines the amount of consecutive failed ping before deciding to restart the principal interface
    maxfailedprincipal=5
    [bandwidthconstraint_principal:1]
    ; In seconds, defines at which frequency we test connectivity on principal interface when principal interface is used
    ; In seconds, defines at which frequency we test connectivity on principal interface when rescue interface is used
    ; In seconds, defines the ping timeout used for testing connectivity on principal interface
    ; Defines the amount of consecutive failed ping before deciding to restart the principal interface
    maxfailedprincipal=5
    [bandwidthconstraint_principal:2]
    ; In seconds, defines at which frequency we test connectivity on principal interface when principal interface is used
    ; In seconds, defines at which frequency we test connectivity on principal interface when rescue interface is used
    ; In seconds, defines the ping timeout used for testing connectivity on principal interface
    ; Defines the amount of consecutive failed ping before deciding to restart the principal interface
    maxfailedprincipal=5
    89 - ipfailover2: ipfailover2.ini already exists, no conversion to be done...
    439 - ipfailover cleansing: nothing to clean...
    596 - ipfailover2: force postinstall after possible service activation
    600 - ==== Migration to NFR920 not requested ... ====
    VPN only supports LRRUUID-based uidmode (fromtwa or fromtwaonly)
    execute postinstall script /user/actility/lrr/postinstall/system_postinstall.sh
    Keros post-installation
    Removing any system startup links for ztp ...
    /etc/rc0.d/K10ztp
    /etc/rc1.d/K10ztp
    /etc/rc2.d/S54ztp
    /etc/rc3.d/S54ztp
    /etc/rc5.d/S54ztp
    /etc/rc6.d/K10ztp
    restart service checkntp
    Stopping /user/actility/lrr/com/checkntp.sh service: [FAILED]
    /user/actility/lrr/com/checkntp.sh is already stopped
    Starting /user/actility/lrr/com/checkntp.sh service: [OK]
    restart service checktls
    Stopping checkTLS service: [FAILED]
    checkTLS is already stopped
    Starting checkTLS service: [OK]
    restart service checkvpn2
    VPN only supports LRRUUID-based uidmode (fromtwa or fromtwaonly)
    restart service gwmgr_restore
    restart service ipfailover2
    Stopping /user/actility/lrr/failovermgr/ifacefailover2.sh service: [FAILED]
    /user/actility/lrr/failovermgr/ifacefailover2.sh is already stopped
    Starting /user/actility/lrr/failovermgr/ifacefailover2.sh service: [OK]
    restart service lrr
    Stopping lrr service: [FAILED]
    lrr is already stopped
    Starting lrr service: wirfevo
    no command to power on radio board
    Analyze calibration file ...
    File /user/actility/usr/etc/lrr/lowlvlgw.ini created
    Updating /user/actility/usr/etc/lrr/versions.ini file
    /user/actility/usr/etc/lrr/versions.ini file updated
    [OK]
    restart service lrrplan
    Stopping lrrplan service: [FAILED]
    lrrplan is already stopped
    Starting lrrplan service: [OK]
    System configuration done
    -----------------------------------------------------------
    Checking consistency of system definition
    OK: SYSTEM defined: wirfevo
    OK: MANUFACTURER defined: kerlink
    OK: FIRMWARE defined: keros
    OK: MANUFACTURER_OUI defined: 7076ff
    OK: SEMTECH_REFDESIGN: 1.5 in (1.0 1.5 2.1)
    OK: at least one option set in [SEMTECH_V1_0 SEMTECH_V1_5 SEMTECH_V2_1]
    OK: TERMINFO defined: export TERMINFO=/etc/terminfo/
    OK: NETSTAT defined: netstat -an
    OK: VIEW_NTP_CONF defined: cat /etc/ntp.conf
    OK: TRACE_BACKUP_DIR defined: /user/actility/traces
    OK: at least one option set in [TAR_OPTION_X TAR_OPTION_EXCLUDE]
    OK: NETWORK_INTERFACE_FILE: valid file /etc/network/interfaces
    OK: SYSTEM_ETC: valid directory /etc
    OK: IPSEC: valid executable /usr/sbin/ipsec
    OK: IPSEC_CONF: valid file /etc/ipsec.conf
    OK: NTP_SERVICE: valid file /etc/init.d/ntpd
    OK: SFTP: valid executable /user/actility/lrr/sftp/sftp
    OK: IPTABLES_BIN: valid executable /usr/sbin/iptables
    OK: NETWORK_INTERFACE_FILE defined: /etc/network/interfaces
    -----------------------------------------------------------
    /user/actility used as root directory
    System : wirfevo
    System : wirfevo
    New installation mechanism detected wirfevo
    create service lrc
    create service mqtt
    create service node-red
    create service tao
    Keros system setting
    trying to set UUID 7076FF-7076FF05179F in FDB_lora
    UUID 7076FF-7076FF05179F in FDB_lora is set
    /user/actility/lrc/keyencrypt/keyencrypt.x: /user/actility/lrr/keros_addon/lib/libcrypto.so.1.0.0: no version information available (required by /user/actility/lrc/keyencrypt/keyencrypt.x)
    /user/actility/lrc/keyencrypt/keyencrypt.x: /user/actility/lrr/keros_addon/lib/libcrypto.so.1.0.0: no version information available (required by /user/actility/lrr/keros_addon/lib/libssl.so.1.0.0)
    /user/actility/lrc/keyencrypt/keyencrypt.x: /user/actility/lrr/keros_addon/lib/libcrypto.so.1.0.0: no version information available (required by /user/actility/lrr/keros_addon/lib/libssl.so.1.0.0)
    /user/actility/lrc/keyencrypt/keyencrypt.x: /user/actility/lrr/keros_addon/lib/libcrypto.so.1.0.0: no version information available (required by /user/actility/lrr/keros_addon/lib/libssl.so.1.0.0)
    /tmp/selfextract.WQ8Qx2
    migrateScript=/user/actility/tao-system/bootstrap/migrate-from-none.sh
    /user/actility used as root directory
    System : wirfevo
    restart service lrc
    Stopping lrc.x service: [FAILED]
    lrc.x is already stopped
    Starting lrc.x service: wirfevo
    [OK]
    restart service mqtt
    Stopping mosquitto service: [FAILED]
    mosquitto is already stopped
    Starting mosquitto service: wirfevo
    [OK]
    restart service node-red
    Stopping node-red service: [FAILED]
    node-red is already stopped
    Starting node-red service: wirfevo
    [OK]
    restart service tao
    Stopping tao-server service: [FAILED]
    tao-server is already stopped
    Starting tao-server service: wirfevo
    [OK]
    System configuration done
    Stopping lrr service: [OK]
    Starting lrr service: wirfevo
    no command to power on radio board
    Analyze calibration file ...
    File /user/actility/usr/etc/lrr/lowlvlgw.ini created
    Updating /user/actility/usr/etc/lrr/versions.ini file
    /user/actility/usr/etc/lrr/versions.ini file updated
    [OK]
    Installation done
  3. You can now reboot the gateway.