OpenPetra installieren: Unterschied zwischen den Versionen
Tim00 (Diskussion | Beiträge) |
KKeine Bearbeitungszusammenfassung |
||
| (6 dazwischenliegende Versionen von einem anderen Benutzer werden nicht angezeigt) | |||
| Zeile 9: | Zeile 9: | ||
Es gibt ein Ansible Skript, das die Installationsschritte für OpenPetra automatisiert durchführt. | Es gibt ein Ansible Skript, das die Installationsschritte für OpenPetra automatisiert durchführt. | ||
Die Quellen für das Ansible Skript können hier eingesehen werden: https:// | Die Quellen für das Ansible Skript können hier eingesehen werden: https://codeberg.org/tpokorra/hs.ansible/src/branch/main/playbooks/openpetra | ||
Es wird Mono 6.8 lokal im Benutzerverzeichnis installiert, siehe auch die Anleitung [[Mono bei Hostsharing]]. | Es wird Mono 6.8 lokal im Benutzerverzeichnis installiert, siehe auch die Anleitung [[Mono bei Hostsharing]]. | ||
| Zeile 20: | Zeile 20: | ||
Es wird empfohlen, OpenPetra auf einem Managed Server zu betreiben. Im Shared Hosting werden ansonsten 2 Dienste benötigt, und die entsprechenden Ports müssen beim Service beantragt werden. | Es wird empfohlen, OpenPetra auf einem Managed Server zu betreiben. Im Shared Hosting werden ansonsten 2 Dienste benötigt, und die entsprechenden Ports müssen beim Service beantragt werden. | ||
Folgende Schritte sind auf dem lokalen Rechner auszuführen, um OpenPetra mit Hilfe des Ansible Skripts in den eigenen Hostsharing Benutzer zu installieren: | Folgende Schritte sind auf dem lokalen Rechner auszuführen, um OpenPetra mit Hilfe des Ansible Skripts in den eigenen Hostsharing Benutzer zu installieren: | ||
| Zeile 35: | Zeile 25: | ||
Klonen des Repositories: | Klonen des Repositories: | ||
<syntaxhighlight lang="bash"> | |||
git clone https://codeberg.org/tpokorra/hs.ansible.git | |||
</syntaxhighlight> | |||
Dann muss die Datei inventory kopiert werden, und entsprechend angepasst werden: | Dann muss die Datei inventory-sample.yml kopiert werden, und entsprechend angepasst werden: | ||
<syntaxhighlight lang="bash"> | |||
cd hs.ansible | |||
cp playbooks/openpetra/inventory-sample.yml inventories/my.inventory.yml | |||
vi inventories/my.inventory.yml | |||
</syntaxhighlight> | |||
In der my.inventory muss darauf geachtet werden, dass der OP_CUSTOMER mit den Zeichen op_ beginnt, also zum Beispiel op_verwaltung. Die Subdomain muss entsprechend heißen, z.B. verwaltung.meinverein.de | In der my.inventory.yml muss darauf geachtet werden, dass der OP_CUSTOMER mit den Zeichen op_ beginnt, also zum Beispiel op_verwaltung. Die Subdomain muss entsprechend heißen, z.B. verwaltung.meinverein.de | ||
Eine weitere Fehlerquelle sind zu lange Namen für user, denn dann kommt die Datenbankverwaltung von hsadmin aus dem Tritt. Bei openpetratest (13 Zeichen) treten zumindest Fehler auf... | |||
Es wird vorausgesetzt, dass auf dem lokalen Rechner Ansible installiert ist. | Es wird vorausgesetzt, dass auf dem lokalen Rechner Ansible installiert ist. | ||
| Zeile 49: | Zeile 45: | ||
Dann kann die Installation vom lokalen Rechner aus gestartet werden: | Dann kann die Installation vom lokalen Rechner aus gestartet werden: | ||
<syntaxhighlight lang="bash"> | |||
ansible-playbook -i inventories/my.inventory.yml init.yml | |||
ansible-playbook -i inventories/my.inventory.yml playbooks/openpetra/install.yml | |||
</syntaxhighlight> | |||
Bitte die wichtigen Hinweise in der Einrichtung beachten, bzgl. der Default Passwörter! | Bitte die wichtigen Hinweise in der Einrichtung beachten, bzgl. der Default Passwörter! | ||
| Zeile 70: | Zeile 67: | ||
Um Updates zu installieren, bitte folgendes Skript ausführen: | Um Updates zu installieren, bitte folgendes Skript ausführen: | ||
< | <syntaxhighlight lang="bash"> | ||
$HOME/bin/upgrade-openpetra.sh | |||
</ | </syntaxhighlight> | ||
== Links == | |||
*[https://www.openpetra.org Webseite vom OpenPetra Projekt] | |||
*[https://forum.openpetra.de Deutsches Forum für Community Support für OpenPetra] | |||
*[[Mono bei Hostsharing]] | |||
*[https://codeberg.org/tpokorra/hs.ansible/src/branch/main/playbooks/openpetra Ansible Playbook für Hostsharing] | |||
---- | ---- | ||
[[Kategorie:HSDoku]] | [[Kategorie:HSDoku]] | ||
[[Kategorie:Installationsanleitungen]] | [[Kategorie:Installationsanleitungen]] | ||
[[Kategorie:Ansible Playbook]] | |||
[[Kategorie:Software]] | [[Kategorie:Software]] | ||
[[Kategorie:Mono]] | [[Kategorie:Mono]] | ||
[[Kategorie:CRM]] | [[Kategorie:CRM]] | ||
[[Kategorie:ERP]] | [[Kategorie:ERP]] | ||
Aktuelle Version vom 14. Juni 2024, 12:23 Uhr
Allgemein
OpenPetra [1] ist ein Open Source CRM und ERP System für Vereine und Missionsgesellschaften.
Es läuft auf dem .NET Framework und kann mit Mono unter Linux betrieben werden.
Technische Details
Es gibt ein Ansible Skript, das die Installationsschritte für OpenPetra automatisiert durchführt.
Die Quellen für das Ansible Skript können hier eingesehen werden: https://codeberg.org/tpokorra/hs.ansible/src/branch/main/playbooks/openpetra
Es wird Mono 6.8 lokal im Benutzerverzeichnis installiert, siehe auch die Anleitung Mono bei Hostsharing.
Wir benutzen allerdings nicht den Apache, um direkt den fastcgi Server anzusprechen, sondern benutzen einen lokalen Nginx Server, weil damit feinere Einstellungen möglich sind. Siehe dazu auch NGinX_installieren#Betreiben_eines_lokalen_Nginx.
Mit Monit werden die beiden Prozesse (Mono fastcgi Server und nginx) gestartet und überwacht.
Installation
Es wird empfohlen, OpenPetra auf einem Managed Server zu betreiben. Im Shared Hosting werden ansonsten 2 Dienste benötigt, und die entsprechenden Ports müssen beim Service beantragt werden.
Folgende Schritte sind auf dem lokalen Rechner auszuführen, um OpenPetra mit Hilfe des Ansible Skripts in den eigenen Hostsharing Benutzer zu installieren:
Klonen des Repositories:
git clone https://codeberg.org/tpokorra/hs.ansible.git
Dann muss die Datei inventory-sample.yml kopiert werden, und entsprechend angepasst werden:
cd hs.ansible
cp playbooks/openpetra/inventory-sample.yml inventories/my.inventory.yml
vi inventories/my.inventory.yml
In der my.inventory.yml muss darauf geachtet werden, dass der OP_CUSTOMER mit den Zeichen op_ beginnt, also zum Beispiel op_verwaltung. Die Subdomain muss entsprechend heißen, z.B. verwaltung.meinverein.de
Eine weitere Fehlerquelle sind zu lange Namen für user, denn dann kommt die Datenbankverwaltung von hsadmin aus dem Tritt. Bei openpetratest (13 Zeichen) treten zumindest Fehler auf...
Es wird vorausgesetzt, dass auf dem lokalen Rechner Ansible installiert ist.
Dann kann die Installation vom lokalen Rechner aus gestartet werden:
ansible-playbook -i inventories/my.inventory.yml init.yml
ansible-playbook -i inventories/my.inventory.yml playbooks/openpetra/install.yml
Bitte die wichtigen Hinweise in der Einrichtung beachten, bzgl. der Default Passwörter!
Einrichtung
Nach der Installation kann die Seite hier erreicht werden: https://openpetra.example.org
Bitte mit dem Benutzer demo und dem Passwort demo anmelden, oder mit dem Benutzer sysadmin und dem Passwort CHANGEME.
WICHTIG: Bitte sofort diese Passwörter ändern! siehe https://handbuch.openpetra.de/howtos/initial-instance-setup.html
Es wurde durch das Ansible Skript bereits eine Datenbank mit Demo Daten installiert, dadurch entfällt das Einrichten des Hauptbuches für die ersten Tests. Falls mit einer sauberen Datenbank gestartet werden soll, bitte der Anleitung auf https://handbuch.openpetra.de/howtos/reset-database.html folgen!
Updates
Um Updates zu installieren, bitte folgendes Skript ausführen:
$HOME/bin/upgrade-openpetra.sh
Links
- Webseite vom OpenPetra Projekt
- Deutsches Forum für Community Support für OpenPetra
- Mono bei Hostsharing
- Ansible Playbook für Hostsharing