Skip to content

Commit

Permalink
Cleanup the 'Software' page.
Browse files Browse the repository at this point in the history 
Signed-off-by: Volker Theile <votdev@gmx.de>
(cherry picked from commit 72bb699)
Signed-off-by: Volker Theile <votdev@gmx.de>
  • Loading branch information
@votdev
votdev committed Oct 13, 2022
1 parent a3a0706 commit 3744307
Showing 1 changed file with 43 additions and 60 deletions.
103 changes: 43 additions & 60 deletions various/apt.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,58 +4,64 @@ Software
Overview
--------

|omv| is a Debian based distribution. It uses apt to install packages. All
|omv| is a Debian based distribution. It uses APT to install packages. All
standard Debian packages are upgraded using the official Debian mirrors. |omv|
packages are upgraded using the http://packages.openmediavault.org repository.
packages are upgraded using the https://packages.openmediavault.org repository.

Update Manager
--------------

The update manager displays all available packages for upgrade. You can select
them if you want to do individual or mass upgrade. The server uses cron-apt to
perform a daily apt-get update and fetch upgrade packages automatically. If you
have notifications enabled you receive an email every time packages are ready
for install.
them if you want to do individual or mass upgrade. The server uses ``cron-apt`` to
perform a daily ``apt-get update`` and fetch upgrade packages automatically. If you
have notifications enabled you will receive an email every time packages are ready
for installation.

Using CLI
---------

**apt-get**

If you want to update/upgrade in the console you can use ``apt-get update`` then
``apt-get upgrade``.
If you want to update/upgrade in the console you can use ``apt-get update``
then ``apt-get upgrade``.

**omv-upgrade**

This is wrapper script that basically executes::

$ apt-get update && apt-get upgrade

The full command is::

$ apt-get update && apt-get –yes –force-yes –fix-missing –auto-remove –allow-unauthenticated –show-upgraded –option DPkg::Options::=“–force-confold” dist-upgrade
This is non-interactive wrapper script that basically re-synchronizes the
package index files from their sources and installs the newest versions of
all packages currently installed on the system from the sources.

**omv-release-upgrade**

This is a script included only in the last versions of |omv| before moving to
next major release version. For example: 0.5.60 to 1.x or 1.19 to 2.x. The
command performs several tasks and modifications depending if the upgrade
includes moving to a new base distribution. For example: Debian Squeeze to
Wheezy or Wheezy to Jessie,
This is a script which is included only in the last versions of |omv|
before moving to the next major release version, e.g. 5.6.x to 6.x.
This command migrates the system to the next major |omv| version
(which mostly includes a Debian distribution upgrade as well).

Installing plugins
------------------

The plugins can installed either by repository selecting from the available
list or uploading the deb package. If the plugin requires some extra software
it will fetch all remaining packages from either Debian mirrors or another
repo the plugin specifies.
Plugins can be installed via the |webui| or CLI. If the plugin requires
some extra software, the Debian package management will fetch all
dependencies from the configured Debian package repositories.

Installing Software
-------------------

You have to your availability all Debian software repository to install in
your server
You can install all software available in the Debian repositories on your
server.

.. warning::
Please note that the installation of additional software may impair
or prevent the functionality of |omv|. This includes especially the
installation of newer Python package versions via PIP which have
already been installed via APT. Also, please do not install packages
from Debian ``Backports``, ``Testing`` or ``Experimental`` repositories,
as this may install incompatible package versions. |omv| is strictly
tied to the Debian version it is based on.

Better use a container based solution to install additional software
to do not affect the |omv| operating system.

**Install**::

Expand All @@ -74,42 +80,19 @@ Repositories

**Debian**

The OS repositories are in this file ``/etc/apt/sources.list``. The default
contents are:

|omv| 2.0 (Wheezy)::

deb http://ftp.us.debian.org/debian wheezy main contrib non-free
deb http://ftp.debian.org/debian/ wheezy-updates main contrib non-free
deb http://security.debian.org/ wheezy/updates main contrib non-free


|omv| 3.0 (Jessie)::

deb http://ftp.us.debian.org/debian jessie main contrib non-free
deb http://ftp.debian.org/debian/ jessie-updates main contrib non-free
deb http://security.debian.org/ jessie/updates main contrib non-free

|omv| 4.0 (Stretch)::

deb http://ftp.us.debian.org/debian stretch main contrib non-free
deb http://ftp.debian.org/debian/ stretch-updates main contrib non-free
deb http://security.debian.org/ stretch/updates main contrib non-free

The above repositories point directly to US servers. Since Debian Wheezy now is possible to use
the redirector address, you only need to change the codename release. The redirector
finds the closest mirror automatically. This is can be used as default for Debian Stretch::

deb http://deb.debian.org/debian/ stretch main contrib non-free
deb http://deb.debian.org/debian/ stretch-updates main contrib non-free
deb http://deb.debian.org/debian-security stretch/updates main contrib non-free

The OS repositories are in this file ``/etc/apt/sources.list``.

**External**

Debian provides the :file:`/etc/apt/sources.d/` folder for adding external
repositories. If there is need to add a repository from a testing or unstable
Debian just to install recent software make sure the packages are properly pinned [1]_
to avoid the system becoming unstable for adding core unsupported software by mistake.
Debian provides the :file:`/etc/apt/sources.list.d/` folder for adding external
repositories. The configuration files for the |omv| package repositories
are located here.

.. warning::
If there is a strong need to add the ``Backports``, ``Testing`` or
``Experimental`` Debian repository just to install the most recent
software, then please ensure that these packages are properly pinned
[1]_ to avoid the system becoming unstable for adding core unsupported
software by mistake.

.. [1] https://wiki.debian.org/AptPreferences

0 comments on commit 3744307

Please sign in to comment.