Difference between revisions of "Template:Networking rut manual package manager"

From Teltonika Networks Wiki
(28 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Template: Networking_rutxxx_manual_fw_disclosure
 
| fw_version = {{#switch: {{{series}}}
 
  | RUT2XX = {{{series}}}_R_00.01.14.3
 
  | RUT9XX = {{{series}}}_R_00.06.08.2}}
 
}}
 
 
__TOC__
 
__TOC__
 
==Summary==
 
==Summary==
  
 
The <b>Package Manager</b> is a service used to install additional software on the the device. This page is an overview of the Package Manager section in {{{name}}} routers.
 
The <b>Package Manager</b> is a service used to install additional software on the the device. This page is an overview of the Package Manager section in {{{name}}} routers.
 +
 +
{{Template: Networking_rutxxx_manual_fw_disclosure
 +
| fw_version = {{{fw_version}}}
 +
}}
  
 
==Packages==
 
==Packages==
Line 17: Line 16:
 
===Available packages===
 
===Available packages===
 
----
 
----
Available additional software packages for {{{name}}} routers are listed below.
+
Available additional software packages for {{{name}}} routers with FW version <b>[[Media:{{{fw_version}}}_WEBUI.bin|{{{fw_version}}}]]</b> are listed below.
  
 
<ul>
 
<ul>
     <li><b>Azure IoThub</b> - an open and flexible cloud platform that supports open-source SDKs and multiple protocols. <br>After installation, this service becomes available and can be configured from the <b>Services → IoT Platforms → Azure IoThub</b> page.</li>
+
     <li><b>TR-069</b> - Technical Report 069 (TR-069) client, an application layer protocol designed for management of equipment connected to a remote network.<br>After installation, this service becomes available and can be configured from the <b>Services → [[{{{name}}} TR-069|TR-069]]</b> page.</li>
     <li><b>Cloud of Things</b> - a cloud platform for the Internet of Things. It allows you to remotely monitor, manage and control your connected devices and machines. <br>After installation, this service becomes available and can be configured from the <b>Services → IoT Platforms → Cloud of Things</b> page.</li>
