User tools

Website tools


installation from TGZ packages

This is an old version of the document!


Installation from TGZ packages

Installation aus TGZ Paketen

For installing Benno MailArchiv on non-Debian or non-Debian-based systems, installation files are available as downloadable compressed archive files (.tgz), i.e., zipped tar archives. To install, download the latest versions of the packages benno-lib, benno-archive, benno-core, benno-rest, benno-rest-lib, and benno-web. After downloading, these files can be extracted using the tar command, for example: `tar xvfz benno-*.tgz`.

Die TGZ-Pakete können unter dem URL http://www.benno-mailarchiv.de/download/tgz/ heruntergeladen werden.

The archives will be extracted into the current subdirectory. Afterwards, the directories must be manually moved to /etc, /srv, etc. Alternatively, the archives can be extracted using the following command:

tar -xzf benno-core-$VERSION.tgz -C / 

The directories are automatically extracted to their target directories below the root directory, for example, to /etc, etc. Caution with this method! Only use this procedure if you are sure of what you are doing!

After unpacking, create the user accounts benno and bennorest, as well as the group benno. Configure the group benno as the primary group for both users. Create user and group assignments for the unpacked files accordingly and set the file permissions so that the user benno has read and write access to the archive and index, while the group benno has read-only access. Accurately setting the correct permissions is essential to ensure full system security for Benno MailArchiv.

When installing on Debian-based systems from the Debian packages, the correct permission settings are automatically created during the installation.

Users and groups

Create group

addgroup --system benno

Create user

adduser --system --ingroup benno --no-create-home --home /srv/benno --disabled-password benno
adduser --quiet --system --ingroup benno --home /opt/benno --no-create-home \ --disabled-password bennorest

The daemons benno-archive and benno-rest run with the respective user and group permissions.

File system permissions

Package dependencies

Benno Archives

Benno-Archive und Benno-REST benötigen eine Java Installation (OpenJDK 6 SDK).

Benno-Web

Benno-Web requires an Apache web server with PHP5 (>= 5.4) or PHP7 .

Additionally, the following PHP extensions will be installed/activated:

  • JSON
  • PDO
  • MBstring
Directory structure
mkdir -p /var/lib/benno-web # adjust file and directory permissions chown www-data /var/lib/benno-web chmod u=rwx,g=rx,o= /var/lib/benno-web
chgrp www-data /etc/benno-web chmod u=rwx,g=rx,o= /etc/benno-web
chown www-data /var/lib/benno-web chmod u=rwx,g=rx,o=rx /var/lib/benno-web
benno useradmin

The command-line tool benno-useradmin, which is used to manage users in the SQLite database, requires the Perl module DBI::Sqlite for SQLite version 3.

Create user database

sqlite3 "/var/lib/benno-web/bennoweb.sqlite" < /usr/share/doc/benno-web/contrib/db-create.sql sqlite3 "/var/lib/benno-web/bennoweb.sqlite" < /usr/share/doc/benno-web/contrib/db-update_2.0.1.sql

chown www-data /var/lib/benno-web/bennoweb.sqlite

chmod u=rw,g=r,o= /var/lib/benno-web/bennoweb.sqlite
installation_aus_tgz-paketen.1486482986.txt.gz · Zuletzt geändert: 2017/02/07 15:56 von lwsystems