dcdc56156e3d9be6016112964d17e3d2ce87a58a
[kivitendo-erp.git] / doc / html / ch02s03.html
1 <html><head>
2       <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
3    <title>2.3. Manuelle Installation des Programmpaketes</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s02.html" title="2.2. Benötigte Software und Pakete"><link rel="next" href="ch02s04.html" title="2.4. kivitendo-Konfigurationsdatei"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.3. Manuelle Installation des Programmpaketes</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s02.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch02s04.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.3. Manuelle Installation des Programmpaketes"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Manuelle-Installation-des-Programmpaketes"></a>2.3. Manuelle Installation des Programmpaketes</h2></div></div></div><p>Der aktuelle Stable-Release, bzw. beta Release wird bei github
4       gehostet und kann <a class="ulink" href="https://github.com/kivitendo/kivitendo-erp/releases" target="_top">hier</a>
5       heruntergeladen werden.</p><p>Die kivitendo ERP Installationsdatei
6       (<code class="filename">kivitendo-erp-3.4.1.tgz</code>) wird im
7       Dokumentenverzeichnis des Webservers (z.B.
8       <code class="filename">/var/www/html/</code>,
9       <code class="filename">/srv/www/htdocs</code> oder
10       <code class="filename">/var/www/</code>) entpackt:</p><pre class="programlisting">cd /var/www
11 tar xvzf kivitendo-erp-3.4.1.tgz</pre><p>Wechseln Sie in das entpackte Verzeichnis:</p><pre class="programlisting">cd kivitendo-erp</pre><p>Alternativ können Sie auch einen Alias in der
12       Webserverkonfiguration benutzen, um auf das tatsächliche
13       Installationsverzeichnis zu verweisen.</p><p>Bei einer Neuinstallation von Version 3.1.0 oder später muß das
14       WebDAV Verzeichnis derzeit manuell angelegt werden:</p><pre class="programlisting">mkdir webdav</pre><p>Die Verzeichnisse <code class="filename">users</code>,
15       <code class="filename">spool</code> und <code class="filename">webdav</code> müssen für
16       den Benutzer beschreibbar sein, unter dem der Webserver läuft. Die
17       restlichen Dateien müssen für diesen Benutzer lesbar sein. Die Benutzer-
18       und Gruppennamen sind bei verschiedenen Distributionen unterschiedlich
19       (z.B. bei Debian/Ubuntu <code class="constant">www-data</code>, bei Fedora
20       <code class="constant">apache</code> oder bei OpenSUSE
21       <code class="constant">wwwrun</code>).</p><p>Der folgende Befehl ändert den Besitzer für die oben genannten
22       Verzeichnisse auf einem Debian/Ubuntu-System:</p><pre class="programlisting">chown -R www-data users spool webdav</pre><p>Weiterhin muss der Webserver-Benutzer in den Verzeichnissen
23       <code class="filename">templates</code> und <code class="filename">users</code>
24       Unterverzeichnisse für jeden neuen Benutzer anlegen dürfen, der in
25       kivitendo angelegt wird:</p><pre class="programlisting">chown www-data templates users</pre><div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="system/docbook-xsl/images/note.png"></td><th align="left">Anmerkung</th></tr><tr><td align="left" valign="top"><p>Wir empfehlen eine Installation mittels des Versionsmanagager
26         git. Hierfür muss ein git-Client installiert sein. Damit ist man sehr
27         viel flexibler für zukünftige Upgrades. Installations-Anleitung (bitte
28         die Pfade anpassen) bspw. wie folgt: </p><pre class="programlisting">cd /var/www/
29 git clone https://github.com/kivitendo/kivitendo-erp.git
30 cd kivitendo-erp/
31 git checkout `git tag -l | egrep -ve "(beta|rc)" | tail -1`</pre><p>
32         Erläuterung: Der Befehl wechselt zur letzten Stable-Version (git tag -l listet
33        alle Tags auf, das egrep schmeisst alle Einträge mit beta oder rc raus und
34        das tail gibt davon den obersten Treffer zurück).
35
36         Sehr sinnvoll ist es, direkt im Anschluss einen eigenen Branch zu
37         erzeugen, um bspw. seine eigenen Druckvorlagen-Anpassungen damit zu
38         verwalten. Hierfür reicht ein simples </p><pre class="programlisting">  git checkout -b meine_eigenen_änderungen</pre><p>
39         nach dem letzten Kommando (weiterführende Informationen <a class="ulink" href="http://www-cs-students.stanford.edu/~blynn/gitmagic/index.html" target="_top">
40         Git Magic</a>).</p><p>
41         Ein beispielhafter Workflow für Druckvorlagen-Anpassungen von 3.4.1 nach 3.5:
42         </p><pre class="programlisting">
43 $ git clone https://github.com/kivitendo/kivitendo-erp.git
44 $ cd kivitendo-erp/
45 $ git checkout release-3.4.1     # das ist der aktuelle release, den wir wollen
46 $ git add templates/fullhouse    # das sind unsere druckvorlagen inkl. produktbilder
47 $ git commit -m "juhu tolle ändernungen"
48 [meine_aenderungen 1d89e41] juhu tolle ändernungen
49  4 files changed, 380 insertions(+)
50  create mode 100644 templates/fullhouse/img/webdav/tesla.png
51  create mode 100644 templates/fullhouse/mahnung.tex
52  create mode 100644 templates/fullhouse/zahlungserinnerung_zwei.tex
53  create mode 100644 templates/fullhouse/zahlungserinnerung_zwei_invoice.tex
54
55 # 5 Jahre später ...
56
57 $ git fetch
58 $ git rebase --onto release-3.5.0 release-3.4.1 meine_aenderungen
59 Zunächst wird der Branch zurückgespult, um Ihre Änderungen
60 darauf neu anzuwenden ...
61 Wende an: juhu tolle ändernungen
62 $ service apache2 restart
63 </pre><p>
64             </p></td></tr></table></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s02.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch02s04.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.2. Benötigte Software und Pakete&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;2.4. kivitendo-Konfigurationsdatei</td></tr></table></div></body></html>