+
     <li><b>ThingWorx</b> -an industrial innovation platform designed to rapidly deliver IoT applications.<br>After installation, this service becomes available and can be configured from the <b>Services → IoT Platforms → [[{{{name}}} IoT_Platforms#ThingWorx|ThingWorx]]</b> page.</li>
     <li><b>Cumulocity</b> - an independent device and application management Internet of Things (IoT) platform. <br>After installation, this service becomes available and can be configured from the <b>Services → IoT Platforms → Cumulocity</b> page.</li>
+
     <li><b>Cumulocity</b> - an independent device and application management Internet of Things (IoT) platform.<br>After installation, this service becomes available and can be configured from the <b>Services → IoT Platforms → [[{{{name}}} IoT_Platforms#Cumulocity|Cumulocity]]</b> page.</li>
     <li><b>SNMP</b> - Simple Network Management Protocol (SNMP) is a network management protocol used to collect information from network devices. <br>After installation, this service becomes available and can be configured from the <b>Services → [[{{{name}}} SNMP|SNMP]]</b> page.</li>
+
     <li><b>ZeroTier</b> - an open source software product which establishes Peer to Peer VPN (P2PVPN) connection between laptops, desktops, phones, embedded devices, cloud resources, and apps.<br>After installation, this service becomes available and can be configured from the <b>Services → VPN → [[{{{name}}} VPN#ZeroTier|ZeroTier]]</b> page.</li>
     <li><b>ThingWorx</b> -an industrial innovation platform designed to rapidly deliver IoT applications. <br>After installation, this service becomes available and can be configured from the <b>Services → IoT Platforms → ThingWorx</b> page.</li>
+
     <li><b>SNMP</b> - Simple Network Management Protocol (SNMP) is a network management protocol used to collect information from network devices.<br>After installation, this service becomes available and can be configured from the <b>Services → [[{{{name}}} SNMP|SNMP]]</b> page.</li>
    <li><b>TR-069</b> - Technical Report 069 (TR-069) client, an application layer protocol designed for management of equipment connected to a remote network. <br>After installation, this service becomes available and can be configured from the <b>Services → TR-069</b> page.</li>
 
 
     <li><b>UPNP</b> - UPNP (Universal Plug and Play) is a set of network protocols that allows devices in a network to discover one another automatically.br>After installation, this service becomes available and can be configured from the <b>Services → [[{{{name}}} UPNP|UPNP]]</b> page.</li>
 
     <li><b>UPNP</b> - UPNP (Universal Plug and Play) is a set of network protocols that allows devices in a network to discover one another automatically.br>After installation, this service becomes available and can be configured from the <b>Services → [[{{{name}}} UPNP|UPNP]]</b> page.</li>
     <li><b>WireGuard</b> - a fast, modern, simple and secure VPN tunnel. <br>After installation, this VPN becomes available and can be configured from the <b>Services → VPN → WireGuard</b> page.</li>
+
     <li><b>Azure IoThub</b> - an open and flexible cloud platform that supports open-source SDKs and multiple protocols.<br>After installation, this service becomes available and can be configured from the <b>System Administration → [[{{{name}}} _Administration#Azure_IoThub|Azure IoThub]]</b> page.</li>
    <li><b>ZeroTier</b> - an open source software product which establishes Peer to Peer VPN (P2PVPN) connection between laptops, desktops, phones, embedded devices, cloud resources, and apps.<br>After installation, this service becomes available and can be configured from the <b>Services VPN → [[{{{name}}} VPN#ZeroTier|ZeroTier]]</b> page.</li>
 
 
</ul>
 
</ul>
  
 
==Upload==
 
==Upload==
  
The <b>Upload</b> section provides the possibility for offline package installation.  
+
The <b>Upload</b> section provides the possibility for offline package installation. Only packages that are intended for this specific router and firmware version can be uploaded.  
Only packages that are intended for this specific router and firmware version can be uploaded.
 
The list of available packages for {{{name}}} routers is provided in the <strong>[[{{{name}}} Package Downloads|Package Downloads]]</strong> page.  
 
  
 
[[File:{{{file_upload}}}]]
 
[[File:{{{file_upload}}}]]
 
 
----
 
----
To install a package click the 'Choose File...' button and locate the package  
+
<!--RUT2-->
file on your computer. Then click 'Install package' and you will be redirected
+
The list of available packages for {{{name}}} routers with FW version [[Media:{{{fw_version}}}_WEBUI.bin|{{{fw_version}}}]] is provided below. Click on the links if you wish to download the packages to your computer.
to Verification page. If you proceed with installation and successfully install
+
{{#ifeq:{{{series}}}|RUT9xx||{{Networking_rutxxx_manual_packages_supported
the package, you should see a message of success:
+
| zerotier  = {{{zerotier | Zerotier}}}
 +
| snmpd      = {{{snmpd}}}
 +
| samba      = {{{samba}}}
 +
| miniupnpd  = {{{miniupnpd}}}
 +
| easycwmp  = {{{easycwmp}}}
 +
| cotStream  = {{{cotStream}}}
 +
| azure      = {{{azure}}}
 +
| cumulocity = {{{cumulocity}}}
 +
| thingworx  = {{{thingworx}}}
 +
}}}}
 +
<!--RUT9-->
 +
{{#ifeq:{{{series}}}|RUT2xx||{{Networking_rutxxx_manual_packages_supported
 +
| rut9xx_zerotier  = {{{rut9xx_zerotier}}}
 +
| rut9xx_snmpd      = {{{rut9xx_snmpd}}}
 +
| rut9xx_samba      = {{{rut9xx_samba}}}
 +
| rut9xx_miniupnpd  = {{{rut9xx_miniupnpd}}}
 +
| rut9xx_easycwmp  = {{{rut9xx_easycwmp}}}
 +
| rut9xx_cotStream  = {{{rut9xx_cotStream}}}
 +
| rut9xx_azure      = {{{rut9xx_azure}}}
 +
| rut9xx_cumulocity = {{{rut9xx_cumulocity}}}
 +
| rut9xx_thingworx  = {{{rut9xx_thingworx}}}
 +
}}}}
 +
{{#ifeq:{{{series}}}|RUT9xx|The list of available packages for {{{name}}} routers with <b>older FW version</b> [[Media:RUT9XX R 00.06.04 WEBUI.bin|RUT9XX_R_00.06.04]] up to version [[Media:{{{fw_version}}}_WEBUI.bin|{{{fw_version}}}]] is provided below:}}
 +
<!--RUT9 old-->
 +
{{#ifeq:{{{series}}}|RUT2xx||{{Networking_rutxxx_manual_packages_supported
 +
| rut9xx_zerotier_old  = {{{rut9xx_zerotier_old}}}
 +
| rut9xx_snmpd_old      = {{{rut9xx_snmpd_old}}}
 +
| rut9xx_samba_old      = {{{rut9xx_samba_old}}}
 +
| rut9xx_miniupnpd_old  = {{{rut9xx_miniupnpd_old}}}
 +
| rut9xx_easycwmp_old  = {{{rut9xx_easycwmp_old}}}
 +
| rut9xx_azure_old      = {{{rut9xx_azure_old}}}
 +
| rut9xx_cumulocity_old = {{{rut9xx_cumulocity_old}}}
 +
| rut9xx_thingworx_old  = {{{rut9xx_thingworx_old}}}
 +
}}}}
 +
----
 +
To install a package click the 'Choose File...' button and locate the package file on your computer. Then click 'Install package'. If the installation was successful, you should see a green rounded rectangle containing a message of success appear Package Manager title:
  
 
[[File:{{{file_success}}}]]
 
[[File:{{{file_success}}}]]
 
Click 'Install package' and you will be redirected to package verification page.
 
 
==Verification==
 
 
When trying to install a package by either downloading it in Packages page or
 
uploading it in Upload page you will be informed whether this package is
 
Authorized - digitaly signed by Teltonika Networks, or Unauthorized - without
 
digital signature. After that you will be able to proceed with installation or cancel it.
 
 
Below are pictures representing Authorized and Unauthorized packages respectively.
 
 
[[File:Networking_rut9_manual_package_manager_authorized_package.png|border|class=tlt-border]]
 
 
[[File:Networking_rut9_manual_package_manager_unauthorized_package.png|border|class=tlt-border]]
 
 
==Custom package upload==
 
 
If you want to use your own packages and '''upload''' them to {{{name}}} via the Package Manager, you need to follow these instructions:
 
----
 
I. You need to use following name for you package in order to use/upload it via package manager, the name and format should be:
 
 
* '''tlt_custom_pkg_<''anyname''>.ipk'''
 
 
II. You need to add following information to your package before you compile it:
 
 
* '''PKG_ROUTER:=<''Router''>'''
 
 
* '''PKG_FIRMWARE:=<''Routers firmware version''>'''
 
 
* '''PKG_TLT_NAME:=<''anything, could be name of the package''>'''
 
 
* '''PKG_VERSION_PM:=<''anything, could be package version''>'''
 
----
 
For example:
 
 
* ''tlt_custom_pkg_Test.ipk''
 
 
* ''PKG_ROUTER:=RUT9''
 
 
* ''PKG_FIRMWARE:=06.06.0''
 
 
* ''PKG_TLT_NAME:=Test''
 
 
* ''PKG_VERSION_PM:=1.0''
 
 
After you compile it you should be able to upload the package via package manager.
 
  
 
==FAQ==
 
==FAQ==
Line 113: Line 95:
 
<ul>
 
<ul>
 
     <li><b>Q:</b> The package that I want isn't on the list. Can I install it anyway?</li>
 
     <li><b>Q:</b> The package that I want isn't on the list. Can I install it anyway?</li>
     <li><b>A:</b> Depends on what you need specifically. More packages can be downloaded using the <b>opkg package manager</b>. It is a [[Command line interfaces|command-line]] utility used to download software from special online repositories.<br>Before using <i>opkg</i> you should first update the list of available packages by executing this command: <pre>opkg update</pre>To see a list of available packages, use this command:<pre>opkg list</pre>To install a package, use this syntax: <pre>opkg install <PACKAGE_NAME></pre></li>
+
     <li><b>A:</b> Depends on what you specifically need. More packages can be downloaded using the <b>opkg package manager</b>. It is a [[Command line interfaces|command-line]] utility used to download software from special online repositories.<br>Before using <i>opkg</i> you should first update the list of available packages by executing this command: <pre>opkg update</pre>To see a list of available packages, use this command:<pre>opkg list</pre>To install a package, use this syntax: <pre>opkg install <PACKAGE_NAME></pre></li>
 
</ul>
 
</ul>
  
Line 129: Line 111:
 
</ul>
 
</ul>
  
[[Category:{{{name}}} System section]]
+
[[Category:{{{name}}} WebUI]]

Revision as of 14:47, 19 November 2019

Summary

The Package Manager is a service used to install additional software on the the device. This page is an overview of the Package Manager section in {{{name}}} routers.

The information in this page is updated in accordance with the [[Media:{{{fw_version}}}_WEBUI.bin|{{{fw_version}}}]] firmware version.

Packages

The Packages section provides the possibility to install additional software packages that are available for download from the FOTA server. To install a new service, locate the necessary package in the list and click the 'Install' button adjacent to it.

[[File:{{{file_packages}}}]]

Available packages


Available additional software packages for {{{name}}} routers with FW version [[Media:{{{fw_version}}}_WEBUI.bin|{{{fw_version}}}]] are listed below.

  • TR-069 - Technical Report 069 (TR-069) client, an application layer protocol designed for management of equipment connected to a remote network.
    After installation, this service becomes available and can be configured from the Services → [[{{{name}}} TR-069|TR-069]] page.
  • ThingWorx -an industrial innovation platform designed to rapidly deliver IoT applications.
    After installation, this service becomes available and can be configured from the Services → IoT Platforms → [[{{{name}}} IoT_Platforms#ThingWorx|ThingWorx]] page.
  • Cumulocity - an independent device and application management Internet of Things (IoT) platform.
    After installation, this service becomes available and can be configured from the Services → IoT Platforms → [[{{{name}}} IoT_Platforms#Cumulocity|Cumulocity]] page.
  • ZeroTier - an open source software product which establishes Peer to Peer VPN (P2PVPN) connection between laptops, desktops, phones, embedded devices, cloud resources, and apps.
    After installation, this service becomes available and can be configured from the Services → VPN → [[{{{name}}} VPN#ZeroTier|ZeroTier]] page.
  • SNMP - Simple Network Management Protocol (SNMP) is a network management protocol used to collect information from network devices.
    After installation, this service becomes available and can be configured from the Services → [[{{{name}}} SNMP|SNMP]] page.
  • UPNP - UPNP (Universal Plug and Play) is a set of network protocols that allows devices in a network to discover one another automatically.br>After installation, this service becomes available and can be configured from the Services → [[{{{name}}} UPNP|UPNP]] page.
  • Azure IoThub - an open and flexible cloud platform that supports open-source SDKs and multiple protocols.
    After installation, this service becomes available and can be configured from the System → Administration → [[{{{name}}} _Administration#Azure_IoThub|Azure IoThub]] page.

Upload

The Upload section provides the possibility for offline package installation. Only packages that are intended for this specific router and firmware version can be uploaded.

[[File:{{{file_upload}}}]]


The list of available packages for {{{name}}} routers with FW version [[Media:{{{fw_version}}}_WEBUI.bin|{{{fw_version}}}]] is provided below. Click on the links if you wish to download the packages to your computer.


To install a package click the 'Choose File...' button and locate the package file on your computer. Then click 'Install package'. If the installation was successful, you should see a green rounded rectangle containing a message of success appear Package Manager title:

[[File:{{{file_success}}}]]

FAQ

  • Q: How to keep installed packages after firmware upgrade?
  • A: Before upgrading the device's firmware, make sure the 'Keep all settings' option is checked in the [[{{{name}}} Firmware|Firmware]] page. This ensures that the router will install the necessary packages after FW upgrade and keep user configuration data.
    [[File:{{{file_keep_settings}}}]]

  • Q: Is there enough space for packages that I want to install?
  • A: The size of each package is displayed next to its version in the package list. The current state of Free/Total memory usage is displayed in in the top-right corner of the list.
    [[File:{{{file_memory}}}]]

  • Q: I installed a software package, how do I configure it?
  • A: After the installation of a package, a related configuration page is generated somewhere in the WebUI, depending on the packages purpose. Information on where to find each page can be found in the [[{{{name}}}_Package_Manager#Available_packages|Available packages]] section of this Wiki page and related configuration guides can be found in the [[{{{name}}}_Package_Manager#See_also|See also]] section below.

  • Q: The package that I want isn't on the list. Can I install it anyway?
  • A: Depends on what you specifically need. More packages can be downloaded using the opkg package manager. It is a command-line utility used to download software from special online repositories.
    Before using opkg you should first update the list of available packages by executing this command:
    opkg update
    To see a list of available packages, use this command:
    opkg list
    To install a package, use this syntax:
    opkg install <PACKAGE_NAME>

See also

[[Category:{{{name}}} WebUI]]