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.1-beta: 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 "(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, beta
  34         oder rc raus und das tail gibt davon den obersten Treffer zurück).
  35         Sehr sinnvoll ist es, direkt im Anschluss einen eigenen Branch zu
  36         erzeugen, um bspw. seine eigenen Druckvorlagen-Anpassungen damit zu
  37         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 der aktuelle release, den wir wollen
  44 $ git add templates/fullhouse    # das sind unsere druckvorlagen inkl. produktbilder
  45 $ git commit -m "juhu tolle ändernungen"
  46 [meine_aenderungen 1d89e41] juhu tolle ändernungen
  47  4 files changed, 380 insertions(+)
  48  create mode 100644 templates/fullhouse/img/webdav/tesla.png
  49  create mode 100644 templates/fullhouse/mahnung.tex
  50  create mode 100644 templates/fullhouse/zahlungserinnerung_zwei.tex
  51  create mode 100644 templates/fullhouse/zahlungserinnerung_zwei_invoice.tex
  52
  53 # 5 Jahre später ...
  54
  55 $ git fetch
  56 $ git rebase --onto release-3.5.0 release-3.4.1 meine_aenderungen
  57 Zunächst wird der Branch zurückgespult, um Ihre Änderungen
  58 darauf neu anzuwenden ...
  59 Wende an: juhu tolle ändernungen
  60 $ service apache2 restart
  61 </pre><p>
  62             </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>