omv6:omv6_plugins:apt_tool [omv-extras.org]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
{{indexmenu_n>3}}
\\
<html><center><strong>Apt Tool For OMV6</strong></center></html>

{{ :omvextras_logo4.jpg?400 |}}

====== The APT tool Plugin For OMV6 ======
\\
\\

===== Summary =====

APT is a package management tool for software packages. Using it's core libraries, it facilitates the process of installation and uninstallation of Linux software packages and their dependencies. It is also used to maintain and upgrade installed packages.

The **APT tool** allows for user package management within the OMV GUI, with options to **List**, **Install**, **Remove**, **Hold**, and **UnHold** packages.  

===== Prerequisites =====

  * [[https://wiki.omv-extras.org/doku.php?id=misc_docs:omv_extras|OMV-Extras]] must be pre-installed.  


===== Installation =====

In OMV6's GUI:\\
Under **System**, **Plugins**, find and highlight **openmediavault-apttool 6.X**, and click the **install** button.

===== Useage =====

Under **Services**, **Apt Tool**, click on **Packages**.

In this instance, we're going to add a CLI utility call **htop**.  (''htop'' is a process viewer with many improvements over the installed ''top'' process viewer.  However ''htop'' is not in a standard Debian/OMV installation).\\
\\
----

<html><center>Click the <span style="color:#0099ff;font-size:150%;">+</span> button to add a new package.</center></html>  
<html><center>In the "<b>Add new package ...</b>" dialog, type <b>htop</b> in the <b>Package Name</b> field and click the <b>Add</b> button.</center></html>
\\
<html><center><b>htop</b> will appear under <b>Package Name</b>.</center></html>

{{ ::omv6-plugins_apt-01.jpg?800 |}}
\\
\\

<html><center>Click on <b>Wrench</b> tool icon above.  The following menu will pop up</center></html>

{{ ::omv6-plugins_apt-02.jpg?100 |}} 


<html><center>Select <b>Install</b>.  When the installation popup displays <b>End of Line</b>, <b>Close</b> the popup.</center></html>
<html><center>The status of <b>HTOP</b>, under <b>Installed</b>, will show <b>Yes</b> and the package version.</center></html>
\\
The remainder of the tools available:\\
**Remove** (Removes highlighted user installed package)\\
**Hold** (Places a hold on the highlighted user installed package.  This would prevent global commands like ''apt-get upgrade'' from upgrading the ''htop'' package.)\\
**Unhold** (Releases held packages allowing upgrades.)\\
\\
----

Under **System**, **Apt Tool**, **Search**:
\\
This page allows for searching Debian repositories for available packages.  In the search bar, a list of available packages are offered, interactively, with just a few typed characters.  When a unique sequence is typed in, the search narrows.
\\
{{ ::omv6-plugins_apt-03.jpg?800 |}}
\\
Highlight the desired package and the <html><span style="color:#0099ff;font-size:150%;">+</span></html> button.  This adds the selected package to the **Packages** page.  The package can be selected and installed from there.
----
\\
Under **System**, **Apt Tool**, **Installed**:
\\
The page displays all packages that are part of the installation, to include those that are user installed.  The search bar can be used, interactively, to find a specific package.

<html>
<body>
  <table width="100%" border="0">
    <tr>
      <td colspan="2" style="background-color:#FFB663;height:30px;">
        <strong><span style="color:#FFFFFF;font-size:110%;">&#160; Beginners Note </span></strong>
      </td>
    </tr>
    <tr>
      <td style="background-color:#FFE4A6;height:25px;width:380px;">
        Highlighting a package and indiscriminately clicking the <b>Remove</b> button may result in a broken installation.
    </tr>
  </table>
</body>
</html>

----

Under **System**, **Apt Tool**, **Hold**:

This page shows a list of packages that are being held.  Held packages can be released using the **Tool** menu, on the **Packages** page.

----

 











===== Source Code =====

-> [[https://github.com/OpenMediaVault-Plugin-Developers/openmediavault-apttool|Source Code]]

----
===== A Closing Note =====

We, who support the openmediavault project, hope you’ve found this guide to be useful and that you’ll find your openmediavault server to be efficient, easy to use, and enjoyable.\\
\\
If you found this plugin guide to be helpful, please consider a modest donation to support the hosting costs of this server.\\
\\
**OMV-Extras.org**
\\
<html>
<form action="https://www.paypal.com/cgi-bin/webscr" method="post" target="_top">
<input type="hidden" name="cmd" value="_s-xclick">
<input type="hidden" name="hosted_button_id" value="2BQNGSC8HQJME">
<input type="image" src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_SM.gif" name="submit" title="PayPal - The safer, easier way to pay online!" alt="Donate with PayPal button" border="0">
<img alt="" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1" border="0">
</form>
</html>
\\
\\
**Venmo: ryecoaaron** \\