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>