"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "docs/manuals/source/IntroductionAndTutorial/InstallingBareos.rst" between
bareos-Release-20.0.0.tar.gz and bareos-Release-20.0.1.tar.gz

About: Bareos is a network based backup solution offering many different backup strategies (a fork of "Bacula").

InstallingBareos.rst  (bareos-Release-20.0.0):InstallingBareos.rst  (bareos-Release-20.0.1)
.. _InstallChapter: .. _InstallChapter:
Installing Bareos Installing Bareos
================= =================
:index:`\ <single: Bareos; Installing>`\ :index:`\ <single: Installation; Linux .. index::
>`\ pair: Bareos; Installation
pair: Installation; Linux
If you are like me, you want to get Bareos running immediately to get a feel for it, then later you want to go back and read about all the details. This chapter attempts to accomplish just that: get you going quickly without all the details . If you are like me, you want to get Bareos running immediately to get a feel for it, then later you want to go back and read about all the details. This chapter attempts to accomplish just that: get you going quickly without all the details .
Bareos comes prepackaged for a number of Linux distributions. So the easiest way to get to a running Bareos installation, is to use a platform where prepacked B areos packages are available. Additional information can be found in the chapter :ref:`Operating Systems <SupportedOSes>`. Bareos comes prepackaged for a number of Linux distributions. So the easiest way to get to a running Bareos installation, is to use a platform where prepacked B areos packages are available. Additional information can be found in the chapter :ref:`Operating Systems <SupportedOSes>`.
If Bareos is available as a package, only 4 steps are required to get to a runni ng Bareos system: If Bareos is available as a package, only 4 steps are required to get to a runni ng Bareos system:
#. #.
:ref:`section-AddSoftwareRepository` :ref:`section-AddSoftwareRepository`
skipping to change at line 37 skipping to change at line 39
:ref:`section-StartDaemons` :ref:`section-StartDaemons`
This will start a very basic Bareos installation which will regularly backup a d irectory to disk. In order to fit it to your needs, you’ll have to adapt the con figuration and might want to backup other clients. This will start a very basic Bareos installation which will regularly backup a d irectory to disk. In order to fit it to your needs, you’ll have to adapt the con figuration and might want to backup other clients.
.. _section-AddSoftwareRepository: .. _section-AddSoftwareRepository:
Decide about the Bareos release to use Decide about the Bareos release to use
-------------------------------------- --------------------------------------
- http://download.bareos.org/bareos/release/latest/ You’ll find Bareos binary package repositories at http://download.bareos.org/. T
he stable releases are available at http://download.bareos.org/bareos/release/.
You’ll find Bareos binary package repositories at http://download.bareos.org/. T
he latest stable released version is available at http://download.bareos.org/bar
eos/release/latest/.
The public key to verify the repository is also in repository directory (:file:` Release.key` for Debian based distributions, :file:`repodata/repomd.xml.key` for RPM based distributions). The public key to verify the repository is also in repository directory (:file:` Release.key` for Debian based distributions, :file:`repodata/repomd.xml.key` for RPM based distributions).
Section :ref:`section-InstallBareosPackages` describes how to add the software r epository to your system. Section :ref:`section-InstallBareosPackages` describes how to add the software r epository to your system.
.. _section-ChooseDatabaseBackend: .. _section-ChooseDatabaseBackend:
Decide about the Database Backend Decide about the Database Backend
--------------------------------- ---------------------------------
skipping to change at line 72 skipping to change at line 72
SQLite SQLite
.. deprecated:: 20.0.0 .. deprecated:: 20.0.0
This backend is for testing purposes only. This backend is for testing purposes only.
It is contained in package **bareos-database-sqlite3**. It is contained in package **bareos-database-sqlite3**.
**Do not use this in production.** **Do not use this in production.**
The Bareos database packages have their dependencies only to the database client packages, therefore the database itself must be installed manually. The Bareos database packages have their dependencies only to the database client packages, therefore the database itself must be installed manually.
If you do not explicitly choose a database backend, your operating system instal
ler will choose one for you. The default should be PostgreSQL, but depending on
your operating system and the already installed packages, this may differ.
.. _section-InstallBareosPackages: .. _section-InstallBareosPackages:
Install the Bareos Software Packages Install the Bareos Software Packages
------------------------------------ ------------------------------------
The package **bareos** is only a meta package which contains dependencies on the main components of Bareos, see :ref:`section-BareosPackages`. If you want to se tup a distributed environment (like one Director, separate database server, mult iple Storage daemons) you have to choose the regarding Bareos packages to instal l on each of the hosts instead of just installing the **bareos** package. The package **bareos** is only a meta package which contains dependencies on the main components of Bareos, see :ref:`section-BareosPackages`. If you want to se tup a distributed environment (like one Director, separate database server, mult iple Storage daemons) you have to choose the regarding Bareos packages to instal l on each of the hosts instead of just installing the **bareos** package.
The following code snippets are shell scripts that can be used as orientation ho w to download the package repositories and install bareos. The release version n umber for **bareos** and the corresponding Linux distribution have to be updated for your needs, respectively. The following code snippets are shell scripts that can be used as orientation ho w to download the package repositories and install bareos. The release version n umber for **bareos** and the corresponding Linux distribution have to be updated for your needs, respectively.
**See** http://download.bareos.org/bareos/release/ **for applicable releases and distributions.** **See** http://download.bareos.org/bareos/release/ **for applicable releases and distributions.**
Install on RedHat based Linux Distributions Install on RedHat based Linux Distributions
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
RHEL>7, CentOS>7, Fedora RHEL, CentOS, Fedora
^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^
:index:`\ <single: Platform; RHEL>`\ :index:`\ <single: Platform; CentOS>`\ :i .. index::
ndex:`\ <single: Platform; Fedora>`\ single: Platform; RHEL
single: Platform; CentOS
single: Platform; Fedora
Bareos :sinceVersion:`15.2.0: requires: jansson` requires the :ref:`Jansson libr ary <jansson>` package. On RHEL 7 it is available through the RHEL Server Option al channel. On CentOS 7 and Fedora is it included in the main repository. Bareos :sinceVersion:`15.2.0: requires: jansson` requires the :ref:`Jansson libr ary <jansson>` package. On RHEL 7 it is available through the RHEL Server Option al channel. On CentOS 7 and Fedora is it included in the main repository.
.. code-block:: shell-session .. code-block:: shell-session
:caption: Shell example script for Bareos installation on RHEL > 7 / CentOS > 7 / Fedora :caption: Shell example script for Bareos installation on RHEL 7 / CentOS 7 / Fedora
#!/bin/sh #!/bin/sh
# See http://download.bareos.org/bareos/release/ # See http://download.bareos.org/bareos/release/
# for applicable releases and distributions # for applicable releases and distributions
DIST=RHEL_8 DIST=RHEL_8
# or # or
# DIST=RHEL_7 # DIST=RHEL_7
# DIST=CentOS_8 # DIST=CentOS_8
# DIST=CentOS_7 # DIST=CentOS_7
# DIST=Fedora_30 # DIST=Fedora_33
# DIST=Fedora_32
# DIST=Fedora_31 # DIST=Fedora_31
RELEASE=release/19.2/ RELEASE=release/20
# or # RELEASE=experimental/nightly
# RELEASE=release/latest/
# RELEASE=experimental/nightly/
# add the Bareos repository
URL=http://download.bareos.org/bareos/$RELEASE/$DIST
wget -O /etc/yum.repos.d/bareos.repo $URL/bareos.repo
# install Bareos packages
yum install bareos bareos-database-postgresql
RHEL 6, CentOS 6
^^^^^^^^^^^^^^^^
:index:`\ <single: Platform; RHEL; 6>`\ :index:`\ <single: Platform; CentOS; 6>
`\
Bareos :sinceVersion:`15.2.0: requires: jansson` requires the :ref:`Jansson libr
ary <jansson>` package. This package is available on `EPEL <https://fedoraprojec
t.org/wiki/EPEL>`_ 6. Make sure, it is available on your system.
.. code-block:: shell-session
:caption: Shell example script for Bareos installation on RHEL > 6 / CentOS >
6
#!/bin/sh
# See http://download.bareos.org/bareos/release/
# for applicable releases and distributions
#
# add EPEL repository, if not already present.
# Required for the jansson package.
#
rpm -Uhv https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.r
pm
DIST=RHEL_6
# DIST=CentOS_6
RELEASE=release/19.2/
# or
# RELEASE=release/latest/
# RELEASE=experimental/nightly/
# add the Bareos repository # add the Bareos repository
URL=http://download.bareos.org/bareos/$RELEASE/$DIST URL=http://download.bareos.org/bareos/$RELEASE/$DIST
wget -O /etc/yum.repos.d/bareos.repo $URL/bareos.repo wget -O /etc/yum.repos.d/bareos.repo $URL/bareos.repo
# install Bareos packages # install Bareos packages
yum install bareos bareos-database-postgresql yum install bareos bareos-database-postgresql
Install on SUSE based Linux Distributions Install on SUSE based Linux Distributions
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
SUSE Linux Enterprise Server (SLES), openSUSE SUSE Linux Enterprise Server (SLES), openSUSE
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
:index:`\ <single: Platform; SLES>`\ :index:`\ <single: Platform; openSUSE>`\ .. index::
single: Platform; SLES
single: Platform; openSUSE
.. code-block:: shell-session .. code-block:: shell-session
:caption: Shell example script for Bareos installation on SLES / openSUSE :caption: Shell example script for Bareos installation on SLES / openSUSE
#!/bin/sh #!/bin/sh
# See http://download.bareos.org/bareos/release/ # See http://download.bareos.org/bareos/release/
# for applicable releases and distributions # for applicable releases and distributions
DIST=SLE_15_SP1 DIST=SLE_15_SP2
# or # or
# DIST=SLE_12_SP4 # DIST=SLE_12_SP5
# DIST=openSUSE_Leap_15.1 # DIST=openSUSE_Leap_15.2
RELEASE=release/19.2/ RELEASE=release/20
# or # or
# RELEASE=release/latest/ # RELEASE=experimental/nightly
# RELEASE=experimental/nightly/
# add the Bareos repository # add the Bareos repository
URL=http://download.bareos.org/bareos/$RELEASE/$DIST URL=http://download.bareos.org/bareos/$RELEASE/$DIST
zypper addrepo --refresh $URL/bareos.repo zypper addrepo --refresh $URL/bareos.repo
# install Bareos packages # install Bareos packages
zypper install bareos bareos-database-postgresql zypper install bareos bareos-database-postgresql
.. _section-InstallBareosPackagesDebian: .. _section-InstallBareosPackagesDebian:
Install on Debian based Linux Distributions Install on Debian based Linux Distributions
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Debian / Ubuntu Debian / Ubuntu
^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^
:index:`\ <single: Platform; Debian>`\ :index:`\ <single: Platform; Ubuntu>`\ .. index::
single: Platform; Debian
single: Platform; Ubuntu
Bareos :sinceVersion:`15.2.0: requires: jansson` requires the :ref:`Jansson libr ary <jansson>` package. On Ubuntu is it available in Ubuntu Universe. In Debian, is it included in the main repository. Bareos :sinceVersion:`15.2.0: requires: jansson` requires the :ref:`Jansson libr ary <jansson>` package. On Ubuntu is it available in Ubuntu Universe. In Debian, is it included in the main repository.
.. code-block:: shell-session .. code-block:: shell-session
:caption: Shell example script for Bareos installation on Debian / Ubuntu :caption: Shell example script for Bareos installation on Debian / Ubuntu
#!/bin/sh #!/bin/sh
# See http://download.bareos.org/bareos/release/ # See http://download.bareos.org/bareos/release/
# for applicable releases and distributions # for applicable releases and distributions
DIST=Debian_10 DIST=Debian_10
# or # or
# DIST=Debian_9.0 # DIST=Debian_9.0
# DIST=xUbuntu_20.04
# DIST=xUbuntu_18.04 # DIST=xUbuntu_18.04
# DIST=xUbuntu_16.04 # DIST=xUbuntu_16.04
RELEASE=release/19.2 RELEASE=release/20
# or # or
# RELEASE=release/latest
# RELEASE=experimental/nightly # RELEASE=experimental/nightly
URL=http://download.bareos.org/bareos/$RELEASE/$DIST URL=http://download.bareos.org/bareos/$RELEASE/$DIST
# add the Bareos repository # add the Bareos repository
printf "deb $URL /\n" > /etc/apt/sources.list.d/bareos.list wget -O /etc/apt/sources.list.d/bareos.list $URL/bareos.list
# add package key # add package key
wget -q $URL/Release.key -O- | apt-key add - wget -q $URL/Release.key -O- | apt-key add -
# install Bareos packages # install Bareos packages
apt-get update apt-get update
apt-get install bareos bareos-database-postgresql apt-get install bareos bareos-database-postgresql
If you prefer using the versions of Bareos directly integrated into the distribu tions, please note that there are some differences, see :ref:`section-DebianOrgL imitations`. If you use the versions of Bareos directly integrated into the distributions, pl ease note that there are some differences, see :ref:`section-DebianOrgLimitation s`.
Install on FreeBSD based Distributions Install on FreeBSD based Distributions
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
:index:`\ <single: Platform; FreeBSD>`\ :index:`\ <single: Platform; FreeBSD>`\ .. index::
single: Platform; FreeBSD
.. code-block:: shell-session .. code-block:: shell-session
:caption: Shell example script for Bareos installation on FreeBSD :caption: Shell example script for Bareos installation on FreeBSD
#!/bin/sh #!/bin/sh
# See http://download.bareos.org/bareos/release/ # See http://download.bareos.org/bareos/release/
# for applicable releases and distributions # for applicable releases and distributions
DIST=FreeBSD_12.1 DIST=FreeBSD_12.2
# or # or
# DIST=FreeBSD_12.0 # DIST=FreeBSD_12.1
# DIST=FreeBSD_11.3 # DIST=FreeBSD_11.4
RELEASE=release/19.2/ RELEASE=release/20
# or # or
# RELEASE=release/latest/ # RELEASE=experimental/nightly
# RELEASE=experimental/nightly/
URL=http://download.bareos.org/bareos/$RELEASE/$DIST URL=http://download.bareos.org/bareos/$RELEASE/$DIST
# add the Bareos repository # add the Bareos repository
cd /usr/local/etc/pkg/repos cd /usr/local/etc/pkg/repos
wget -q $URL/bareos.conf wget -q $URL/bareos.conf
# install Bareos packages # install Bareos packages
pkg install --yes bareos.com-director bareos.com-storage bareos.com-filedaemo n bareos.com-database-postgresql bareos.com-bconsole pkg install --yes bareos.com-director bareos.com-storage bareos.com-filedaemo n bareos.com-database-postgresql bareos.com-bconsole
skipping to change at line 287 skipping to change at line 254
sysrc bareosfd_enable=YES sysrc bareosfd_enable=YES
# start services # start services
service bareos-dir start service bareos-dir start
service bareos-sd start service bareos-sd start
service bareos-fd start service bareos-fd start
Install on Oracle Solaris Install on Oracle Solaris
~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~
:index:`\ <single: Platform; Solaris>` .. index::
single: Platform; Solaris
Bareos offers **IPS** (*Image Packaging System*) filedaemon Packages for **Oracl e Solaris 11.4**. Bareos offers **IPS** (*Image Packaging System*) filedaemon Packages for **Oracl e Solaris 11.4**.
First, download the Solaris package to the local disk and add the package as pub lisher First, download the Solaris package to the local disk and add the package as pub lisher
**bareos**: **bareos**:
.. code-block:: shell-session .. code-block:: shell-session
:caption: Add bareos publisher :caption: Add bareos publisher
root@solaris114:~# pkg set-publisher -p bareos-fd-<version>.p5p bareos root@solaris114:~# pkg set-publisher -p bareos-fd-<version>.p5p bareos
skipping to change at line 344 skipping to change at line 312
.. code-block:: shell-session .. code-block:: shell-session
:caption: Restart solaris service :caption: Restart solaris service
root@solaris114:~# svcadm restart bareos-fd root@solaris114:~# svcadm restart bareos-fd
The bareos filedaemon service on solaris is now ready for use. The bareos filedaemon service on solaris is now ready for use.
Install on Univention Corporate Server Install on Univention Corporate Server
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
:os:`Univention` Bareos offers additional functionality and integration into an Univention Corpor
ate Server environment. Please follow the intructions in :ref:`section-Univentio
Bareos offers additional functionality and integration into an Univention Corpor nCorporateServer`.
ate Server environment. Please follow the instructions in :ref:`section-Univenti
onCorporateServer`.
If you are not interested in this additional functionality, the commands describ ed in :ref:`section-InstallBareosPackagesDebian` will also work for Univention C orporate Servers. If you are not interested in this additional functionality, the commands describ ed in :ref:`section-InstallBareosPackagesDebian` will also work for Univention C orporate Servers.
.. _section-CreateDatabase: .. _section-CreateDatabase:
Prepare Bareos database Prepare Bareos database
----------------------- -----------------------
We assume that you have already your database installed and basically running. We assume that you have already your database installed and basically running.
Using the PostgreSQL database backend is recommended. Using the PostgreSQL database backend is recommended.
skipping to change at line 384 skipping to change at line 350
The selectable database backends depend on the **bareos-database-*** packages in stalled. The selectable database backends depend on the **bareos-database-*** packages in stalled.
For details see :ref:`section-dbconfig`. For details see :ref:`section-dbconfig`.
.. _section-CreateDatabaseOtherDistributions: .. _section-CreateDatabaseOtherDistributions:
Other Platforms Other Platforms
~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~
PostgreSQL
^^^^^^^^^^
If your are using PostgreSQL and your PostgreSQL administration user is **postgr es** (default), use the following commands: If your are using PostgreSQL and your PostgreSQL administration user is **postgr es** (default), use the following commands:
.. code-block:: shell-session .. code-block:: shell-session
:caption: Setup Bareos catalog with PostgreSQL :caption: Setup Bareos catalog with PostgreSQL
su postgres -c /usr/lib/bareos/scripts/create_bareos_database su postgres -c /usr/lib/bareos/scripts/create_bareos_database
su postgres -c /usr/lib/bareos/scripts/make_bareos_tables su postgres -c /usr/lib/bareos/scripts/make_bareos_tables
su postgres -c /usr/lib/bareos/scripts/grant_bareos_privileges su postgres -c /usr/lib/bareos/scripts/grant_bareos_privileges
.. _section-StartDaemons: .. _section-StartDaemons:
Start the daemons Start the daemons
----------------- -----------------
.. code-block:: shell-session .. code-block:: shell-session
:caption: Start the Bareos Daemons :caption: Start the Bareos Daemons
service bareos-dir start systemctl start bareos-dir
service bareos-sd start systemctl start bareos-sd
service bareos-fd start systemctl start bareos-fd
Please remark, the Bareos Daemons need to have access to the ports 9101-9103. Please remark, the Bareos Daemons need to have access to the ports 9101-9103.
Now you should be able to log in to the director using the bconsole. Now you should be able to log in to the director using the bconsole.
When you want to use the bareos-webui, please refer to the chapter :ref:`section -install-webui`. When you want to use the bareos-webui, please refer to the chapter :ref:`section -install-webui`.
 End of changes. 28 change blocks. 
93 lines changed or deleted 46 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)