%
% owncloud.tex
% Last Update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel ownCloud %%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% Achtung: Dateien muessen mit latin1-Encoding gespeichert werden!
% Attention: Files must be saved using latin1 encoding!
%

\chapter{Das ownCloud-Paket}

\section{Die Einleitung}

    Die ownCloud-Software stellt einen ortsunabh"angigen Speicherbereich f"ur
    Daten zur Verf"ugung. Im Gegensatz zu kommerziellen Speicherdiensten l"auft
    ownCloud auf einem privaten Server. Somit k"onnen Bedenken gegen eine
    Weitergabe von sensiblen, pers"onlichen Daten und der damit verbundenen
    Abgabe der Kontrolle "uber die selbigen entkr"aftet werden.


\section{Die Funktionen}

    Das ownCloud-Paket besteht aus folgenden Komponenten:

    \begin{itemize}
         \item ownCloud - Die Plattform f"ur die Verwaltung der Daten \\
             (\url{https://owncloud.org/})

         \item ownCloud-Apps - Stellen zus"atzliche Programmfunktionen zur Verf"ugung \\
             (\url{https://marketplace.owncloud.com/})
    \end{itemize}

\section{Die Lizenzen}

    Die Dateien des ownCloud-Programmpaketes sind unter der Affero General Public
    License v3 (AGPL), deren Text in der Datei COPYING-AGPL im ownCloud-Webverzeichnis
    nachgelesen werden kann, oder neueren Versionen der AGPL lizenziert, solange
    keine anderslautenden Aussagen getroffen wurden.

    Einzelne Komponenten sind wie folgt lizenziert:
    \begin{itemize}
     \item jQuery: MIT / GPL
     \item HTTP: 3 clause BSD
     \item MDB2: BSD style custom
     \item User: AGPL
     \item XML/RPC: MIT / PHP
     \item Silk icons: Creative Commons Attribution
    \end{itemize}

    Alle unmodifizierten Dateien aus diesen oder anderen Quellen unterliegen den
    urspr"unglichen Copyright- und Lizenzangaben, die in den einzelnen Dateien
    vermerkt wurden.

\section{Die Voraussetzungen}

    Dieses Paket ben"otigt einen laufenden Apache2-Webserver mit einem installiertem
    Apache2\_php7- oder PHP7-FPM-Paket, sowie auf Wunsch ein optional installiertes
    und laufendes MySQL- oder PostgreSQL-Paket, um funktionieren zu k"onnen.
    Standardm"a"sig wird SQLite als Datenbank verwendet.


\section{Die Installation}

    Das ownCloud-Paket wird "uber das Setup-Men"u installiert. Wird eine
    "altere Paketversion vorgefunden, so wird diese deinstalliert bevor
    die neuen Programmdateien installiert werden. Nach dem Installieren der
    Programmdateien wird direkt der Konfigurations-Editor gestartet um die
    Konfiguration anzupassen.\\
    Nach Beendigung dieses Schrittes werden die Konfigurationsdateien generiert
    und alle ben"otigten Programme gestartet. Danach kann standardm"a"sig "uber
    einen Webbrowser, durch Eingabe von \texttt{`http://<Name des eisfair-Servers>/owncloud/`},
    ein abweichendes Verzeichnis kann in der Konfiguration "uber den Parameter
    \jump{OWNCLOUDDOCUMENTROOT}{OWNCLOUD\_DOCUMENT\_ROOT} gesetzt werden, auf
    die Anwendung zugegriffen werden.


\section{Das Men"u im Setup-Programm}

    Das Men"u im Setup-Programm ist wie folgt aufgebaut:

    \begin{itemize}
        \item ownCloud administration
        \begin{itemize}
            \item View documentation: Anzeigen der Dokumentation
            \item Edit configuration: Bearbeiten der Konfiguration
            \item Advanced configuration file handling: Konfigurationen verwalten
            \item View configuration log file: Die Konfigurations-Logmeldungen anzeigen
            \item View log file: Die Logmeldungen anzeigen
            \item Exit: Untermen"u verlassen
        \end{itemize}
    \end{itemize}

    Die Men"upunkte d"urften selbsterkl"arend sein, da sie keinerlei weitere
    Eingaben erwarten. Aus diesem Grund wird auf deren Funktion nicht weiter
    eingegangen.


\section{Die "Anderung der Konfiguration}

    Die Konfiguration kann "uber den Men"upunkt `Edit configuration' ge"andert
    werden. Standardm"a"sig wird der Editor aufgerufen, der in der
    Environment-Konfiguration "uber die Variable 'EDITOR' festgelegt wurde.
    Nachdem der Editor beendet wurde wird abgefragt, ob die Konfiguration
    aktiviert werden soll. Wird dies best"atigt, werden "uber ein Skript
    die Anpassungen umgehend wirksam gemacht.\\


\section{Die Konfigurationsdatei}

    In der Konfigurationsdatei, die "uber das Men"u zug"anglich ist, sind
    folgende Parameter vorhanden; wer sie von Hand editieren will findet
    sie unter \texttt{/etc/config.d/owncloud}.


\section{Die Parameter}

\begin{description}
%%  JED - show this description only in the help file
 %  \config{OWNCLOUD\_DO\_DEBUG (Optionaler Parameter)}{OWNCLOUD\_DO\_DEBUG}{OWNCLOUDDODEBUG}
 %      Um den Debug-Modus zu aktivieren muss diese Parameter
 %      lediglich auf den Wert `yes' gestellt werden, die Einstellung
 %      `no' deaktiviert den Debug-Modus.
 %
 %      G"ultige Werte: yes, no
 %
 %      Standardeinstellung: \texttt{OWNCLOUD\_DO\_DEBUG='no'}

    \config{START\_OWNCLOUD}{START\_OWNCLOUD}{STARTOWNCLOUD}
        F"ur die Aktivierung des ownCloud-Programms muss dieser
        Parameter lediglich auf den Wert `yes' gestellt werden,
        die Einstellung `no' deaktiviert das ownCloud-Programm.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{START\_OWNCLOUD='no'}

    \config{OWNCLOUD\_ADMIN\_USER}{OWNCLOUD\_ADMIN\_USER}{OWNCLOUDADMINUSER}
        "Uber diesen Parameter wird der Name des ownCloud-Administrators
        festgelegt.

        G"ultige Werte: Name des ownCloud-Administrators

        Standardeinstellung: \texttt{OWNCLOUD\_ADMIN\_USER='admin'}

    \config{OWNCLOUD\_ADMIN\_PASS}{OWNCLOUD\_ADMIN\_PASS}{OWNCLOUDADMINPASS}
        "Uber diesen Parameter wird das Kennwort des ownCloud-Administrators
        festgelegt.

        G"ultige Werte: Kennwort des ownCloud-Administrators

        Beispiel: \texttt{OWNCLOUD\_ADMIN\_PASS='pass'}

    \config{OWNCLOUD\_DOCUMENT\_ROOT (Optionaler Parameter)}{OWNCLOUD\_DOCUMENT\_ROOT}{OWNCLOUDDOCUMENTROOT}
        "Uber diesen Parameter kann ein vom Standard abweichendes
        Dokumentenstammverzeichnis festgelegt werden. Wird dieser
        Parameter nicht gesetzt, so wird der folgende Verzeichnispfad
        verwendet: /var/www/htdocs/owncloud .

        G"ultige Werte: absolute Pfadangabe

        Beispiel: \texttt{OWNCLOUD\_DOCUMENT\_ROOT='/var/www/htdocs/owncloud'}

    \config{OWNCLOUD\_WEB\_ROOT (Optionaler Parameter)}{OWNCLOUD\_WEB\_ROOT}{OWNCLOUDWEBROOT}
        Falls "uber den Parameter OWNCLOUD\_DOCUMENT\_ROOT ein vom
        Standard abweichendes Dokumentenstammverzeichnis festgelegt
        wurde, kann auf Wunsch "uber diesen Parameter auch ein vom
        Standard abweichendes Web-Stammverzeichnis festgelegt werden.
        Wird dieser Parameter nicht gesetzt, so wird der folgende Pfad
        verwendet: /owncloud

        G"ultige Werte: absolute Pfadangabe

        Beispiel: \texttt{OWNCLOUD\_WEB\_ROOT='/owncloud'}

    \config{OWNCLOUD\_DATA\_DIR (Optionaler Parameter)}{OWNCLOUD\_DATA\_DIR}{OWNCLOUDDATADIR}
        "Uber diesen Parameter kann ein vom Standard abweichendes
        Datenverzeichnis festgelegt werden in welchem ownCloud seine
        Dateien ablegt. Wird dieser Parameter nicht gesetzt, so werden
        standardm"a"sig die folgenden Verzeichnispfade verwendet:

        \texttt{eisfair-1: /var/owncloud}

        G"ultige Werte: absolute Pfadangabe

        Beispiel: \texttt{OWNCLOUD\_DATA\_DIR='/var/owncloud'}

%   \config{OWNCLOUD\_CRYPT\_SALT}{OWNCLOUD\_CRYPT\_SALT}{OWNCLOUDCRYPTSALT}
%       Dieser Parameter zeigt die zum 'salzen' der Anwenderkennw"orter
%       verwendete, drei"sigstellige, zuf"allige Zeichenfolge an.\\
%       \hinweis{Der Wert dieses Parameter wird bei der Erstellung der
%           initialen Konfiguration automatisch von ownCloud generiert.}\\
%       \achtung{Geht diese Zeichenfolge verloren, so kann keines der
%           festgelegten Kennw"orter mehr verwendet werden.}
%
%       Standardeinstellung: \texttt{OWNCLOUD\_CRYPT\_SALT=$''$}
%
    \config{OWNCLOUD\_TRUSTED\_DOMAIN}{OWNCLOUD\_TRUSTED\_DOMAIN}{OWNCLOUDTRUSTEDDOMAIN}
        "Uber diesen Parameter werden einer oder mehrere FQDN (Fully
        Qualified Domain Name) oder IP-Adressen, getrennt durch ein Pipe-Zeichen,
        angegeben von welchen ein Zugriff auf ownCloud zugelassen wird.
        Auf Wunsch kann einem FQDN oder einer IP-Adresse eine durch einen
        Doppelpunkt getrennte Portnummer folgen. Ein Login wird nur dann
        zugelassen, wenn der angegeben Domain Name mit dem in der URL
        angegebenen Domain Namen "ubereinstimmt.

        G"ultige Werte: FQDN oder IP-Adresse, optional gefolgt von einer Portnummer

        Standardeinstellung: \texttt{OWNCLOUD\_TRUSTED\_DOMAIN=$''$}

    \config{OWNCLOUD\_DB\_TYPE}{OWNCLOUD\_DB\_TYPE}{OWNCLOUDDBTYPE}
        "Uber diesen Parameter kann auf Wunsch, ein vom Standard 'sqlite'
        abweichender Datenbanktyp angegeben werden. Folgende Datenbanken
        werden unterst"utzt:\\

        \begin{itemize}
            \item{mysql}  MySQL/MariaDB
%           \item{pgsql}  PostgreSQL
            \item{sqlite} SQLite3 (Standard)
        \end{itemize}

        G"ultige Werte: g"ultiger Datenbanktyp

        Standardeinstellung: \texttt{OWNCLOUD\_DB\_TYPE=$''$}

    \config{OWNCLOUD\_DB\_HOST (Optionaler Parameter)}{OWNCLOUD\_DB\_HOST}{OWNCLOUDDBHOST}
        "Uber diesen Parameter kann bei Bedarf der FQDN-Name des
        Servers festgelegt werden, auf sich die ownCloud-Datenbank
        befindet. Falls erforderlich kann der zu verwendende
        TCP-Port, getrennt durch einen Doppelpunkt angeh"angt werden.
        Wird kein Port angegeben, so wird standardm"a"sig der Port
        `3306' verwendet. Standardm"a"sig wird die Datenbank auf dem
        gleichen Server erstellt, auf welchem auch ownCloud betrieben
        wird.

        G"ultige Werte: FQDN-Name eines Servers, zzgl. des TCP-Port

        Beispiel: \texttt{OWNCLOUD\_DB\_HOST=$'db-server.privat.lan:3306'$}

    \config{OWNCLOUD\_DB\_USER}{OWNCLOUD\_DB\_USER}{OWNCLOUDDBUSER}
        "Uber diesen Parameter kann bei Bedarf ein Datenbankanwender
        festgelegt werden, welcher f"ur den Zugriff auf die interne
        ownCloud-Datenbank verwendet werden soll. Dies ist "ublicherweise
        der Fall, wenn MySQL oder PostgreSQL als zu verwendende Datenbank
        ausgew"ahlt wurde.

        G"ultige Werte: Name eines Datenbankanwenders

        Standardeinstellung: \texttt{OWNCLOUD\_DB\_USER=$''$}

    \config{OWNCLOUD\_DB\_PASS}{OWNCLOUD\_DB\_PASS}{OWNCLOUDDBPASS}
        "Uber diesen Parameter kann bei Bedarf ein Datenbankkennwort
        festgelegt werden, welches f"ur den Zugriff auf die interne
        ownCloud-Datenbank verwendet werden soll. Dies ist "ublicherweise
        der Fall, wenn MySQL als zu verwendende Datenbank ausgew"ahlt
        wurde.

        G"ultige Werte: Kennwort

        Standardeinstellung: \texttt{OWNCLOUD\_DB\_PASS=$''$}

    \config{OWNCLOUD\_REDIS\_HOST (Optionaler Parameter)}{OWNCLOUD\_REDIS\_HOST}{OWNCLOUDREDISHOST}
        "Uber diesen Parameter kann bei Bedarf der FQDN-Name des
        Servers festgelegt werden, auf sich die Redis-Cache-Datenbank
        befindet. Falls erforderlich kann der zu verwendende
        TCP-Port, getrennt durch einen Doppelpunkt angeh"angt werden.
        Wird kein Port angegeben, so wird standardm"a"sig der Port
        `6379' verwendet. Standardm"a"sig wird die Datenbank auf dem
        gleichen Server erstellt, auf welchem auch ownCloud betrieben
        wird.

        G"ultige Werte: FQDN-Name eines Servers

        Beispiel: \texttt{OWNCLOUD\_REDIS\_HOST='db-server.privat.lan'}

    \config{OWNCLOUD\_REDIS\_PASS (Optionaler Parameter)}{OWNCLOUD\_REDIS\_PASS}{OWNCLOUDREDISPASS}
        "Uber diesen Parameter kann bei Bedarf ein Datenbankkennwort
        festgelegt werden, welches f"ur den Zugriff auf die Redis-Cache-
        Datenbank verwendet werden soll.

        G"ultige Werte: Kennwort

        Standardeinstellung: \texttt{OWNCLOUD\_REDIS\_PASS=$''$}

    \config{OWNCLOUD\_PREVIEW\_SETTINGS (Optionaler Parameter)}{OWNCLOUD\_PREVIEW\_SETTINGS}{OWNCLOUDPREVIEWSETTINGS}
        "Uber diesen Parameter k"onnen bei Bedarf die Grenzwerte f"ur
        das Erzeugen von Vorschaubildern angepasst werden oder die
        Erzeugung von Vorschaubildern g"aenzlich abgeschaltet werden.
        Wird dieser Parameter nicht gesetzt, so werden folgende Werte
        verwendet:

        Maximale Breite in Pixel: 1024 ('nolimit' oder gerade Zahl)\\
        Maximale H"ohe in Pixel: 1024 ('nolimit' oder gerade Zahl)\\
        Maximaler Skalierungsfaktor: 10 ('disabled' oder 1-10)\\
        Maximale Bilddateigr"oe"se: 50MB ('nolimit' oder gerade Zahl)

        G"ultige Werte: 'no' oder vier durch ein Semikolon getrennte Werte

        Beispiel: \texttt{OWNCLOUD\_PREVIEW\_SETTINGS='1024:1024:10:50'}

    \config{OWNCLOUD\_SHARE\_FOLDER (Optionaler Parameter)}{OWNCLOUD\_SHARE\_FOLDER}{OWNCLOUDSHAREFOLDER}
        "Uber diesen Parameter kann auf Wunsch ein Verzeichnis angegeben
        werden, in welchem geteilte Inhalte abgelegt werden. Wird dieser 
        Parameter nicht gesetzt, so wird standardm"a"sig dass Stammverzeichnis
        (/) verwendet.

        G"ultige Werte: absolute Pfadangabe

        Beispiel: \texttt{OWNCLOUD\_SHARE\_FOLDER='/GeteiltesZeug'}

    \config{OWNCLOUD\_REWRITE\_BASEURL (Optionaler Parameter)}{OWNCLOUD\_REWRITE\_BASEURL}{OWNCLOUDREWRITEBASEURL}
        "Uber diesen Parameter kann auf Wunsch das Umschreiben der
        Basis-URL aktiviert werden, um diese zu k"urzen und von dem
        index.php-Anteil zu befreien. Da eine korrekte Funktion von
        ownCloud von vielen Dingen abh"angt, sollte dieser Parameter
        mit Bedacht gesetzt werden um Fehlfunktionen zu vermeiden.

        G"ultige Werte: yes, no

        Beispiel: \texttt{OWNCLOUD\_REWRITE\_BASEURL='yes'}

    \config{OWNCLOUD\_SECURITY\_LOWERING}{OWNCLOUD\_SECURITY\_LOWERING}{OWNCLOUDSECURITYLOWERING}
        "Uber diesen Parameter k"onnen auf Wunsch die Systemsicherheit
        reduzierende Einstellungen aktiviert werden. Standardm"a"sig
        werden im Paket die ownCloud-spezifischen Vorgaben zur H"artung
        des Systems ber"ucksichtigt. Durch Aktivierung der folgenden
        Parameter wird die Systemsicherheit zu Gunsten der Funktionalit"at
        herab gesetzt.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{OWNCLOUD\_SECURITY\_LOWERING='no'}

    \config{OWNCLOUD\_SECURITY\_HTACCESS\_RW}{OWNCLOUD\_SECURITY\_HTACCESS\_RW}{OWNCLOUDSECURITYHTACCESSRW}
        "Uber diesen Parameter kann auf Wunsch die .htaccess-Datei
        im Dokumentenstammverzeichnis f"ur den Account unter dem der
        Webserver betrieben wird, beschreibbar gemacht werden. Dies
        erlaubt die Anpassung von PHP-spezifischen Einstellungen
        "uber die ownCloud-Oberfl"ache.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{OWNCLOUD\_SECURITY\_HTACCESS\_RW='no'}

%%  JED - show this description only in the help file
 %  \config{OWNCLOUD\_SECURITY\_UPDATER\_APP}{OWNCLOUD\_SECURITY\_UPDATER\_APP}{OWNCLOUDSECURITYUPDATERAPP}
 %      "Uber diesen Parameter kann auf Wunsch die Updater App aktiviert
 %      werden, sodass es moglich ist die ownCloud-Software am \eisfair-Paket
 %      vorbei zu aktualisieren.
 %      \hinweis{Es ist zu beachten, dass es in diesem Fall zuk"unftig
 %          eventuell nicht mehr m"oglich sein wird das ownCloud-Paket
 %          zu aktualisieren, da dieses keine von den Vorgaben
 %          abweichenden Dateiversionen unterst"utzt. Als Resultat kann
 %          ownCloud g"anzlich au"ser Funktion gesetzt werden.}
 %
 %      G"ultige Werte: yes, no
 %
 %      Standardeinstellung: \texttt{OWNCLOUD\_SECURITY\_UPDATER\_APP='no'}

    \config{OWNCLOUD\_SMTP\_MANUAL\_CONFIGURATION}{OWNCLOUD\_SMTP\_MANUAL\_CONFIGURATION}{OWNCLOUDSMTPMANUALCONFIGURATION}
        "Uber diesen Parameter wird festgelegt, ob die Konfiguration des
        zu verwendenden SMTP-Servers, welcher f"ur den Versand von Nachrichten
        verwendet wird, manuell erfolgen soll oder nicht. Standardm"a"sig
        werden Nachrichten automatisch "uber einen lokale installierten
        SMTP-Server versandt, wenn ein installierte mail-, msmtp- oder
        ssmtp-Paket gefunden wird.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{OWNCLOUD\_SMTP\_MANUAL\_CONFIGURATION='no'}

    \config{OWNCLOUD\_SMTP\_HOST}{OWNCLOUD\_SMTP\_HOST}{OWNCLOUDSMTPHOST}
        "Uber diesen Parameter wird der Hostname des SMTP-Servers
        angegeben "uber den ausgehende Nachrichten Versand werden
        sollen.

        G"ultige Werte: Hostname oder IP-Adresse

        Standardeinstellung: \texttt{OWNCLOUD\_SMTP\_HOST='127.0.0.1'}

    \config{OWNCLOUD\_SMTP\_AUTH}{OWNCLOUD\_SMTP\_AUTH}{OWNCLOUDSMTPAUTH}
        "Uber diesen Parameter wird festgelegt, ob eine Authentifizierung
        am SMTP-Server erfolgen und falls ja, welche Authentifizierungsmethode
        daf"ur verwendet werden soll.

        G"ultige Werte: none, login

        Standardeinstellung: \texttt{OWNCLOUD\_SMTP\_AUTH='none'}

    \config{OWNCLOUD\_SMTP\_AUTH\_USER}{OWNCLOUD\_SMTP\_AUTH\_USER}{OWNCLOUDSMTPAUTHUSER}
        Wurde der Wert des Parameters \jump{OWNCLOUDSMTPAUTH}{OWNCLOUD\_SMTP\_AUTH}
        nicht auf 'none' gesetzt, so kann "uber diesen Parameter bei Bedarf ein
        Login festgelegt werden, welcher f"ur die Anmeldung am SMTP-Server
        verwendet werden soll.

        G"ultige Werte: Login

        Standardeinstellung: \texttt{OWNCLOUD\_SMTP\_AUTH\_USER=$''$}

    \config{OWNCLOUD\_SMTP\_AUTH\_PASS}{OWNCLOUD\_SMTP\_AUTH\_PASS}{OWNCLOUDSMTPAUTHPASS}
        Wurde der Wert des Parameters \jump{OWNCLOUDSMTPAUTH}{OWNCLOUD\_SMTP\_AUTH}
        nicht auf 'none' gesetzt, so kann "uber diesen Parameter bei Bedarf ein
        Kennwort festgelegt werden, welches f"ur die Anmeldung am SMTP-Server
        verwendet werden soll.

        G"ultige Werte: Kennwort

        Standardeinstellung: \texttt{OWNCLOUD\_SMTP\_AUTH\_PASS=$''$}

    \config{OWNCLOUD\_SMTP\_TRANSPORT}{OWNCLOUD\_SMTP\_TRANSPORT}{OWNCLOUDSMTPTRANSPORT}
        "Uber diesen Parameter wird festgelegt, ob als Transportprotokoll
        das unverschl"usselte SMTP (default) oder eines der verschl"usselten
        Protokolle SMTPS (ssl) oder SMTP "uber TLS (tls) verwendet werden soll.

        G"ultige Werte: default, ssl, tls

        Standardeinstellung: \texttt{OWNCLOUD\_SMTP\_TRANSPORT='default'}

    \config{OWNCLOUD\_APPSTORE\_ENABLED}{OWNCLOUD\_APPSTORE\_ENABLED}{OWNCLOUDAPPSTOREENABLED}
        "Uber diesen Parameter wird festgelegt, ob Anwender eigene Apps
        installieren d"urfen oder nicht. Wenn dieser Parameter auf den
        Wert 'yes' gesetzt wird, so muss mindestens ein Apps-Verzeichnis
        beschreibbar sein, d.h. einmal
        \jump{OWNCLOUDAPPSxWRITEABLE}{OWNCLOUD\_APPS\_x\_WRITEABLE='yes'} gesetzt
        sein.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{OWNCLOUD\_APPSTORE\_ENABLED='no'}

    \config{OWNCLOUD\_APPS\_N (Optionaler Parameter)}{OWNCLOUD\_APPS\_N}{OWNCLOUDAPPSN}
        "Uber diesen Parameter wird die Anzahl der zus"atzlich zu konfigurierenden
        Apps-Verzeichnisse festgelegt.

        Wird dieser Parameter nicht gesetzt, so werden die folgenden
        Verzeichnispfade verwendet:

        \texttt{/var/www/htdocs/owncloud/apps  - Lesezugriff \\
                /var/www/htdocs/owncloud/apps2 - Schreib-/Lesezugriff}

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{OWNCLOUD\_APPS\_N='1'}

    \config{OWNCLOUD\_APPS\_x\_DIR (Optionaler Parameter)}{OWNCLOUD\_APPS\_x\_DIR}{OWNCLOUDAPPSxDIR}
        "Uber diesen Parameter wird ein zus"atzliches Apps-Verzeichnis festgelegt
        in welchem ownCloud seine Apps, d.h. optionale Programme, ablegt.\\
        \hinweis{Standardm"a"sig wird neben dem eigentlichen Verzeichnis
            '/apps' (Lesezugriff) noch ein weiteres Verzeichnis
            '/apps2' (Schreib-/Lesezugriff) angelegt, in welchem alle
            von Anwendern herunter geladenen Apps abgelegt werden.}

        Wird dieser Parameter nicht gesetzt, so werden die folgenden
        Verzeichnispfade verwendet:

        \texttt{/var/www/htdocs/owncloud/apps  - Lesezugriff \\
                /var/www/htdocs/owncloud/apps2 - Schreib-/Lesezugriff}

        G"ultige Werte: absolute Pfadangabe

        Beispiel: \texttt{OWNCLOUD\_APPS\_1\_DIR='/var/www/htdocs/owncloud/apps2'}

    \config{OWNCLOUD\_APPS\_x\_URL (Optionaler Parameter)}{OWNCLOUD\_APPS\_x\_URL}{OWNCLOUDAPPSxURL}
        "Uber diesen Parameter wird der HTTP-Pfad zum zus"atzlichen
        Apps-Verzeichnis festgelegt in welchem ownCloud seine Apps,
        d.h. optionale Programme, ablegt.

        Wird dieser Parameter nicht gesetzt, so wird standardm"a"sig der
        folgende HTTP-Pfad verwendet:

        \texttt{/apps\\
                /apps2}

        G"ultige Werte: absolute Pfadangabe

        Beispiel: \texttt{OWNCLOUD\_APPS\_1\_URL='/apps2'}

    \config{OWNCLOUD\_APPS\_x\_WRITEABLE (Optionaler Parameter)}{OWNCLOUD\_APPS\_x\_WRITEABLE}{OWNCLOUDAPPSxWRITEABLE}
        "Uber diesen Parameter wird festgelegt, ob das "uber den Parameter
        \jump{OWNCLOUDAPPSxDIR}{OWNCLOUD\_APPS\_x\_DIR} festgelegte,
        zus"atzliche Verzeichnis beschreibbar ist oder nicht, d.h. ob es
        von Anwendern zum Abspeichern eigener Apps verwendet werden kann.\\
        Nur wenn mindestens ein Verzeichnis beschreibbar ist, kann "uber
        den Parameter \jump{OWNCLOUDAPPSTOREENABLED}{OWNCLOUD\_APPSTORE\_ENABLED}
        der Zugriff auf den ownCloud App-Store freigeschaltet werden.

        Wird dieser Parameter nicht gesetzt, so werden die folgenden
        Zugriffe verwendet:

        \texttt{/var/www/htdocs/owncloud/apps  - Lesezugriff\\
                /var/www/htdocs/owncloud/apps2 - Schreib-/Lesezugriff}

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{OWNCLOUD\_APPS\_1\_WRITEABLE='no'}

    \config{OWNCLOUD\_DEFAULT\_THEME (Optionaler Parameter)}{OWNCLOUD\_DEFAULT\_THEME}{OWNCLOUDDEFAULTTHEME}
        "Uber diesen Parameter wird das standardm"a"sig zu verwendende Thema
        f"ur ownCloud festgelegt. Bei der Eingabe wird gepr"uft, ob sich ein
        Ordner gleichen Namens im Unterverzeichnis ./themes befindet bevor
        die Einstellung "ubernommen wird. Wird dieser Parameter nicht gesetzt,
        so wird das ownCloud-Standardthema verwendet.

        G"ultige Werte: existierendes ownCloud-Thema

        Standardeinstellung: \texttt{OWNCLOUD\_DEFAULT\_THEME=$''$}

    \config{OWNCLOUD\_SESSION\_LIFETIME (Optionaler Parameter)}{OWNCLOUD\_SESSION\_LIFETIME}{OWNCLOUDSESSIONLIFETIME}
        "Uber diesen Parameter wird die maximale Lebensdauer einer
        Anmeldesitzung festgelegt. Wird der gesetzte Zeitrahmen "uberschritten,
        so wird eine Anmeldesitzung automatisch beendet. Wird dieser Parameter
        nicht gesetzt, so bleibt eine Sitzungsabmeldung unbefristet g"ultig.

        G"ultige Werte: Zeit in Sekunden

        Beispiel: \texttt{OWNCLOUD\_SESSION\_LIFETIME='86400'}

    \config{OWNCLOUD\_LOG\_TYPE (Optionaler Parameter)}{OWNCLOUD\_LOG\_TYPE}{OWNCLOUDLOGTYPE}
        "Uber diesen Parameter wird eingestellt, wie Logmeldungen gespeichert
        werden sollen. Wird 'owncloud' gew"ahlt, so werden alle Meldungen
        in eine separate Logdatei mit Namen 'owncloud.log' gespeichert.
        Durch Auswahl von 'syslog' wird hingegen der Standard-Syslog-Mechanismus
        genutzt.

        G"ultige Werte: owncloud, syslog

        Standardeinstellung: \texttt{OWNCLOUD\_LOG\_TYPE='owncloud'}

    \config{OWNCLOUD\_LOG\_COUNT}{OWNCLOUD\_LOG\_COUNT}{OWNCLOUDLOGCOUNT}
        "Uber diesen Parameter wird eingestellt, wie viele Logdateien
        vorgehalten werden sollen. Wird dieser Wert "uberschritten, so
        wird die "alteste Logdatei gel"oscht.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{OWNCLOUD\_LOG\_COUNT='10'}

    \config{OWNCLOUD\_LOG\_INTERVAL}{OWNCLOUD\_LOG\_INTERVAL}{OWNCLOUDLOGINTERVAL}
        Dieser Parameter bestimmt in welchen Intervallen die Logdateien
        archiviert werden sollen. Zur Auswahl stehen die Schl"usselw"orter
        `daily' - t"aglich, `weekly' - w"ochentlich und `monthly - monatlich.

        G"ultige Werte: daily, weekly, monthly

        Standardeinstellung: \texttt{OWNCLOUD\_LOG\_INTERVAL='weekly'}

    \config{OWNCLOUD\_CRON\_SCHEDULE (Optionaler Parameter)}{OWNCLOUD\_CRON\_SCHEDULE}{OWNCLOUDCRONSCHEDULE}
        "Uber diesen Parameter wird festgelegt zu welchem Zeitpunkt bzw. in
        welchem Intervall automatisch Hintergrundarbeiten durchgef"uhrt
        werden sollen. Die f"unf Teilparameter haben dabei folgende Bedeutung:\\
        1 - Minuten, 2 - Stunden, 3 - Tag des Monats, 4 - Monat, 5 - Wochentag.

        D.h. bei Verwendung der Standardeinstellung werden alle 14min
        Hintergrundarbeiten durchgef"uhrt. Wer N"aheres "uber die
        verwendete Befehlssyntax erfahren m"ochte, sollte "uber eine
        Internet-Suchmaschine nach `man' und `crontab' suchen.

        G"ultige Werte: Crontab-spezifischer Parametereintrag

        Standardeinstellung: \texttt{OWNCLOUD\_CRON\_SCHEDULE='*/14 * * * *'}
\end{description}

\section{Die Apps}

    "Uber ownCloud-Apps k"onnen zus"atzliche Funktionen in das ownCloud-Paket
    eingebunden werden. Hierbei obliegt es jedem Einzelnen zu entscheiden, ob
    er eine App, trotz eventueller Sicherheitsrisiken, aktivieren m"ochte oder
    nicht. Abh"angig von der jeweiligen App kann es notwendig sein, dass zuvor
    andere Programme installiert werden m"ussen, die "uber das ownCloud-Paket
    bzw. den \eisfair-Server nicht zur Verf"ugung gestellt werden.\\
    Es wird empfohlen, vor der Aktivierung einer App, die im jeweiligen
    App-Verzeichnis vorhandene Dokumentation zu lesen und sich "uber die
    ownCloud-Webseite (\url{https://marketplace.owncloud.com/}) weiter zu
    informieren.


\section{Verschiedenes}

\begin{description}
    \config{PHP-Fehlermeldungen}{PHP\_Fehlermeldungen}{PHPFehlermeldungen}
        Werden z.B. in der Ordner-Funktion Meldungen "uber nicht initialisierte
        Variablen angezeigt, so sollte man pr"ufen, ob in der Datei `/etc/php.ini'
        der folgende Parameter gesetzt wurde:\\

    \begin{verbatim}
;error_reporting  =  E_ALL                               # alt
error_reporting  =  E_ALL & ~E_NOTICE & ~E_USER_NOTICE   # neu
    \end{verbatim}
\end{description}
