Projekt

Allgemein

Profil

Herunterladen (6,93 KB) Statistiken
| Zweig: | Markierung: | Revision:
f8309cb7 Moritz Bunkus
<html><head>
06cb6b12 Moritz Bunkus
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
24cd95ba Bernd Bleßmann
<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.6.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
0e14ae06 Andreas Zenklusen
gehostet und kann <a class="ulink" href="https://github.com/kivitendo/kivitendo-erp/releases" target="_top">hier</a>
5898144e Michael Kruschinsky
heruntergeladen werden.</p><p>Das aktuelleste kivitendo ERP-Archiv
69302ec8 Jan Büren
(<code class="filename">kivitendo-erp-*.tgz</code>) wird dann im
0e14ae06 Andreas Zenklusen
Dokumentenverzeichnis des Webservers (z.B.
<code class="filename">/var/www/html/</code>,
<code class="filename">/srv/www/htdocs</code> oder
<code class="filename">/var/www/</code>) entpackt:</p><pre class="programlisting">cd /var/www
69302ec8 Jan Büren
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
c8a19933 Moritz Bunkus
Webserverkonfiguration benutzen, um auf das tatsächliche
0e14ae06 Andreas Zenklusen
Installationsverzeichnis zu verweisen.</p><p>Bei einer Neuinstallation von Version 3.1.0 oder später muß das
WebDAV Verzeichnis derzeit manuell angelegt werden:</p><pre class="programlisting">mkdir webdav</pre><p>Die Verzeichnisse <code class="filename">users</code>,
<code class="filename">spool</code> und <code class="filename">webdav</code> müssen für
den Benutzer beschreibbar sein, unter dem der Webserver läuft. Die
restlichen Dateien müssen für diesen Benutzer lesbar sein. Die Benutzer-
und Gruppennamen sind bei verschiedenen Distributionen unterschiedlich
(z.B. bei Debian/Ubuntu <code class="constant">www-data</code>, bei Fedora
3a81b209 Jan Büren
<code class="constant">apache</code> oder bei openSUSE
0e14ae06 Andreas Zenklusen
<code class="constant">wwwrun</code>).</p><p>Der folgende Befehl ändert den Besitzer für die oben genannten
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
<code class="filename">templates</code> und <code class="filename">users</code>
Unterverzeichnisse für jeden neuen Benutzer anlegen dürfen, der in
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
git. Hierfür muss ein git-Client installiert sein. Damit ist man sehr
viel flexibler für zukünftige Upgrades. Installations-Anleitung (bitte
8a1f99fd Jan Büren
die Pfade anpassen) bspw. wie folgt: </p><pre class="programlisting">cd /var/www/
524bf98c Jan Büren
git clone https://github.com/kivitendo/kivitendo-erp.git
cd kivitendo-erp/
6d831130 Moritz Bunkus
git checkout `git tag -l | egrep -ve "(alpha|beta|rc)" | tail -1`</pre><p>
5a2fd111 Werner Hahn
Erläuterung: Der Befehl wechselt zur letzten Stable-Version (git tag
98c56819 Werner Hahn
-l listet alle Tags auf, das egrep schmeisst alle Einträge mit alpha,
beta oder rc raus und das tail gibt davon den obersten Treffer
zurück). Sehr sinnvoll ist es, direkt im Anschluss einen eigenen
Branch zu erzeugen, um bspw. seine eigenen Druckvorlagen-Anpassungen
damit zu verwalten. Hierfür reicht ein simples </p><pre class="programlisting"> git checkout -b meine_eigenen_änderungen</pre><p>
8a1f99fd Jan Büren
nach dem letzten Kommando (weiterführende Informationen <a class="ulink" href="http://www-cs-students.stanford.edu/~blynn/gitmagic/index.html" target="_top">
5a2fd111 Werner Hahn
Git Magic</a>).</p><p>Ein beispielhafter Workflow für Druckvorlagen-Anpassungen von
3.4.1 nach 3.5: </p><pre class="programlisting">
8a1f99fd Jan Büren
$ git clone https://github.com/kivitendo/kivitendo-erp.git
$ cd kivitendo-erp/
bfcdd44a Jan Büren
$ git checkout release-3.4.1 # das ist ein alter release aus dem wir starten ...
$ git checkout -b meine_eigene_änderungen # unser lokaler branch - unabhängig von allen anderen
$ git add templates/mein_druck # das sind unsere druckvorlagen inkl. produktbilder
$ git commit -m "juhu tolle änderungen"

8a1f99fd Jan Büren
[meine_aenderungen 1d89e41] juhu tolle ändernungen
4 files changed, 380 insertions(+)
bfcdd44a Jan Büren
create mode 100644 templates/mein_druck/img/webdav/tesla.png
create mode 100644 templates/mein_druck/mahnung.tex
create mode 100644 templates/mein_druck/zahlungserinnerung_zwei.tex
create mode 100644 templates/mein_druck/zahlungserinnerung_zwei_invoice.tex
8a1f99fd Jan Büren
# 5 Jahre später ...
bfcdd44a Jan Büren
# webserver abschalten!

$ git checkout master
$ git pull # oder git fetch und danach ein stable release tag auswählen (s.o.)
$ git checkout meine_eigenen_änderungen
$ git rebase master
8a1f99fd Jan Büren
Zunächst wird der Branch zurückgespult, um Ihre Änderungen
darauf neu anzuwenden ...
bfcdd44a Jan Büren
Wende an: juhu tolle änderungen
$ service apache2 restart # webserver starten!
8a1f99fd Jan Büren
</pre><p>
</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>