Template:Networking rut manual package manager: Difference between revisions

Revision as of 17:10, 31 October 2019

Summary

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

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

Installed

The Installed section displays the names version numbers of software packages currently installed on the router. To remove an installed package click the 'Remove' button located next to it.

Below is an example of the Installed section with the zerotier package installed.

[[File:{{{file_installed}}}]]

Upgradable

The Upgradable section displays available upgrades for installed packages. Based on the availability of additional software in the current firmware version ({{{fw_version}}}), all packages in the [[{{{name}}}_Packages#Available|Available]] section are their latest version. Therefore, the Upgradable section currently displays an empty list:

[[File:{{{file_upgradable}}}]]

Available

The Available section displays packages that are available to be downloaded from the FOTA server. Currently available packages are:

zerotier - ZeroTier One is 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.
snmpd - 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.
miniupnpd - 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.
easycwmp - installs TR-069 (Technical Report 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.
azure_iothub - Azure IoT Hub is 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.

To install an additional software package, click the 'Install' button located next to it:

[[File:{{{file_available}}}]]

If the installation was successful, you should see a green rounded rectangle containing a message of success appear above the package list:

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

Pending

The Pending section displays software packages that are still awaiting installation.

[[File:{{{file_pending}}}]]

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}}} is provided below. Click on the links if you wish to download the packages to your computer.

To install a package click the 'Browse...' 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: 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}}}_Packages#Available|Available]] section of this Wiki page and related configuration guides can be found in the [[{{{name}}}_Packages#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>
```

@@ Line 2: / Line 2: @@
 ==Summary==
-This page is an overview of the <b>Packages</b> 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 Packages section in {{{name}}} routers.
 {{Template: Networking_rutxxx_manual_fw_disclosure
@@ Line 8: / Line 8: @@
 }}
-==Package Manager==
+==Installed==
-The <b>Package Manager</b> is a service used to install, upgrade or remove additional software.
-===Installed===
-----
 The <b>Installed</b> section displays the names version numbers of software packages currently installed on the router. To remove an installed package click the 'Remove' button located next to it.
@@ Line 20: / Line 16: @@
 [[File:{{{file_installed}}}]]
-===Upgradable===
+==Upgradable==
-----
 The <b>Upgradable</b> section displays available upgrades for installed packages. Based on the availability of additional software in the current firmware version ({{{fw_version}}}), all packages in the [[{{{name}}}_Packages#Available|Available]] section are their latest version. Therefore, the Upgradable section currently displays an empty list:
 [[File:{{{file_upgradable}}}]]
-===Available===
+==Available==
-----
-Available additional software packages for {{{name}}} routers with FW version [[Media:{{{fw_version}}}_WEBUI.bin|{{{fw_version}}}]] are listed below.
+The <b>Available</b> section displays packages that are available to be downloaded from the FOTA server. Currently available packages are:
 <ul>
@@ Line 47: / Line 43: @@
 [[File:{{{file_success}}}]]
-===Pending===
+==Pending==
-----
 The <b>Pending</b> section displays software packages that are still awaiting installation.
 [[File:{{{file_pending}}}]]
-===Upload===
+==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.
@@ Line 62: / Line 58: @@
 {{Template: Networking_rutxxx_manual_packages_supported
-| zerotier  = {{{zerotier}}}
+| zerotier   = {{{zerotier}}}
-| snmpd     = {{{snmpd}}}
+| snmpd      = {{{snmpd}}}
-| samba     = {{{samba}}}
+| samba      = {{{samba}}}
-| miniupnpd = {{{miniupnpd}}}
+| miniupnpd  = {{{miniupnpd}}}
-| easycwmp  = {{{easycwmp}}}
+| easycwmp   = {{{easycwmp}}}
-| azure     = {{{azure}}}
+| azure      = {{{azure}}}
+| cumulocity = {{{cumulocity}}}
+| thingworx  = {{{thingworx}}}
 }}
 ----
@@ Line 73: / Line 71: @@
 [[File:{{{file_success}}}]]
+==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> 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}}}_Packages#Available|Available]]</b> section of this Wiki page and related configuration guides can be found in the <b>[[{{{name}}}_Packages#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 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>
+==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}}} WebUI]]