User Tools

Site Tools


Differences

This shows you the differences between two versions of the page.

Link to this comparison view

en:howto:installation [2016/10/10 16:19] (current)
astastna created
Line 1: Line 1:
 +====== Installation and reinstallation of packages ======
  
 +Manual installation of packages might be needed when you're make a service to work on Turris Omnia. Reinstallation might be needed in case of technical problems.
 +
 +===== Before installation =====
 +
 +Before you install a package, please keep in mind the following:
 +
 +  * Don't install everything just because you can. The more software is installed on the router, the greater is the chance of serious security problem occurring on your router. Every software has bugs, smaller or larger, and every one can be potentially discovered and misused by an attacker.
 +
 +  * Pay attention when uninstalling a package and make sure that no other program needs it any more. Uninstalling a package might lead to a loss of key functionality of the router.
 +
 +<WRAP center info 60%>
 +Once per 12 hours the versions of all installed packages are checked and if there is a newer version available, it is installed. ​
 +</​WRAP>​
 +
 +===== Through LuCI interface =====
 +
 +Here we describe installation and reinstallation of packages through the LuCI interface. This option is recommended for less experienced users. ​
 +
 +==== Installation ====
 +
 +  * Open the section //System// → //​Software//​.
 +  * Start by clicking the button ''​Update lists''​. Then the list of available packages gets updated. ​
 +  * Switch to the tab //Available packages//.
 +  * Find the requested package on this page. You can either use the filer or or alphabetical list.
 +  * After finding the requested package, click ''​Install''​ to get it installed. The log in the upper part of the screen will inform you about the progress of the installation. ​
 +
 +==== Reinstallation ====
 +
 +Unlike the command line program ''​opkg'',​ LuCI interface doesn'​t have a direct way to reinstall a package. To reinstall the package, you'll need to uninstall it first and then install it again. ​
 +
 +  * Open the section //System// → //​Software//​
 +  * In the tab //Installed packages// (which should be already opened) choose the package to remove / reinstall and click ''​Remove ''​.
 +  * Then install the package again according to [[en:​howto:​installation#​through_luci_interface|this manual]].
 +
 +===== Through root terminal =====
 +
 +Get access the command line with root privileges first. The instructions can be found [[en:​howto:​ssh|here]].
 +
 +==== Installation ====
 +<WRAP center info 60%>
 +You'll be calling the ''​opkg''​ command in this section. It is good to know that by calling this command on Turris Omnia, you don't actually call the real opkg command directly. Instead, a script is run which calls the actual opkg and then adds the installed package to the list of packages to be updated. However, it makes no difference in most cases.
 +</​WRAP>​
 +
 +
 +Update the list of available packages with command <​code>​
 +opkg update
 +</​code>​
 +Then install the package by typing <​code>​
 +opkg install name_of_the_package
 +</​code>​
 +
 +==== Reinstallation ====
 +Update the list of available packages with command <​code>​ opkg update </​code>​
 +Then reinstall the package by typing <​code>​ opkg install --force-reinstall name_of_the_package </​code>​
 +
 +==== Option for more advanced users ====
 +The original ''​opkg''​ command only installs or removes the package. However, there'​s also the updater, which keeps the packages it knows about up to date (and removes any it thinks are not necessary). The wrapper script mentioned above also adds installed packages to ''/​etc/​updater/​auto.lua'',​ or removes them on removal.
 +
 +There'​s a similar file, ''/​etc/​updater/​user.lua'',​ which is meant to be edited by the user. As an alternative mean, you may add the packages you want installed there and call '​updater.sh'',​ which would install them.