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

From Teltonika Networks Wiki
(28 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
<!-- Template uses {{{name}}}, {{{series}}},  -->
 
<!-- Template uses {{{name}}}, {{{series}}},  -->
{{Template:Networking_rutos_manual_fw_disclosure
+
{{Template: Networking_rutos_manual_fw_disclosure
| fw_version = {{{series}}}_R_00.02.03
+
| fw_version = {{{series}}}_R_00.07.01}}
| series = {{{series}}}
+
| series     = {{{series}}}
 
}}
 
}}
 
+
{{#ifeq: {{{series}}} | RUT9 |<br><i><b>Note</b>: <b>[[{{{name}}} Package Manager (legacy WebUI)|click here]]</b> for the old style WebUI (FW version RUT9XX_R_00.06.08.3 and earlier) user manual page.</i>|}}
__TOC__
+
{{#ifeq: {{{series}}} | RUT2 |<br><i><b>Note</b>: <b>[[{{{name}}} Package Manager (legacy WebUI)|click here]]</b> for the old style WebUI (FW version RUT2XX_R_00.01.14.1 and earlier) user manual page.</i>|}}
 
 
 
==Summary==
 
==Summary==
  
Line 12: Line 11:
 
This page is an overview of the Package Manager section in {{{name}}} devices.
 
This page is an overview of the Package Manager section in {{{name}}} devices.
  
{{Template:Networking_rutos_manual_basic_advanced_webui_disclaimer}}
+
{{Template:Networking_rutos_manual_basic_advanced_webui_disclaimer
 +
| series = {{{series}}}
 +
}}
  
==Packages==
+
==Package Manager==
  
The <b>Packages</b> section provides the possibility to install additional software  
+
The <b>Package Manager</b> 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, click the '+' button adjacent to it.
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 '+' button adjacent to it.
 
  
[[File:Networking_rutx_manual_packages_overview_v1.png|border|class=tlt-border]]
+
<b>Note</b>: Package Manager in your device might show different available packages, the picture below is just for demonstration:
  
===Available packages===
+
[[File:Networking_rutos_manual_package_manager_packages.png|border|class=tlt-border]]
----
 
Available additional software packages for {{{name}}} devices with latest firmware version are listed below.
 
<ul>
 
{{#ifeq:{{{series}}}|RUTX|<li><b>Hotspot landing page default theme</b> - a default theme for landing page in Hotspot.<br>After installation, this theme becomes available in the Services → Hotspot → Landing 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. After installation, this service becomes available and can be configured from the Services → VPN → ZeroTier 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 Services → TR-069 page.</li>
 
    <li><b>The Cloud of Things</b> is 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 Services → Cloud Solutions → Cloud of Things 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 Services → Cloud Solutions → Azure IoT Hub 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 Services → Cloud Solutions → Cumulocity 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 Services → Cloud Solutions → ThingWorx page.</li>
 
    <li><b>NTPD</b> - a program that maintains the system time in synchronization with time servers using the Network Time Protocol.<br>After installation, this service becomes available and can be configured from the Services → NTP → NTPD page.</li>
 
</ul>
 
  
 
==Upload==
 
==Upload==
Line 42: Line 28:
 
Only packages that are intended for this specific device and firmware version can be uploaded.  
 
Only packages that are intended for this specific device and firmware version can be uploaded.  
  
[[File:Networking_rutXxx_manual_packages_upload_v2.png|border|class=tlt-border]]
+
The list of available packages for {{{name}}} devices with latest firmware version can be found
 +
in the [[{{{name}}} Package Downloads|Package Downloads]] page.
 +
 
 +
[[File:Networking_rutos_manual_package_manager_upload.png|border|class=tlt-border]]
 +
 
 +
To install a package click the 'Browse' button and locate the package file on your computer.
 +
Package should start uploading and a [[#Verification|Verification]] windows should soon appear.
 +
If you proceed with installation and successfully install the package, you should
 +
see a pop-up containing a message of success in the top side of your screen:
 +
 
 +
[[File:Networking_rutos_manual_package_manager_upload_success.png|border|class=tlt-border]]
 +
 
 +
==Verification==
  
The list of available packages for {{{name}}} devices with latest firmware version is provided below.  
+
When trying to install a package by uploading it
Click on the links if you wish to download the packages to your computer.
+
in [[#Upload|Upload]] page you will be informed whether this package is <b>Authorized</b> - digitaly signed by
 +
Teltonika Networks, or <b>Unauthorized</b> - without digital signature. After that you will be able to proceed
 +
with installation or cancel it.
  
<ul>
+
Below are pictures representing <b>Authorized</b> and <b>Unauthorized</b> packages respectively.
{{#switch:{{{series}}}
 
| RUTX =
 
    <li>[[Media:Networking_RUTXxx_manual_packages_zerotier_1.4.6.ipk|Zerotier]]</li>
 
    <li>[[Media:Networking_RUTXxx_manual_packages_easycwmp_1.8.4.ipk|TR-069]]</li>
 
    <li>[[Media:Networking_RUTXxx_manual_packages_cot_0.0.1.ipk|Cloud of Things]]</li>
 
    <li>[[Media:Networking_RUTXxx_manual_packages_azure_iothub_0.0.1.ipk|Azure IoT Hub]]</li>
 
    <li>[[Media:Networking_RUTXxx_manual_packages_cumulocity_0.0.1.ipk|Cumulocity]]</li>
 
    <li>[[Media:Networking_RUTXxx_manual_packages_thingworx_0.0.1.ipk|Thingworx]]</li>
 
| TRB14X =
 
    <li>[[Media:Networking_trb14x_manual_packages_ntpd_4.2.8p14.ipk|NTPD]]</li>
 
    <li>[[Media:Networking_trb14x_manual_packages_easycwmp_1.8.3.ipk|TR-069]]</li>
 
    <li>[[Media:Networking_trb14x_manual_packages_cot_0.0.1.ipk|Cloud of Things]]</li>
 
    <li>[[Media:Networking_trb14x_manual_packages_azure_iothub_0.0.1.ipk|Azure IoT Hub]]</li>
 
    <li>[[Media:Networking_trb14x_manual_packages_cumulocity_0.0.1.ipk|Cumulocity]]</li>
 
    <li>[[Media:Networking_trb14x_manual_packages_thingworx_0.0.1.ipk|Thingworx]]</li>
 
| TRB2XX =
 
    <li>[[Media:Networking_trb2xx_manual_packages_ntpd_4.2.8p14.ipk|NTPD]]</li>
 
    <li>[[Media:Networking_trb2xx_manual_packages_easycwmp_1.8.3.ipk|TR-069]]</li>
 
    <li>[[Media:Networking_trb2xx_manual_packages_cot_0.0.1.ipk|Cloud of Things]]</li>
 
    <li>[[Media:Networking_trb2xx_manual_packages_azure_iothub_0.0.1.ipk|Azure IoT Hub]]</li>
 
    <li>[[Media:Networking_trb2xx_manual_packages_cumulocity_0.0.1.ipk|Cumulocity]]</li>
 
    <li>[[Media:Networking_trb2xx_manual_packages_thingworx_0.0.1.ipk|Thingworx]]</li>
 
|}}
 
</ul>
 
  
To install a package click the 'Browse' button and locate the package file on your computer.  
+
[[File:Networking_rutos_manual_package_manager_authorized_package.png|border|class=tlt-border]]
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:Networking_rutx_manual_packages_success_v1.png|border|class=tlt-border]]
+
[[File:Networking_rutos_manual_package_manager_unauthorized_package.png|border|class=tlt-border]]
  
 
==FAQ==
 
==FAQ==
Line 83: Line 57:
 
<ul>
 
<ul>
 
     <li><b>Q:</b> How to keep installed packages after firmware upgrade?</li>
 
     <li><b>Q:</b> How to keep installed packages after firmware upgrade?</li>
     <li><b>A:</b> 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 device will install the necessary packages after FW upgrade and keep user configuration data.</li>
+
     <li><b>A:</b> Before upgrading the device's firmware, make sure the 'Keep settings' option is checked in the [[{{{name}}} Firmware|Firmware]] page. This ensures that the device will install the necessary packages after FW upgrade and keep user configuration data.</li>
 
</ul>
 
</ul>
  
[[File:Networking_rutx_manual_packages_faq_keep_settings_v3.png|border|class=tlt-border]]
+
[[File:Networking_rutos_manual_package_manager_faq_keep_settings.png|border|class=tlt-border]]
  
 
----
 
----
Line 95: Line 69:
 
     <li><b>A:</b> The size of each package is displayed next to its version in the package list. The current state of Flash memory is displayed in in the top-right corner of the list. Hover your mouse over it for more information.</li>
 
     <li><b>A:</b> The size of each package is displayed next to its version in the package list. The current state of Flash memory is displayed in in the top-right corner of the list. Hover your mouse over it for more information.</li>
 
</ul>
 
</ul>
[[File:Networking_rutx_manual_packages_faq_memory_v1.png|border|class=tlt-border]]
+
[[File:Networking_rutos_manual_package_manager_faq_memory.png|border|class=tlt-border]]
  
 
----
 
----
Line 102: Line 76:
 
<ul>
 
<ul>
 
     <li><b>Q:</b> I installed a software package, how do I configure it?</li>
 
     <li><b>Q:</b> I installed a software package, how do I configure it?</li>
     <li><b>A:</b> 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 <b>[[{{{name}}}_Package_Manager#Available_packages|Available packages]]</b> section of this Wiki page.</li>
+
     <li><b>A:</b> After the installation of a package, a related configuration page is generated somewhere in the WebUI, depending on the packages purpose. You can find a redirect to the configuration page by locating your package in the [[{{{name}}}_Services|Services]].</li>
 
</ul>
 
</ul>
  

Revision as of 10:49, 10 August 2021

Template:Networking rutos manual fw disclosure | series = {{{series}}} }}


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}}} devices.

If you're having trouble finding this page or some of the parameters described here on your device's WebUI, you should turn on "Advanced WebUI" mode. You can do that by clicking the "Advanced" button, located at the top of the WebUI.

Networking rutos manual webui basic advanced mode 75.gif

Package Manager

The Package Manager 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, click the '+' button adjacent to it.

Note: Package Manager in your device might show different available packages, the picture below is just for demonstration:

Networking rutos manual package manager packages.png

Upload

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

The list of available packages for {{{name}}} devices with latest firmware version can be found in the [[{{{name}}} Package Downloads|Package Downloads]] page.

Networking rutos manual package manager upload.png

To install a package click the 'Browse' button and locate the package file on your computer. Package should start uploading and a Verification windows should soon appear. If you proceed with installation and successfully install the package, you should see a pop-up containing a message of success in the top side of your screen:

Networking rutos manual package manager upload success.png

Verification

When trying to install a package by 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.

Networking rutos manual package manager authorized package.png

Networking rutos manual package manager unauthorized package.png

FAQ

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

Networking rutos manual package manager faq keep settings.png



  • 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 Flash memory is displayed in in the top-right corner of the list. Hover your mouse over it for more information.

Networking rutos manual package manager faq memory.png



  • 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. You can find a redirect to the configuration page by locating your package in the [[{{{name}}}_Services|Services]].




  • Q: The package that I want isn't on the list. Can I install it anyway?
  • A: Depends on what you need specifically. 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>

[[Category:{{{name}}} Services section]]