Revision 7baec94f
Von Ben Bleßmann vor 7 Monaten hinzugefügt
doc/dokumentation.xml | ||
---|---|---|
153 | 153 |
benötigt.</para> |
154 | 154 |
|
155 | 155 |
<para>Zusätzlich benötigt kivitendo einige Perl-Pakete, die nicht |
156 |
Bestandteil einer Standard-Perl-Installation sind. Um zu überprüfen, |
|
156 |
Bestandteil einer Standard-Perl-Installation sind. Um nach der |
|
157 |
Installation von Kivitendo zu überprüfen, |
|
157 | 158 |
ob die erforderlichen Pakete installiert und aktuell genug sind, wird |
158 | 159 |
ein Script mitgeliefert, das wie folgt aufgerufen wird:</para> |
159 | 160 |
|
... | ... | |
643 | 644 |
xreflabel="Manuelle Installation des Programmpaketes"> |
644 | 645 |
<title>Manuelle Installation des Programmpaketes</title> |
645 | 646 |
|
646 |
<para>Der aktuelle Stable-Release, bzw. beta Release wird bei github |
|
647 |
gehostet und kann <ulink |
|
648 |
url="https://github.com/kivitendo/kivitendo-erp/releases">hier</ulink> |
|
649 |
heruntergeladen werden.</para> |
|
647 |
<sect2 id="Installation-mit-git"> |
|
648 |
<title>Installation mit git</title> |
|
650 | 649 |
|
651 |
<para>Das aktuelleste kivitendo ERP-Archiv |
|
652 |
(<filename>kivitendo-erp-*.tgz</filename>) wird dann im |
|
653 |
Dokumentenverzeichnis des Webservers (z.B. |
|
654 |
<filename>/var/www/html/</filename>, |
|
655 |
<filename>/srv/www/htdocs</filename> oder |
|
656 |
<filename>/var/www/</filename>) entpackt:</para> |
|
657 |
|
|
658 |
<programlisting>cd /var/www |
|
659 |
tar xvzf kivitendo-erp-*.tgz</programlisting> |
|
660 |
|
|
661 |
<para>Wechseln Sie in das entpackte Verzeichnis:</para> |
|
662 |
|
|
663 |
<programlisting>cd kivitendo-erp</programlisting> |
|
664 |
|
|
665 |
<para>Alternativ können Sie auch einen Alias in der |
|
666 |
Webserverkonfiguration benutzen, um auf das tatsächliche |
|
667 |
Installationsverzeichnis zu verweisen.</para> |
|
668 |
|
|
669 |
<para>Bei einer Neuinstallation von Version 3.1.0 oder später muß das |
|
670 |
WebDAV Verzeichnis derzeit manuell angelegt werden:</para> |
|
671 |
|
|
672 |
<programlisting>mkdir webdav</programlisting> |
|
673 |
|
|
674 |
<para>Die Verzeichnisse <filename>users</filename>, |
|
675 |
<filename>spool</filename> und <filename>webdav</filename> müssen für |
|
676 |
den Benutzer beschreibbar sein, unter dem der Webserver läuft. Die |
|
677 |
restlichen Dateien müssen für diesen Benutzer lesbar sein. Die Benutzer- |
|
678 |
und Gruppennamen sind bei verschiedenen Distributionen unterschiedlich |
|
679 |
(z.B. bei Debian/Ubuntu <constant>www-data</constant>, bei Fedora |
|
680 |
<constant>apache</constant> oder bei openSUSE |
|
681 |
<constant>wwwrun</constant>).</para> |
|
682 |
|
|
683 |
<para>Der folgende Befehl ändert den Besitzer für die oben genannten |
|
684 |
Verzeichnisse auf einem Debian/Ubuntu-System:</para> |
|
685 |
|
|
686 |
<programlisting>chown -R www-data users spool webdav</programlisting> |
|
687 |
|
|
688 |
<para>Weiterhin muss der Webserver-Benutzer in den Verzeichnissen |
|
689 |
<filename>templates</filename> und <filename>users</filename> |
|
690 |
Unterverzeichnisse für jeden neuen Benutzer anlegen dürfen, der in |
|
691 |
kivitendo angelegt wird:</para> |
|
692 |
|
|
693 |
<programlisting>chown www-data templates users</programlisting> |
|
694 |
|
|
695 |
<note> |
|
696 | 650 |
<para>Wir empfehlen eine Installation mittels des Versionsmanager |
697 | 651 |
git. Hierfür muss ein git-Client installiert sein. Damit ist man sehr |
698 | 652 |
viel flexibler für zukünftige Upgrades. Installations-Anleitung (bitte |
... | ... | |
739 | 693 |
Wende an: juhu tolle änderungen |
740 | 694 |
$ service apache2 restart # webserver starten! |
741 | 695 |
</programlisting></para> |
742 |
</note> |
|
696 |
</sect2> |
|
697 |
|
|
698 |
<sect2 id="Installation_mit_Github"> |
|
699 |
<title>Installation über die Github Website</title> |
|
700 |
|
|
701 |
<para>Der aktuelle Stable-Release, bzw. beta Release wird bei github |
|
702 |
gehostet und kann <ulink |
|
703 |
url="https://github.com/kivitendo/kivitendo-erp/releases">hier</ulink> |
|
704 |
heruntergeladen werden.</para> |
|
705 |
|
|
706 |
|
|
707 |
<para>Das aktuelleste kivitendo ERP-Archiv |
|
708 |
(<filename>kivitendo-erp-*.tgz</filename>) wird dann im |
|
709 |
Dokumentenverzeichnis des Webservers (z.B. |
|
710 |
<filename>/var/www/html/</filename>, |
|
711 |
<filename>/srv/www/htdocs</filename> oder |
|
712 |
<filename>/var/www/</filename>) entpackt:</para> |
|
713 |
|
|
714 |
<programlisting>cd /var/www |
|
715 |
tar xvzf kivitendo-erp-*.tgz</programlisting> |
|
716 |
|
|
717 |
<para>Wechseln Sie in das entpackte Verzeichnis:</para> |
|
718 |
|
|
719 |
<programlisting>cd kivitendo-erp</programlisting> |
|
720 |
|
|
721 |
<para>Alternativ können Sie auch einen Alias in der |
|
722 |
Webserverkonfiguration benutzen, um auf das tatsächliche |
|
723 |
Installationsverzeichnis zu verweisen.</para> |
|
724 |
</sect2> |
|
725 |
|
|
726 |
<sect2 id="restliche-Verzeichnisse-erstellen-und-Besitzer-ändern"> |
|
727 |
<title>Restliche Verzeichnisse ändern und bearbeiten</title> |
|
728 |
|
|
729 |
<para>Die folgenden Schritte müssen nach der Installation mittels git |
|
730 |
oder der Github Website angewendet werden.</para> |
|
731 |
|
|
732 |
<para>Bei einer Neuinstallation von Version 3.1.0 oder später muss das |
|
733 |
WebDAV Verzeichnis derzeit manuell angelegt werden:</para> |
|
734 |
|
|
735 |
<programlisting>mkdir webdav</programlisting> |
|
736 |
|
|
737 |
<para>Die Verzeichnisse <filename>users</filename>, |
|
738 |
<filename>spool</filename> und <filename>webdav</filename> müssen für |
|
739 |
den Benutzer beschreibbar sein, unter dem der Webserver läuft. Die |
|
740 |
restlichen Dateien müssen für diesen Benutzer lesbar sein. Die Benutzer- |
|
741 |
und Gruppennamen sind bei verschiedenen Distributionen unterschiedlich |
|
742 |
(z.B. bei Debian/Ubuntu <constant>www-data</constant>, bei Fedora |
|
743 |
<constant>apache</constant> oder bei openSUSE |
|
744 |
<constant>wwwrun</constant>).</para> |
|
745 |
|
|
746 |
<para>Der folgende Befehl ändert den Besitzer für die oben genannten |
|
747 |
Verzeichnisse auf einem Debian/Ubuntu-System:</para> |
|
748 |
|
|
749 |
<programlisting>chown -R www-data users spool webdav</programlisting> |
|
750 |
|
|
751 |
<para>Weiterhin muss der Webserver-Benutzer in den Verzeichnissen |
|
752 |
<filename>templates</filename> und <filename>users</filename> |
|
753 |
Unterverzeichnisse für jeden neuen Benutzer anlegen dürfen, der in |
|
754 |
kivitendo angelegt wird:</para> |
|
755 |
|
|
756 |
<programlisting>chown www-data templates</programlisting> |
|
757 |
</sect2> |
|
758 |
|
|
759 |
|
|
760 |
|
|
761 |
|
|
762 |
|
|
743 | 763 |
</sect1> |
744 | 764 |
|
745 | 765 |
<sect1 id="config.config-file"> |
... | ... | |
1027 | 1047 |
Datenbank zum Beispiel:</para> |
1028 | 1048 |
|
1029 | 1049 |
<programlisting>local all kivitendo password |
1030 |
host all kivitendo 127.0.0.1 255.255.255.255 password</programlisting>
|
|
1050 |
host all kivitendo 127.0.0.1 255.255.255.255 scram-sha-256</programlisting>
|
|
1031 | 1051 |
</sect2> |
1032 | 1052 |
|
1033 | 1053 |
<sect2 id="Erweiterung-für-servergespeicherte-Prozeduren"> |
... | ... | |
1118 | 1138 |
</note> |
1119 | 1139 |
|
1120 | 1140 |
<para>Der Zugriff auf das Programmverzeichnis muss in der Apache |
1121 |
Webserverkonfigurationsdatei <literal>httpd.conf</literal> eingestellt
|
|
1141 |
Webserverkonfigurationsdatei <literal>000-default.conf</literal> eingestellt
|
|
1122 | 1142 |
werden. Fügen Sie den folgenden Abschnitt dieser Datei oder einer |
1123 | 1143 |
anderen Datei hinzu, die beim Starten des Webservers eingelesen |
1124 | 1144 |
wird:</para> |
Auch abrufbar als: Unified diff
Dokumentation überarbeitet
- Reihenfolge Git-Installation
- Kleinigkeiten Postgres- und Apache-Config