Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- de:install:debian [2015-05-29 19:59] – [Installation] 87.146.41.131
+++ de:install:debian [2023-05-04 11:10] (aktuell) – Link Debian-Wiki saggi
@@ Zeile 1: / Zeile 1: @@
-====== DokuWiki-Paket für Debian ======
+====== DokuWiki auf Debian, Ubuntu und abgeleiteten Distributionen ======
-DokuWiki ist als ein offizielles Debian-Paket erhältlich und über das Paketmanagement von Debian installierbar.
-  * [[http://packages.qa.debian.org/d/dokuwiki.html|Overview of dokuwiki source package]]
+Ein Debian-Paket für DokuWiki existiert im offiziellen Debian-Repository und kann mit den üblichen Debian-Werkzeugen installiert werden.
-  * [[http://bugs.debian.org/cgi-bin/pkgreport.cgi?pkg=dokuwiki|Debian Bug report logs: package dokuwiki]]
-  * [[http://packages.debian.org/search?suite=squeeze&section=all&arch=any&searchon=names&keywords=dokuwiki|Die Abhängigkeiten sind ordentlich]]
-===== News =====
+Wir raten jedoch generell davon ab, DokuWiki als Debian-Paket zu installieren, und zwar aus mehreren Gründen:
-{{rss>http://packages.qa.debian.org/d/dokuwiki/news.rss20.xml}}
+  * Das Paket ist veraltet und verwendet eine ältere Version von DokuWiki, was es mit vielen neueren Plugins inkompatibel macht
+  * Das Paket verwendet eine andere Verzeichnisstruktur, was zu Problemen mit einigen Plugins führen kann und einige allgemeine Dokumentationen unbrauchbar macht
+  * Das Paket ersetzt einige der internen Bibliotheken von DokuWiki durch Debian-Paketversionen, was wiederum zu Inkompatibilitäten führen kann
-===== Installation =====
-Das offizielle [[http://www.debian.org/|Debian]] Debian-Paket von DokuWiki kann mit "apt-get" wie folgt installiert werden:
+===== DokuWiki Debian-Paket =====
-<file>
+Details zum offiziellen Paket finden Sie in diesen Quellen:
-# apt-get update
-# apt-get install dokuwiki
-</file>
-Die Installation steht dann unter http://[server]/dokuwiki bereit.
+  * [[https://packages.debian.org/dokuwiki|Dokuwiki-Paket-Übersicht]]
+  * [[https://packages.qa.debian.org/dokuwiki|Technische Übersicht und Nachrichten]]
+  * [[https://bugs.debian.org/dokuwiki|Fehlerberichte]]
-Erscheint die Fehlermeldung: ''You don't have permission to access /dokuwiki on this server.''
+Zusätzliche Details können auf der [[https://wiki.debian.org/DokuWiki|DokuWiki-Seite im Debian-Wiki]] gefunden werden.
-Muß in der Datei ''/etc/apache2/sites-available/default'' folgender Eintrag hinzugefügt werden:
+===== Empfohlene Einrichtung =====
-<file>
+Anstatt sich auf das Debian-Paket zu verlassen, wird empfohlen, einfach den Webserver und PHP über den Paketmanager zu installieren und DokuWiki aus den Quellen zu installieren.
-<Directory /usr/share/dokuwiki/>
-  Options FollowSymLinks
-  AllowOverride None
-  Order allow,deny
-  allow from all
-</Directory>
-</file>
+Für eine einfache Apache mod_php-Installation kann dies wie folgt aussehen:
-===== Squeeze Installation =====
+  - Bereiten Sie das System vor, laden Sie die neueste DokuWiki-Version herunter und entpacken Sie sie:<code bash>
+$> sudo apt update
+$> sudo apt install php libapache2-mod-php php-xml php-mbstring php-zip php-intl php-gd
+$> sudo systemctl restart apache2.service
+$> wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
+$> tar xzvf dokuwiki-stable.tgz
+$> sudo mv dokuwiki-*a /var/www/html/dokuwiki
+$> sudo chown -R www-data:www-data /var/www/html/dokuwiki
+</code>
-Da zu den abhängigen Paketen ''php5'' gehört und das eine ganze Menge im Schlepptau hat, einschließlich ''apache2'', empfehle ich zunächst bei Apache als Webserver zu bleiben. Am Ende der Installation besteht die Möglichkeit DokuWiki entweder automatisch für ''apache'' oder für ''nginx'' konfigurieren zu lassen oder dies selber für einen anderen Webserver vorzunehmen.\\
+  - **Optional**\\ Wenn Sie eine Firewall verwenden, lassen Sie den HTTP-Verkehr zu. Für die Uncomplicated Firewall (ufw) lautet der Befehl wie folgt:<code bash>
+sudo ufw allow 'WWW Full'
-Bleibt man erst einmal beim ''apache2'', wird meiner Erfahrung nach, alles sofort auf Anhieb funktionieren.
-Für den Fall, dass man doch mal ''nginx'' testen möchte:
-<code>
-# killall apache
-# apt-get install nginx
-# dpkg-reconfigure dokuwiki
 </code>
-''nginx'' sollte funktionieren, ''Dokuwiki'' wird es nicht. Man bekommt Fehlercode 503 - Zugriff verweigert. Die automatische Konfiguration für nginx scheint also nicht zu tun, ich vermute mal stark irgendein Besitzer-Problem.
+  - Rufen Sie Ihren Webbrowser unter %%http://localhost/dokuwiki/install.php%% auf, um Ihre neue DokuWiki-Installation zu konfigurieren.
-===== Lenny Installation =====
-Wenn du das aktuellste Paket installieren möchtest:
-<file>
-# cd /tmp
-# wget http://http.us.debian.org/debian/pool/main/d/dokuwiki/dokuwiki_0.0.20080505-5_all.deb
-# dpkg -i dokuwiki_0.0.20080505-3_all.deb
-</file>
-Für die uneingeschränkte Berechtigung aus dem LAN oder dem Internet, muss die Datei **/etc/apache/conf/dokuwiki.conf** editiert werden. Der Eintrag **127.0.0.0** wird dabei durch **All** ersetzt.
-bei Apache2: /etc/apache2/conf.d/dokuwiki.conf
-Für eine vollständige Konfiguration, die ein Login und die Administration im Wiki ermöglicht, müssen einige ACLs erlaubt und eine Konfigurationsdatei geändert werden. Dafür werden Rootrechte benötigt.
-  - kopieren Sie /etc/dokuwiki/local.php.dist nach /etc/dokuwiki/local.php und passen Sie die Dateien an Ihre Bedürfnisse an. Stellen Sie dabei sicher, dass die Option "useacl" aktiviert ist.
-  - www-data die Berechtigung zum Lesen und Schreiben der Konfigurationsdateien geben:
-     * <file>chown -R www-data /etc/dokuwiki/</file>
-     * <file>chown -R www-data /usr/share/dokuwiki/lib/</file>
-  - Kopieren Sie die Beispieldateien zur Authentifizierung an die Stelle, an der sie von DokuWiki benötigt werden.
-     * <file>cp /etc/dokuwiki/acl.auth.php.dist /var/lib/dokuwiki/acl/acl.auth.php</file>
-     * <file>cp /etc/dokuwiki/users.auth.php.dist /var/lib/dokuwiki/acl/users.auth.php</file>
-===== Bugs =====
-Bitte berichten Sie Bugs im Debian-Paket an [[http://bugs.debian.org/|Debian-Fehlerdatenbank]]. Eine aktuelle Liste der Bugs für das Paket ist unter [[http://bugs.debian.org/dokuwiki|Bugreport]] zu finden.
-===== Issues =====
-Packaging DokuWiki includes some issues to be dealt with to make the package compliant with the [[http://www.debian.org/doc/debian-policy/|Debian policy]].
-  * **File locations** The page files are located at ''/usr/share/dokuwiki'' and the data directory in ''/var/lib/dokuwiki''. The natural place for the configuration files under ''conf/'' in the original source is ''/etc/dokuwiki''. However, the user authentication database file ''acl.auth.php'' and ''users.auth.php'' can't be under ''/etc'' since they need to be writable by the web server. For this reason they are located to ''/var/lib/dokuwiki/acl''.
-  * **Removing buttons** Due to [[http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=313437|feedback]], the CC and PayPal buttons in the page footer were removed.
-===== Questions and answers ======
-Feel free to ask questions here:
-:?: After apt-get install dokuwiki, I am faced with a system running a dokuwiki version from January 2009.  When started this reports about a dozen of security alerts at top of page.  How do I install the newest version using an existing debian system?
-:!: FIXME
-:?: Where does Debian put the data dirs?
-:!: Under /var/lib/dokuwiki as the [[http://www.debian.org/doc/debian-policy/|Debian Policy]] instructs.
-:?: Can you briefly list all steps necessary for multiple (separate) installations sharing the codebase?
-:!: A multisite/wikifarm solution for the Debian package is now the #2 item on the TODO list right after releasing the latest upstream version officially.
-:?: Can you install it on ubuntu.
-:!: Yes, it is in the repository, but how to get it to work is not explained. Instead, you may install Apache2 with php5 and unpack the tar-package in /var/www. Then, follow the instructions in dokuwiki manual concerning permissions and install.php from a browser. Then, it works out of the box provided php works on your box.
-:?: How do I restore data from an older install on another machine?
-:!: This is not an official answer, but it worked for me.
-  *<code># mv /var/lib/dokuwiki /tmp</code>On the new installed docuwiki the  directories are empty, get rid of them. Moving to tmp means they will be deleted on next reboot, but you can still retrieve data before reboot if you goof up.
-  *<code># cp -av /path/to/old/machine/var/lib/dokuwiki /var/lib/</code>You did back up your old data somewhere, right?
-  *<code># cp -av /path/to/old/machine/etc/dokuwiki/local.php /etc/dokuwiki</code>
-  *Login to newly populated wiki and administratively install all plugins that you had before. You will need to perform step 2) of the above "Lenny install" instructions to install plugins
-:?: Please add a comment concerning the installation of addons/extensions?