View source for Template:Networking rut manual package manager

{{Template: Networking_rutxxx_manual_fw_disclosure
| fw_version = {{#switch: {{{series}}}
  | RUT2XX = {{{series}}}_R_00.01.12
  | RUT9XX = {{{series}}}_R_00.06.06}}
}}
__TOC__
==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.

{{Template: Networking_rutxxx_manual_fw_disclosure
| fw_version = {{{fw_version}}}
}}

==Packages==

The <b>Packages</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 and click the 'Install' button adjacent to it. 

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

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

<ul>
    <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>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 → [[{{{name}}} IoT_Platforms#Cumulocity|Cumulocity]]</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>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>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>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>
</ul>

==Upload==

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. 
The list of available packages for {{{name}}} routers is provided in the <strong>[[{{{name}}} Package Downloads|Package Downloads]]</strong> page. 

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

----
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}}}]]

==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==

<ul>
    <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 router will install the necessary packages after FW upgrade and keep user configuration data.<br>[[File:{{{file_keep_settings}}}]]</li>
</ul>
----
<ul>
    <li><b>Q:</b> Is there enough space for packages that I want to install?</li>
    <li><b>A:</b> 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.<br>[[File:{{{file_memory}}}]]</li>
</ul>
----
<ul>
    <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 and related configuration guides can be found in the <b>[[{{{name}}}_Package_Manager#See_also|See also]]</b> section below.</li>
</ul>
----
<ul>
    <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>
</ul>

==See also==

<ul>
    <li><b>Related configuration examples</b>
        <ul>
            <li>[[Azure_IoT_Hub_cloud_connection|Azure IoThub]]</li>
            <li>[[Cumulocity]]</li>
            <li>[[ThingWorx]]</li>
            <li>[[ZeroTier_One_VPN_configuration|ZeroTier]]</li>
        </ul>
    </li>
</ul>

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