doc/html/ch02s04.html

   1 <html><head>
   2       <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   3    <title>2.4. 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.9.2: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s03.html" title="2.3. Installation mittels Ansible auf Ubuntu 22.04"><link rel="next" href="ch02s05.html" title="2.5. 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.4. Manuelle Installation des Programmpaketes</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s03.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="ch02s05.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.4. Manuelle Installation des Programmpaketes"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Manuelle-Installation-des-Programmpaketes"></a>2.4. Manuelle Installation des Programmpaketes</h2></div></div></div><div class="sect2" title="2.4.1. Installation mit git"><div class="titlepage"><div><div><h3 class="title"><a name="Installation-mit-git"></a>2.4.1. Installation mit git</h3></div></div></div><p>Wir empfehlen eine Installation mittels des Versionsmanager
   4         git. Hierfür muss ein git-Client installiert sein. Damit ist man sehr
   5         viel flexibler für zukünftige Upgrades. Installations-Anleitung (bitte
   6         die Pfade anpassen) bspw. wie folgt: </p><pre class="programlisting">cd /var/www/
   7 git clone https://github.com/kivitendo/kivitendo-erp.git
   8 cd kivitendo-erp/
   9 git checkout `git tag -l | egrep -ve "(alpha|beta|rc)" | tail -1`</pre><p>
  10         Erläuterung: Der Befehl wechselt zur letzten Stable-Version (git tag
  11         -l listet alle Tags auf, das egrep schmeisst alle Einträge mit alpha,
  12         beta oder rc raus und das tail gibt davon den obersten Treffer
  13         zurück). Sehr sinnvoll ist es, direkt im Anschluss einen eigenen
  14         Branch zu erzeugen, um bspw. seine eigenen Druckvorlagen-Anpassungen
  15         damit zu verwalten. Hierfür reicht ein simples </p><pre class="programlisting">  git checkout -b meine_eigenen_änderungen</pre><p>
  16         nach dem letzten Kommando (weiterführende Informationen <a class="ulink" href="http://www-cs-students.stanford.edu/~blynn/gitmagic/index.html" target="_top">
  17         Git Magic</a>).</p><p>Ein beispielhafter Workflow für Druckvorlagen-Anpassungen von
  18         3.4.1 nach 3.5: </p><pre class="programlisting">
  19 $ git clone https://github.com/kivitendo/kivitendo-erp.git
  20 $ cd kivitendo-erp/
  21 $ git checkout release-3.4.1                # das ist ein alter release aus dem wir starten ...
  22 $ git checkout -b meine_eigene_änderungen   # unser lokaler branch - unabhängig von allen anderen
  23 $ git add templates/mein_druck              # das sind unsere druckvorlagen inkl. produktbilder
  24 $ git commit -m "juhu tolle änderungen"
  25
  26 [meine_aenderungen 1d89e41] juhu tolle ändernungen
  27  4 files changed, 380 insertions(+)
  28  create mode 100644 templates/mein_druck/img/webdav/tesla.png
  29  create mode 100644 templates/mein_druck/mahnung.tex
  30  create mode 100644 templates/mein_druck/zahlungserinnerung_zwei.tex
  31  create mode 100644 templates/mein_druck/zahlungserinnerung_zwei_invoice.tex
  32
  33 # 5 Jahre später ...
  34 # webserver abschalten!
  35
  36 $ git checkout master
  37 $ git pull                                  # oder git fetch und danach ein stable release tag auswählen (s.o.)
  38 $ git checkout meine_eigenen_änderungen
  39 $ git rebase master
  40
  41 Zunächst wird der Branch zurückgespult, um Ihre Änderungen
  42 darauf neu anzuwenden ...
  43 Wende an: juhu tolle änderungen
  44 $ service apache2 restart                   # webserver starten!
  45 </pre><p>
  46             </p></div><div class="sect2" title="2.4.2. Installation über die Github Website"><div class="titlepage"><div><div><h3 class="title"><a name="Installation_mit_Github"></a>2.4.2. Installation über die Github Website</h3></div></div></div><p>Der aktuelle Stable-Release, bzw. beta Release wird bei github
  47         gehostet und kann <a class="ulink" href="https://github.com/kivitendo/kivitendo-erp/tags" target="_top">hier</a>
  48         heruntergeladen werden.</p><p>Das aktuelleste kivitendo ERP-Archiv
  49         (<code class="filename">kivitendo-erp-*.tgz</code>) wird dann im
  50         Dokumentenverzeichnis des Webservers (z.B.
  51         <code class="filename">/var/www/html/</code>,
  52         <code class="filename">/srv/www/htdocs</code> oder
  53         <code class="filename">/var/www/</code>) entpackt:</p><pre class="programlisting">cd /var/www
  54 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
  55         Webserverkonfiguration benutzen, um auf das tatsächliche
  56         Installationsverzeichnis zu verweisen.</p></div><div class="sect2" title="2.4.3. Restliche Verzeichnisse ändern und bearbeiten"><div class="titlepage"><div><div><h3 class="title"><a name="restliche-Verzeichnisse-erstellen-und-Besitzer-%C3%A4ndern"></a>2.4.3. Restliche Verzeichnisse ändern und bearbeiten</h3></div></div></div><p>Die folgenden Schritte müssen nach der Installation mittels git
  57         oder der Github Website angewendet werden.</p><p>Bei einer Neuinstallation von Version 3.1.0 oder später muss das
  58         WebDAV Verzeichnis derzeit manuell angelegt werden:</p><pre class="programlisting">mkdir webdav</pre><p>Die Verzeichnisse <code class="filename">users</code>,
  59         <code class="filename">spool</code> und <code class="filename">webdav</code> müssen für
  60         den Benutzer beschreibbar sein, unter dem der Webserver läuft. Die
  61         restlichen Dateien müssen für diesen Benutzer lesbar sein. Die Benutzer-
  62         und Gruppennamen sind bei verschiedenen Distributionen unterschiedlich
  63         (z.B. bei Debian/Ubuntu <code class="constant">www-data</code>, bei Fedora
  64         <code class="constant">apache</code> oder bei openSUSE
  65         <code class="constant">wwwrun</code>).</p><p>Der folgende Befehl ändert den Besitzer für die oben genannten
  66         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
  67         <code class="filename">templates</code> und <code class="filename">users</code>
  68         Unterverzeichnisse für jeden neuen Benutzer anlegen dürfen, der in
  69         kivitendo angelegt wird:</p><pre class="programlisting">chown www-data templates</pre></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s03.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="ch02s05.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.3. Installation mittels Ansible auf Ubuntu 22.04&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.5. kivitendo-Konfigurationsdatei</td></tr></table></div></body></html>