Buchungsjournal: Spalte f. Bilanz im Bericht direkt hinter Umsatzsteuer
[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.6.1: 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>Das aktuelleste kivitendo ERP-Archiv
6       (<code class="filename">kivitendo-erp-*.tgz</code>) wird dann 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-*.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 "(alpha|beta|rc)" | tail -1`</pre><p>
32         Erläuterung: Der Befehl wechselt zur letzten Stable-Version (git tag
33         -l listet alle Tags auf, das egrep schmeisst alle Einträge mit alpha,
34         beta oder rc raus und das tail gibt davon den obersten Treffer
35         zurück). Sehr sinnvoll ist es, direkt im Anschluss einen eigenen
36         Branch zu erzeugen, um bspw. seine eigenen Druckvorlagen-Anpassungen
37         damit zu verwalten. Hierfür reicht ein simples </p><pre class="programlisting">  git checkout -b meine_eigenen_änderungen</pre><p>
38         nach dem letzten Kommando (weiterführende Informationen <a class="ulink" href="http://www-cs-students.stanford.edu/~blynn/gitmagic/index.html" target="_top">
39         Git Magic</a>).</p><p>Ein beispielhafter Workflow für Druckvorlagen-Anpassungen von
40         3.4.1 nach 3.5: </p><pre class="programlisting">
41 $ git clone https://github.com/kivitendo/kivitendo-erp.git
42 $ cd kivitendo-erp/
43 $ git checkout release-3.4.1                # das ist ein alter release aus dem wir starten ...
44 $ git checkout -b meine_eigene_änderungen   # unser lokaler branch - unabhängig von allen anderen
45 $ git add templates/mein_druck              # das sind unsere druckvorlagen inkl. produktbilder
46 $ git commit -m "juhu tolle änderungen"
47
48 [meine_aenderungen 1d89e41] juhu tolle ändernungen
49  4 files changed, 380 insertions(+)
50  create mode 100644 templates/mein_druck/img/webdav/tesla.png
51  create mode 100644 templates/mein_druck/mahnung.tex
52  create mode 100644 templates/mein_druck/zahlungserinnerung_zwei.tex
53  create mode 100644 templates/mein_druck/zahlungserinnerung_zwei_invoice.tex
54
55 # 5 Jahre später ...
56 # webserver abschalten!
57
58 $ git checkout master
59 $ git pull                                  # oder git fetch und danach ein stable release tag auswählen (s.o.)
60 $ git checkout meine_eigenen_änderungen
61 $ git rebase master
62
63 Zunächst wird der Branch zurückgespult, um Ihre Änderungen
64 darauf neu anzuwenden ...
65 Wende an: juhu tolle änderungen
66 $ service apache2 restart                   # webserver starten!
67 </pre><p>
68             </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>