doc/html/ch02s03.html

   1 <html><head>
   2       <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   3    <title>2.3. Installation mittels Ansible auf Ubuntu 22.04</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="ch02s02.html" title="2.2. Benötigte Software und Pakete"><link rel="next" href="ch02s04.html" title="2.4. Manuelle Installation des Programmpaketes"></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. Installation mittels Ansible auf Ubuntu 22.04</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. Installation mittels Ansible auf Ubuntu 22.04"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Installation mittels Ansible"></a>2.3. Installation mittels Ansible auf Ubuntu 22.04</h2></div></div></div><p>
   4         Ansible ist ein Open-Source-Automatisierungstool, das verwendet
   5         wird, um die Bereitstellung, Konfiguration und Verwaltung von
   6         IT-Systemen zu automatisieren. Dabei führt es Aufgaben über SSH auf
   7         entfernten Rechnern (Hosts) aus. Die Aufgaben werden dabei
   8         deklarativ als YAML Dateien, den sogenannten Playbooks, übergeben.
   9         Benötigt wird lediglich python und ansible ab Version 2.10.
  10       </p><p>
  11         Alle benötigten Konfigurationsdateien und das Playbook sind auf dem kivitendo github Account
  12         unter dem Repository namens <a class="ulink" href="https://github.com/kivitendo/kivitendo-ansible" target="_top">kivitendo-ansible</a> verfügbar.
  13         Das Repo kann lokal mit folgendem git-Befehl "geklont" werden:
  14     </p><pre class="programlisting">git clone https://github.com/kivitendo/kivitendo-ansible</pre><p>
  15       In diesem Repository befindet sich auch eine Readme.md, die aktuelle Installationshinweise auf englisch enthält.
  16       </p><p>
  17         Um die Installation zu starten,  wechseln Sie dann zunächst in den erstellten Ordner 'kivitendo-ansible' und
  18         editieren die Datei inventory.
  19
  20         </p><pre class="programlisting">cd kivitendo-ansible
  21 vim inventory</pre><p>
  22
  23         Der/die Hosts auf denen Kivitendo installiert werden soll wird dann in
  24         dieser Datei ('inventory') eingefügt, bspw. die
  25
  26         </p><pre class="programlisting">192.168.1.121</pre><p>
  27         oder als Namen:
  28         </p><pre class="programlisting">kivi.meine-lokale-domaene.de</pre><p>
  29         Zusätzliche Parameter könnten erforderlich sein, bspw. der Benutzer für den SSH-Login:
  30         </p><pre class="programlisting">kivi.meine-lokale-domaene.de ansible_user=myuser</pre><p>
  31
  32          </p><p>
  33       Danach kann das Playbook mittels:
  34       </p><pre class="programlisting">ansible-playbook --ask-become main.yml</pre><p>
  35         ausgeführt werden, je nach Konfiguration wird man noch
  36         aufgefordert das BECOME password einzutragen, hierbei handelt es
  37         sich um das Passwort des Benutzers, über den die Installation dann auf dem Ziel-Rechner ausgeführt wird.
  38       </p><p>
  39         Nach erfolgreichen Ausführen des Playbooks ist Kivitendo dann über den Browser
  40         erreichbar unter
  41         <code class="literal">http://&lt;IP des rechners&gt;/kivitendo-erp/</code>
  42
  43          </p><p>
  44         Nun muss noch eine Datenbank für Benutzer und Mandanten angelegt
  45         werden. Dies kann über die Weboberfläche getan werden, indem man
  46         sich mit dem Passwort <code class="literal">admin123</code> in der
  47         Administrationsoberfläche anmeldet.
  48         Weitere Details siehe Abschnitt "<a class="xref" href="ch02s10.html" title="2.10. Benutzerauthentifizierung und Administratorpasswort">Abschnitt&nbsp;2.10, „Benutzerauthentifizierung und Administratorpasswort“</a>"
  49       </p></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. Manuelle Installation des Programmpaketes</td></tr></table></div></body></html>