1.. _SupportedOSes: 2 3Operating Systems 4================= 5 6:index:`\ <single: Systems; Supported Operating Systems>` 7:index:`\ <single: Support; Operating Systems>` 8 9The Bareos project provides packages that have been released on http://download.bareos.org/bareos/release/. 10 11Additionally, the following table gives an overview on the available package versions and the operating systems, respectively: 12 13.. csv-table:: 14 :header: "Operating Systems", "Version", "Client Daemon", "Director Daemon" , "Storage Daemon" 15 16 :strong:`Linux` :index:`\ <single: Platform; Linux>`\ 17 Arch Linux :index:`\ <single: Platform; Arch Linux>`\ , `X <https://aur.archlinux.org/pkgbase/bareos/>`_, `X <https://aur.archlinux.org/pkgbase/bareos/>`_, `X <https://aur.archlinux.org/pkgbase/bareos/>`_ 18 CentOS, current, v12.4, v12.4, v12.4 19 Debian, current, v12.4, v12.4, v12.4 20 Fedora, current, v12.4, v12.4, v12.4 21 Gentoo :index:`\ <single: Platform; Gentoo>`\ , `X <https://packages.gentoo.org/package/app-backup/bareos>`_, `X <https://packages.gentoo.org/package/app-backup/bareos>`_, `X <https://packages.gentoo.org/package/app-backup/bareos>`_ 22 openSUSE, current, v12.4, v12.4, v12.4 23 RHEL, current, v12.4, v12.4, v12.4 24 SLES, current, v12.4, v12.4, v12.4 25 Ubuntu, current, v12.4, v12.4, v12.4 26 :ref:`Univention Corporate Linux <section-UniventionCorporateServer>`, App Center, v12.4, v12.4, v12.4 27 28 :strong:`MS Windows` 29 :ref:`MS Windows <section-windows>` 32bit, 10/8/7, v12.4, v15.2, v15.2 30 , 2008/Vista/2003/XP, v12.4–v14.2 31 :ref:`MS Windows <section-windows>` 64bit, 10/8/2012/7, v12.4, v15.2, v15.2 32 , 2008/Vista, v12.4–v14.2 33 34 :strong:`Mac OS` 35 :ref:`Mac OS X/Darwin <section-macosx>`, v14.2 36 37 :strong:`BSD` 38 FreeBSD :index:`\ <single: Platform; FreeBSD>`\ , >= 5.0, `X <http://www.freshports.org/sysutils/bareos-client/>`_, `X <http://www.freshports.org/sysutils/bareos-server/>`_, `X <http://www.freshports.org/sysutils/bareos-server/>`_ 39 OpenBSD, , X 40 NetBSD, , X 41 :strong:`Unix` 42 AIX :index:`\ <single: Platform; AIX>`\ , >= 4.3, com-13.2, \*, \* 43 HP-UX :index:`\ <single: Platform; HP-UX>`\ , , com-13.2 44 Irix, , \* 45 Solaris :index:`\ <single: Platform; Solaris>`\ , >= 8 , com-12.4, com-12.4, com-12.4 46 True64, , , \* 47 48 49============ ============================================================================================================================= 50**vVV.V** starting with Bareos version VV.V, this platform is official supported by the Bareos.org project 51**com-VV.V** starting with Bareos version VV.V, this platform is supported. However, pre-build packages are only available from Bareos.com 52**nightly** provided by Bareos nightly build. Bug reports are welcome, however it is not official supported 53**X** known to work 54**\*** has been reported to work by the community 55============ ============================================================================================================================= 56 57Linux 58----- 59 60.. _section-packages: 61 62Packages for the different Linux platforms 63~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 64 65The following tables summarize the packages that are available for individual Linux platforms. 66Package names that do not contain the word **bareos** are required third party packages, provided by the Bareos project. 67 68For general information about the packages, see :ref:`section-BareosPackages`. 69 70.. include:: /include/autogenerated/bareos-packages-table-redhat.rst.inc 71 72.. include:: /include/autogenerated/bareos-packages-table-fedora.rst.inc 73 74.. include:: /include/autogenerated/bareos-packages-table-suse.rst.inc 75 76.. include:: /include/autogenerated/bareos-packages-table-opensuse.rst.inc 77 78.. include:: /include/autogenerated/bareos-packages-table-debian.rst.inc 79 80.. include:: /include/autogenerated/bareos-packages-table-ubuntu.rst.inc 81 82.. include:: /include/autogenerated/bareos-packages-table-univention.rst.inc 83 84 85.. _section-UniventionCorporateServer: 86 87Univention Corporate Server 88~~~~~~~~~~~~~~~~~~~~~~~~~~~ 89 90:index:`\ <single: Platform; Univention Corporate Server>` 91:os:`Univention` 92The Bareos version for the Univention App Center integraties into the Univention Enterprise Linux environment, making it easy to backup all the systems managed by the central Univention Corporate Server. 93 94Preamble 95^^^^^^^^ 96 97The `Univention Corporate Server <http://www.univention.de/>`_ is an enterprise Linux distribution based on Debian. It consists of an integrated management system for the centralised administration of servers, computer workplaces, users and their rights as well as a wide range of server applications. It also includes an Unvention App Center for the easy installation and management of extensions and appliances. 98 99Bareos is part of the `App Center <https://www.univention.de/produkte/univention-app-center/app-katalog/bareos/>`_ and therefore an Univention environment can easily be extended to provide backup functionality for the Univention servers as well as for the connected client systems. Using the Univention Management Console (UMC), you can also create backup jobs for client computers (Windows or Linux systems), without the need of editing configuration files. 100 101The Bareos Univention App is shipped with a default configuration for the director daemon and the storage daemon. 102 103 104 105.. warning:: 106 107 You need to review some Univention configuration registry (UCR) variables. Most likely, you will want to set the location where the backups are stored. Otherwise, you may quickly run out of disk space on your backup server! 108 109You will find further information under :ref:`section-UniventionBackupStorage`. 110 111Quick Start 112^^^^^^^^^^^ 113 114- Determine the space requirements and where to store your backup data 115 116- Set the :strong:`bareos/*` UCR variables according to your needs, see :ref:`section-UCR` 117 118- Restart :command:`bareos-dir`, :command:`bareos-sd` and :command:`bareos-fd` (or simply reboot the server) 119 120- Install the Bareos file daemon on clients and copy Director configuration resource file from 121 122 - :file:`/etc/bareos/bareos-dir-export/client/<clientname>-fd/bareos-fd.d/director/*.conf` 123 124 - (or :file:`/etc/bareos/autogenerated/client-configs/<hostname>.conf`, if Bareos < 16.2.0) 125 126 For details, see :ref:`section-UniventionAddClient`. 127 128- Enable backup jobs for clients in the Univention Management Console 129 130 131.. _section-UCR: 132 133UCR variables 134^^^^^^^^^^^^^ 135 136:strong:`bareos/filestorage` 137 : /var/lib/bareos/storage (default) 138 139 - Location where to store the backup files. Make sure, it offers enough disk space for a configured backup volumes. 140 141:strong:`bareos/max_full_volume_bytes` 142 : 20 (default) 143 144 - Maximum size (in GB) of a volume for the :config:option:`dir/pool = Full`\ backup pool 145 146:strong:`bareos/max_full_volumes` 147 : 1 (default) 148 149 - Maximum number of volumes for the :config:option:`dir/pool = Full`\ backup pool 150 151:strong:`bareos/max_diff_volume_bytes` 152 : 10 (default) 153 154 - Maximum size (in GB) of a volume for the :config:option:`dir/pool = Differential`\ backup pool 155 156:strong:`bareos/max_diff_volumes` 157 : 1 (default) 158 159 - Maximum number of volumes for the :config:option:`dir/pool = Differential`\ backup pool 160 161:strong:`bareos/max_incr_volume_bytes` 162 : 1 (default) 163 164 - Maximum size (in GB) of a volume for the :config:option:`dir/pool = Incremental`\ backup pool 165 166:strong:`bareos/max_incr_volumes` 167 : 1 (default) 168 169 - Maximum number of volumes for the :config:option:`dir/pool = Incremental`\ backup pool 170 171:strong:`bareos/backup_myself` 172 : no (default) 173 174 no 175 don’t backup the server itself 176 177 yes 178 backup the server itself 179 180:strong:`bareos/webui/console/user1/username` 181 : Administrator (default) 182 183 - User name to login at the bareos-webui 184 185:strong:`bareos/webui/console/user1/password` 186 : (no default value) 187 188 - Password to login at the bareos-webui 189 190UCR variables can be set via the Univention Configuration Registry Web interface 191 192.. image:: /include/images/univention-configuration-registry-settings.* 193 :width: 100.0% 194 195 196 197or using the :command:`ucr` command line tool: 198 199.. code-block:: shell-session 200 :caption: Enable backup of the server itself 201 202 root@ucs:~# ucr set bareos/backup_myself=yes 203 Setting bareos/backup_myself 204 File: /etc/bareos/bareos-dir.conf 205 [ ok ] Reloading Bareos Director: bareos-dir. 206 207 208 209.. warning:: 210 211 univention-bareos < 15.2 did require a manual reload/restart of the bareos-dir service: 212 213.. code-block:: shell-session 214 :caption: let bareos-dir reload its configuration 215 216 root@ucs:~# service bareos-dir reload 217 [ ok ] Reloading Bareos Director: bareos-dir. 218 219Setup 220^^^^^ 221 222After installation of the Bareos app, Bareos is ready for operation. A default configuration is created automatically. 223 224Bareos consists of three daemons called :command:`director` (or :command:`bareos-dir`), :command:`storage-daemon` (or :command:`bareos-sd`) and :command:`filedaemon` (or :command:`bareos-fd`). All three daemons are started right after the installation by the Univention App Center. 225 226If you want to enable automatic backups of the server, you need to set the Univention configuration registry (UCR) variable :strong:`bareos/backup_myself` to :strong:`yes` and reload the director daemon. 227 228Administration 229^^^^^^^^^^^^^^ 230 231For general tasks the :ref:`bareos-webui <section-webui>` can be used. Additional, there is the :command:`bconsole` command line tool: 232 233.. code-block:: shell-session 234 :caption: Starting the bconsole 235 236 root@ucs:~# bconsole 237 Connecting to Director ucs:9101 238 1000 OK: ucs-dir Version: 15.2.2 (15 November 2015) 239 Enter a period to cancel a command. 240 * 241 242For general information, see the :ref:`Bconsole Tuturial <section-TuturialBconsole>`. 243 244Backup Schedule 245^^^^^^^^^^^^^^^ 246 247As a result of the default configuration located at the :command:`bareos-dir`, the backup schedule will look as follows: 248 249Full Backups 250 - are written into the :config:option:`dir/pool = Full`\ pool 251 252 - on the first saturday at 21:00 o’clock 253 254 - and kept for 365 days 255 256Differential Backups 257 - are written into the :config:option:`dir/pool = Differential`\ pool 258 259 - on every 2nd to 5th saturday at 21:00 o’clock 260 261 - and kept for 90 days 262 263Incremental Backups 264 - are written into the :config:option:`dir/pool = Incremental`\ pool 265 266 - on every day from monday to friday at 21:00 o’clock 267 268 - and kept for 30 days 269 270That means full backups will be written every first saturday at 21:00 o’clock, differential backups every 2nd to 5th saturday at 21:00 o’clock and incremental backups from monday to friday at 21:00 o’clock. So you have got one full backup every month, four weekly differential and 20 daily incremental backups per month. 271 272This schedule is active for the Univention server backup of itself and all other clients, which are backed up through the :command:`bareos-dir` on the Univention server. 273 274There is also a special backup task, which is the Bareos backups itself for a possible disaster recovery. This backup has got its own backup cycle which starts after the main backups. The backup consists of a database backup for the metadata of the Bareos backup server and a backup of the Bareos configuration files under :file:`/etc/bareos/`. 275 276Backup data management 277^^^^^^^^^^^^^^^^^^^^^^ 278 279Data from the backup jobs is written to volumes, which are organized in pools (see chapter :ref:`DirectorResourcePool`). 280 281The default configuration uses three different pools, called :config:option:`dir/pool = Full`\ , :config:option:`dir/pool = Differential`\ and :config:option:`dir/pool = Incremental`\ , which are used for full backups, differential and incremental backups, respectively. 282 283If you change the UCR variables, the configuration files will be rewritten automatically. After each change you will need to reload the director daemon. 284 285.. code-block:: shell-session 286 :caption: Example for changing the Full pool size to $10 \ast 20$ GB 287 288 root@ucs:~# ucr set bareos/max_full_volumes=10 289 Setting bareos/max_full_volumes 290 File: /etc/bareos/bareos-dir.conf 291 [ ok ] Reloading Bareos Director: bareos-dir. 292 root@ucs:~# ucr set bareos/max_full_volume_bytes=20 293 Setting bareos/max_full_volume_bytes 294 File: /etc/bareos/bareos-dir.conf 295 [ ok ] Reloading Bareos Director: bareos-dir. 296 297 298 299.. warning:: 300 301 This only affects new volumes. Existing volumes will not change there size. 302 303 304.. _section-UniventionBackupStorage: 305 306Backup Storage 307^^^^^^^^^^^^^^ 308 309 310 311 .. warning:: 312 313 Using the default configuration, Bareos will store backups on your local disk. You may want to store the data to another location to avoid using up all of your disk space. 314 315The location for backups is :file:`/var/lib/bareos/storage` in the default configuration. 316 317For example, to use a NAS device for storing backups, you can mount your NAS volume via NFS on :file:`/var/lib/bareos/storage`. Alternatively, you can mount the NAS volume to another directory of your own choice, and change the UCR variable :strong:`bareos/filestorage` to the corresponding path. The directory needs to be writable by user **bareos**. 318 319.. code-block:: shell-session 320 :caption: Example for changing the storage path 321 322 root@ucs:/etc/bareos# ucr set bareos/filestorage=/path/to/your/storage 323 Setting bareos/filestorage 324 File: /etc/bareos/bareos-sd.conf 325 326 327 328.. warning:: 329 330 You need to restart the Bareos storage daemon after having changed the storage path: 331 332.. code-block:: shell-session 333 334 root@ucs:/# service bareos-sd restart 335 336 337Bareos Webui Configuration 338^^^^^^^^^^^^^^^^^^^^^^^^^^ 339 340After installation you just need to setup your login credentials via UCR variables. Therefore, set the Univention configuration registry (UCR) variable :strong:`bareos/webui/console/user1/username` and :strong:`bareos/webui/consoles/user1/password` according to your needs. The director configuration is automatically reloaded if one of those two variables changes. 341 342Alternatively you can also set those UCR variables via commandline. 343 344.. code-block:: shell-session 345 :caption: Example for changing webui login credentials 346 347 root@ucs:~# ucr set bareos/webui/console/user1/username="bareos" 348 Setting bareos/webui/console/user1/username 349 File: /etc/bareos/bareos-dir.conf 350 [ ok ] Reloading Bareos Director: bareos-dir. 351 root@ucs:~# ucr set bareos/webui/console/user1/password="secret" 352 Setting bareos/webui/console/user1/password 353 File: /etc/bareos/bareos-dir.conf 354 [ ok ] Reloading Bareos Director: bareos-dir. 355 356When your login credentials are set, you can login into Bareos Webui by following the entry in your Administration UCS Overview or directly via https://<UCS_SERVER>/bareos-webui/. 357 358.. image:: /include/images/univention-ucs-overview-administration.* 359 :width: 80.0% 360 361 362 363.. _section-UniventionAddClient: 364 365Add a client to the backup 366^^^^^^^^^^^^^^^^^^^^^^^^^^ 367 368Overview 369'''''''' 370 371- Install the Bareos client software on the target system, see :ref:`Adding a Bareos Client <SecondClient>` 372 373- Use the Univention Management Console to add the client to the backup, see the screenshot below 374 375- Copy the filedaemon resource configuration file from the Univention server to the target system 376 377Bareos >= 16.2.4 378'''''''''''''''' 379 380Server-side 381 382 383The Univention Bareos application comes with an automatism for the client and job configuration. If you want to add a client to the Bareos director configuration, you need use the Univention Management Console, select the client you want to backup and set the :strong:`enable backup job` checkbox to true, as shown in the screenshot below. 384 385.. image:: /include/images/univention-client-job-activation.* 386 :width: 80.0% 387 388 389 390 391If the name of the client is **testw1.example.com**, corresponding configuration files will be generated: 392 393- :file:`/etc/bareos/autogenerated/clients/testw1.example.com.include` 394 395- :file:`/etc/bareos/bareos-dir-export/client/testw1.example.com-fd/bareos-fd.d/director/bareos-dir.conf` 396 397Generated configuration files under :file:`/etc/bareos/bareos-dir-export/client/` are intended for the target systems. After you have :ref:`installed the Bareos client on the target system <SecondClient>`, copy the generated client configuration over to the client and save it to following directories: 398 399- on Linux: :file:`/etc/bareos/bareos-fd.d/director/` 400 401- on Windows: :file:`C:\Program Files\Bareos\bareos-fd.d/director/` 402 403.. code-block:: shell-session 404 :caption: copy client configuration from the server to the testw1.example.com client (Linux) 405 406 root@ucs:~# CLIENTNAME=testw1.example.com 407 root@ucs:~# scp /etc/bareos/bareos-dir-export/client/${CLIENTNAME}-fd/bareos-fd.d/director/*.conf root@${CLIENTNAME}:/etc/bareos/bareos-fd.d/director/ 408 409Background 410'''''''''' 411 412The settings for each job resource are defined by the template files you see below: 413 414The files 415 416- :file:`/etc/bareos/autogenerated/clients/generic.template` 417 418- :file:`/etc/bareos/autogenerated/clients/windows.template` 419 420are used as templates for new clients. For Windows clients the file :file:`windows.template` is used, the :file:`generic.template` is used for all other client types. 421 422If you disable the Bareos backup for a client, the client will not be removed from the configuration files. Only the backup job will be set inactive. 423 424If you add three client, your client directory will look similar to this: 425 426.. code-block:: shell-session 427 428 root@ucs:/etc/bareos/autogenerated/clients# ls -l 429 -rw-r--r-- 1 root root 430 16. Mai 15:15 generic.template 430 -rw-r----- 1 root bareos 513 21. Mai 14:46 testw1.example.com.include 431 -rw-r----- 1 root bareos 518 21. Mai 14:49 testw2.example.com.include 432 -rw-r----- 1 root bareos 518 16. Mai 18:17 testw3.example.com.include 433 -rw-r--r-- 1 root root 439 16. Mai 15:15 windows.template 434 435The client configuration file contains, as you can see below, the client connection and the job information: 436 437.. code-block:: shell-session 438 439 root@ucs:/etc/bareos/autogenerated/clients# cat testw2.example.com.include 440 Client { 441 Name = "testw2.example.com-fd" 442 Address = "testw2.example.com" 443 Password = "DBLtVnRKq5nRUOrnB3i3qAE38SiDtV8tyhzXIxqR" 444 } 445 446 Job { 447 Name = "Backup-testw2.example.com" # job name 448 Client = "testw2.example.com-fd" # client name 449 JobDefs = "DefaultJob" # job definition for the job 450 FileSet = "Windows All Drives" # FileSet (data which is backed up) 451 Schedule = "WeeklyCycle" # schedule for the backup tasks 452 Enabled = "Yes" #this is the ressource which is toggled on/off by enabling or disabling a backup from the univention gui 453 } 454 455Bareos < 16.2.0 456''''''''''''''' 457 458Older versions of Bareos handle generating the client configuration similar, but not identical: 459 460If the name of the client is **testw1.example.com**, corresponding configuration files will be generated/adapted: 461 462- creates :file:`/etc/bareos/autogenerated/fd-configs/testw1.example.com.conf` 463 464- creates :file:`/etc/bareos/autogenerated/clients/testw1.example.com.include` 465 466- extends :file:`/etc/bareos/autogenerated/clients.include` 467 468Here the files intended for the target systems are generated under :file:`/etc/bareos/autogenerated/fd-configs/` and they do not only definr a director resource, but are full configuration files for the client. After you have :ref:`installed the Bareos client on the target system <SecondClient>`, copy the generated client configuration over to the client and save it to 469 470- on Linux: :file:`/etc/bareos/bareos-fd.conf` 471 472- on Windows: :file:`C:\Program Files\Bareos\bareos-fd.conf` 473 474.. code-block:: shell-session 475 :caption: copy client configuration from the server to the testw1.example.com client (Linux) 476 477 root@ucs:~# CLIENTNAME=testw1.example.com 478 root@ucs:~# scp /etc/bareos/autogenerated/fd-configs/${CLIENTNAME}.conf root@${CLIENTNAME}:/etc/bareos/bareos-fd.conf 479 480 481.. _section-DebianOrg: 482 483Debian.org / Ubuntu Universe 484~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 485 486:index:`\ <single: Platform; Debian; Debian.org>` 487:index:`\ <single: Platform; Debian; 8>` 488:index:`\ <single: Platform; Ubuntu; Universe>` 489:index:`\ <single: Platform; Ubuntu; Universe; 15.04>` 490 491The distributions of Debian >= 8 include a version of Bareos. Ubuntu Universe >= 15.04 does also include these packages. 492 493In the further text, these version will be named **Bareos (Debian.org)** (also for the Ubuntu Universe version, as this is based on the Debian version). 494 495 496.. _section-DebianOrgLimitations: 497 498Limitations of the Debian.org/Ubuntu Universe version of Bareos 499^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 500 501- Debian.org does not include the libfastlz compression library and therefore the Bareos (Debian.org) packages do not offer the fileset options :strong:`compression=LZFAST`, :strong:`compression=LZ4` and :strong:`compression=LZ4HC`. 502 503- Debian.org does not include the **bareos-webui** package. 504 505 506.. _section-macosx: 507 508Mac OS X 509-------- 510 511:index:`\ <single: Platform; Mac; OS X>`\ 512 513Bareos for MacOS X is available either 514 515- via the `Homebrew project <https://brew.sh/>`_ (http://formulae.brew.sh/formula/bareos-client) or 516 517- as pkg file from http://download.bareos.org/bareos/release/latest/MacOS/. 518 519However, you have to choose upfront, which client you want to use. Otherwise conflicts do occur. 520 521Both packages contain the |fd| and :command:`bconsole`. 522 523Installing the Bareos Client as PKG 524~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 525 526:index:`\ <single: Installation; MacOS>`\ 527 528The Bareos installer package for Mac OS X contains the |fd| for Mac OS X 10.5 or later. 529 530On your local Mac, you must be an admin user. The main user is an admin user. 531 532Download the :file:`bareos-client*.pkg` installer package from http://download.bareos.org/bareos/release/latest/MacOS/. 533 534Find the .pkg you just downloaded. Install the .pkg by holding the CTRL key, left-clicking the installer and choosing "open". 535 536Follow the directions given to you and finish the installation. 537 538Configuration 539~~~~~~~~~~~~~ 540 541To make use of your |fd| on your system, it is required to configure the |dir| and the local |fd|. 542 543Configure the server-side by follow the instructions at :ref:`section-AddAClient`. 544 545After configuring the server-side you can either transfer the necessary configuration file using following command or configure the client locally. 546 547Option 1: Copy the director resource from the Bareos Director to the Client 548^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 549 550Assuming your client has the DNS entry :strong:`client2.example.com` and has been added to |dir| as :config:option:`bareos-dir/client = client2-fd`\ : 551 552.. code-block:: shell-session 553 554 scp /etc/bareos/bareos-dir-export/client/client2-fd/bareos-fd.d/director/bareos-dir.conf root@client2.example.com:/usr/local/etc/bareos/bareos-fd.d/director/ 555 556This differs in so far, as on Linux the configuration files are located under :file:`/etc/bareos/`, while on MacOS they are located at :file:`/usr/local/etc/bareos/`. 557 558Option 2: Edit the director resource on the Client 559^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 560 561Alternatively, you can edit the file :file:`/usr/local/etc/bareos/bareos-fd.d/director/bareos-dir.conf`. 562 563This can be done by right-clicking the finder icon in your task bar, select "Go to folder ..." and paste :file:`/usr/local/etc/bareos/bareos-fd.d/director/`. 564 565Select the :file:`bareos-dir.conf` file and open it. 566 567Alternatively you can also call following command on the command console: 568 569.. code-block:: shell-session 570 571 open -t /usr/local/etc/bareos/bareos-fd.d/director/bareos-dir.conf 572 573The file should look similar to this: 574 575.. code-block:: bareosconfig 576 :caption: bareos-fd.d/director/bareos-dir.conf 577 578 Director { 579 Name = bareos-dir 580 Password = "SOME_RANDOM_PASSWORD" 581 Description = "Allow the configured Director to access this file daemon." 582 } 583 584Set this client-side password to the same value as given on the server-side. 585 586 587 588.. warning:: 589 590 The configuration file contains passwords and therefore must not be accessible for any users except admin users. 591 592Restart bareos-fd after changing the configuration 593~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 594 595The bareos-fd must be restarted to reread its configuration: 596 597.. code-block:: shell-session 598 :caption: Restart the |fd| 599 600 sudo launchctl stop org.bareos.bareos-fd 601 sudo launchctl start org.bareos.bareos-fd 602 603Verify that the Bareos File Daemon is working 604~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 605 606Open the :command:`bconsole` on your |dir| and check the status of the client with 607 608.. code-block:: bareosconfig 609 610 *<input>status client=client2-fd</input> 611 612In case, the client does not react, following command are useful the check the status: 613 614.. code-block:: shell-session 615 :caption: Verify the status of |fd| 616 617 # check if bareos-fd is started by system: 618 sudo launchctl list org.bareos.bareos-fd 619 620 # get process id (PID) of bareos-fd 621 pgrep bareos-fd 622 623 # show files opened by bareos-fd 624 sudo lsof -p `pgrep bareos-fd` 625 626 # check what process is listening on the |fd| port 627 sudo lsof -n -iTCP:9102 | grep LISTEN 628 629You can also manually start bareos-fd in debug mode by: 630 631.. code-block:: shell-session 632 :caption: Start |fd| in debug mode 633 634 sudo /usr/local/sbin/bareos-fd -f -d 100 635 636