Server-Schulung-Teil9-Weiterer mit installieren von Kivitendo: Unterschied zwischen den Versionen

Aus revampedia
(Die Seite wurde neu angelegt: «{{#switch:{{#IfLang:}} |en= == Preface == '''''Is being created. Not finished and not translated yet.''''' 11.05.17 <br /> <pre> If there are still question…»)
 
 
Zeile 4: Zeile 4:
 
== Preface ==
 
== Preface ==
  
−
'''''Is being created. Not finished and not translated yet.'''''
+
This training session took place on 05-11-17. We continued with the configuration of Kivitendo, but we didn't manage to finish it. We'll have to continue some other time and I have no idea how many more sessions will be necessary.
−
 
 
−
11.05.17
 
−
 
 
 
<br />
 
<br />
  
Zeile 14: Zeile 11:
 
</pre>
 
</pre>
  
 +
 +
== Change to Kivitendo directory and check it's status ===
 +
 +
First we go back to the directory where we've installed Kivitendo
 +
user1@vm1:~$ cd /var/www/git/kivitendo-erp/
 +
 +
And check it's status and in what branch we're currently in
 +
user1@vm1:/var/www/git/kivitendo-erp$ git status
 +
user1@vm1:/var/www/git/kivitendo-erp$ git branch
 +
 +
 +
== Install the latest version of Kivitendo ==
 +
 +
For that we need to switch to the master-branch
 +
user1@vm1:/var/www/git/kivitendo-erp$ sudo git checkout master
 +
 +
And load the new packages with git
 +
user1@vm1:/var/www/git/kivitendo-erp$ sudo git pull
 +
 +
=== New packages required by Kivitendo ===
 +
 +
During our training session we found out that the latest version requires additional packages. The script we've used before shows us what we're lacking:
 +
user1@vm1:/var/www/git/kivitendo-erp$ ./scripts/installation_check.pl
 +
Looking for File::MimeInfo::Magic ....................................... NOT ok
 +
Looking for pdfinfo executable ................................... not installed
 +
 +
At the end it also gives us instructions on how to get them. We follow those instructions and install the available package
 +
 +
user1@vm1:/var/www/git/kivitendo-erp$ sudo apt install libfile-mimeinfo-perl
 +
 +
The second component wasn't found in cpan, so at the time I'm writing this that part isn't necessary.
 +
 +
== Individual configuration for Kivitendo ==
 +
 +
If you're the administrator for several installations of Kivitendo it's absolutly necessary to customize some parameters. It doesn't hurt to have some individual settings if you just have one installation. For that we create a copy of the default configuration with a new name
 +
 +
user1@vm1:/var/www/git/kivitendo-erp$ sudo cp -a config/kivitendo.conf.default config/kivitendo.conf
 +
 +
And we edit the new file afterwards
 +
 +
user1@vm1:/var/www/git/kivitendo-erp$ sudo nano config/kivitendo.conf
 +
admin_password = kivitendo123
 +
cookie_name = kivitendo_session_id_vm1
 +
user    = kivitendo
 +
password = kivitendo
 +
default_manager = swiss
 +
 +
- admin_password is necessary when accessing Kivitendo in the browser.<br>
 +
- cookie_name should be individual for each installation of Kivitendo, as the administrator won't know in what installation he's currently working in.<br>
 +
- user and password are what we've set for the new user in PostgreSQL in [http://wiki.revamp-it.ch/index.php?title=Server-Schulung-Teil8-Weiter_installieren_von_Kivitendo Part8]<br>
 +
- default_manager we set to Switzerland<br>
 +
<br />
 +
 +
That our changes become active we have to restart the service of the webserver
 +
user1@vm1:/var/www/git/kivitendo-erp$ sudo systemctl restart apache2
 +
 +
== Add a new user in PostgreSQL ==
 +
 +
This step is only necessary if you did [http://wiki.revamp-it.ch/index.php?title=Server-Schulung-Teil8-Weiter_installieren_von_Kivitendo Part8] before 05-15-17. If you do this at a later date have I made a correction to it.<br>
 +
First you change to the user postgres
 +
user1@vm1:/var/www/git/kivitendo-erp$ sudo su postgres
 +
And create the new user
 +
postgres@vm1:/home/user1$ createuser -p 5433 -d -P kivitendo
 +
-p 5433 -> tells us to what port we've connecting. As we've created a new cluster it's not the default port
 +
-d -> the new user is allowed to created databases
 +
-P -> We create a password for the new user
 +
 +
== Access Kivitendo in the browser ==
 +
 +
In mz case I can access my installation of Kivitendo in the browser by entering the following address. It will be different for everyone<br>
 +
192.168.10.91:81
 +
 +
On the page we get we pick Administration. We have to enter the password that we entered in /var/www/git/kivitendo-erp/config/kivitendo.conf unter admin_password. In my case the password was kivitendo123.<br>
 +
<br>
 +
The next page is already filled out and so we can klick "Datenbank anlegen" (create database).<br>
 +
<br>
 +
Unfortunately we've run out of time and will have to continue at a later date.
  
  
Zeile 27: Zeile 101:
 
</pre>
 
</pre>
  
 +
== In den Ordner von Kivitendo gehen und Status prüfen ===
  
−
user1@vm1:~$ cd /var/www/git/kivitendo-erp/
+
Als erstes gehen wir zurück in unseren Ordner wo wir Kivitendo installiert haben
 +
user1@vm1:~$ cd /var/www/git/kivitendo-erp/
  
 +
Und prüfen den Status und in welchem Branch wir uns aktuell befinden
 
  user1@vm1:/var/www/git/kivitendo-erp$ git status
 
  user1@vm1:/var/www/git/kivitendo-erp$ git status
 
  user1@vm1:/var/www/git/kivitendo-erp$ git branch
 
  user1@vm1:/var/www/git/kivitendo-erp$ git branch
  
  
−
neuste kivi-version installieren
+
== Neuste Version von Kivitendo installieren ==
  
 +
Dazu müssen wir wieder in den Master-Branch wechseln
 
  user1@vm1:/var/www/git/kivitendo-erp$ sudo git checkout master
 
  user1@vm1:/var/www/git/kivitendo-erp$ sudo git checkout master
  
 +
Und laden über git die neuen Packete herunter
 
  user1@vm1:/var/www/git/kivitendo-erp$ sudo git pull
 
  user1@vm1:/var/www/git/kivitendo-erp$ sudo git pull
  
−
user1@vm1:/var/www/git/kivitendo-erp$ sudo cp -a config/kivitendo.conf.default config/kivitendo.conf
+
=== Neue Packete notwendig für Kivitendo ===
  
−
  admin_password = kivitendo123
+
Während der Schulung haben wir festgestellt, dass uns noch neue Packete fehlen welche die neue Version von Kivitendo braucht. Über das Script sehen wir welche Packete das sind:
 +
  user1@vm1:/var/www/git/kivitendo-erp$ ./scripts/installation_check.pl
 +
Looking for File::MimeInfo::Magic ....................................... NOT ok
 +
Looking for pdfinfo executable ................................... not installed
  
−
cookie_name = kivitendo_session_id_vm1
+
Am Schluss gibt es noch eine Anleitung wie man diese neuen Komponenten installieren kann. Wir folgen also der Anleitung und installieren das verfügbare Packet
  
−
-> sollte individuell sein, falls man als administrator auf unterschiedliche kivitendo's gleichzeitig zugreifen will
+
user1@vm1:/var/www/git/kivitendo-erp$ sudo apt install libfile-mimeinfo-perl
  
−
user    = kivitendo
+
Die zweite Komponente wurde in cpan nicht gefunden und somit noch nicht notwendig für Kivitendo zum Zeitpunkt wo ich dies schreibe.
−
password = kivitendo
 
−
(wie in teil8 gesetzt)
 
  
−
default_manager = swiss
+
== Individuelle Konfiguration von Kivitendo anlegen ==
  
 +
Falls man als Administrator mehrere Installationen von Kivitendo hat ist es zwingend notwendig einige Dinge zu individualisieren. Doch es schadet auch sonst nicht einige Parameter anzupassen. Dazu erstellen wir uns eine Kopie der Standart-Konfigurationsdatei mit einem anderen Namen
  
−
  user1@vm1:/var/www/git/kivitendo-erp$ sudo systemctl restart apache2
+
  user1@vm1:/var/www/git/kivitendo-erp$ sudo cp -a config/kivitendo.conf.default config/kivitendo.conf
  
−
-> haben fehler, da mit neuen version von kivi noch weitere teile erforderlich sind
+
Und editieren unsere neue Datei anschliessend
  
−
  user1@vm1:/var/www/git/kivitendo-erp$ ./scripts/installation_check.pl
+
  user1@vm1:/var/www/git/kivitendo-erp$ sudo nano config/kivitendo.conf
 +
admin_password = kivitendo123
 +
cookie_name = kivitendo_session_id_vm1
 +
user    = kivitendo
 +
password = kivitendo
 +
default_manager = swiss
  
−
Looking for File::MimeInfo::Magic ....................................... NOT ok
+
- admin_password wird benötigt, wenn man über den Browser auf Kivitendo zugreifen will.<br>
−
Looking for pdfinfo executable ................................... not installed
+
- cookie_name sollte man für jede Installation von Kivitendo individualisieren, da man sonst als Administrator nicht weiss in welcher Installation man gerade arbeitet.<br>
 +
- user und password setzt man auf den neuen PostgreSQL Benutzer von [http://wiki.revamp-it.ch/index.php?title=Server-Schulung-Teil8-Weiter_installieren_von_Kivitendo Teil8]<br>
 +
- default_manager setzen wir auf die Schweiz<br>
 +
<br />
  
−
es gibt noch anleitung wie wir das nachinstallieren.
+
Dass unsere Änderungen aktiv werden müssen wir den Dienst vom Webserver neu starten
−
 
+
  user1@vm1:/var/www/git/kivitendo-erp$ sudo systemctl restart apache2
−
  user1@vm1:/var/www/git/kivitendo-erp$ sudo apt install libfile-mimeinfo-perl
 
−
 
 
−
 
 
−
Administration
 
−
-> passwort von oben kivitendo123
 
−
 
 
−
ist ausgefüllt, Datenbank anlegen anklicken
 
−
 
 
−
-> produziert fehler und kann datenbank nicht anlegen
 
  
−
user1@vm1:/var/www/git/kivitendo-erp$ sudo su postgres
+
== Neuen Benutzer in PostgreSQL hinzufügen ==
−
postgres@vm1:/var/www/git/kivitendo-erp$ psql
 
−
postgres=# help
 
  
−
postgres=# \h ALTER ROLE -> anweisung für änderungen an user gross-klein-schreibung relevant
+
Dieser Schritt ist nur notwendig, wenn man [http://wiki.revamp-it.ch/index.php?title=Server-Schulung-Teil8-Weiter_installieren_von_Kivitendo Teil8] vor dem 15.05.17 gemacht hat. Falls man diesen Teil später macht, hat man bereits die korrigierte Version.<br>
−
postgres=# ALTER ROLE kivitendo WITH ENCRYPTED PASSWORD 'kivitendo' -> ändert pw von user kivitendo auf kivitendo
+
Zuerst wechselt man zum Benutzer postgres
 +
user1@vm1:/var/www/git/kivitendo-erp$ sudo su postgres
 +
Und erstellt dann den neuen Benutzer
 +
postgres@vm1:/home/user1$ createuser -p 5433 -d -P kivitendo
 +
-p 5433 -> gibt an auf welchem Port wir dies machen. Da wir einen neuen Cluster erstellt haben, ist es ja nicht der Standard-Port
 +
-d -> der neue Benutzer darf Datenbanken erstellen
 +
-P -> Wir erstellen ein Passwort für den neuen Benutzer
  
−
-> haben doch noch keinen user erstellt. Neuen Benutzer in PostgreSQL erstellen in Teil8 ist falsch ist
+
== Im Browser aufrufen ==
  
−
postgres@vm1:/home/user1$ createuser -p 5434 -d -P kivitendo
+
In meinem Fall kann ich Kivitendo im Browser über die folgende Adresse aufrufen. Für jeden wird es jedoch anders sein<br>
−
-> haben kivitendo user in kivicluster
+
192.168.10.91:81
−
-> können datenbank erstellen -> zeit abgelaufen
 
  
 +
Auf der Seite die wir kriegen wählen wir Administration. Wir müssen dann das Passwort eingeben, welches wir unter /var/www/git/kivitendo-erp/config/kivitendo.conf bei admin_password eingegeben haben. In meinem Fall war das Passwort kivitendo123.<br>
 +
<br>
 +
Die nächste Seite ist bereits ausgefüllt, dass wir "Datenbank anlegen" anklicken können.<br>
 +
<br>
 +
Die Zeit ist leider mal wieder abgelaufen, dass wir noch weitere Lektionen brauchen werden um fertig zu werden.
 
}}
 
}}
 
[[Kategorie:Schulungen_/_Workshops]],[[Kategorie:Server-Schulung]]
 
[[Kategorie:Schulungen_/_Workshops]],[[Kategorie:Server-Schulung]]

Aktuelle Version vom 15. Mai 2017, 13:36 Uhr

Vorwort

Diese Schulung hat am 11.05.17 stattgefunden. Wir haben ein wenig weitergemacht bei der Konfiguration, doch sind bislang immer noch nicht fertig. Wieviele Male noch nötig sind um die Installation abzuschliessen weiss ich leider nicht. 


Falls noch Fragen offen sind nach dieser Anleitung bitte oben bei "Ansichten" auf "Diskussion" gehen und Feedback hinterlassen, dass ich noch weitere Details hinzufügen kann. jr

In den Ordner von Kivitendo gehen und Status prüfen =

Als erstes gehen wir zurück in unseren Ordner wo wir Kivitendo installiert haben 

user1@vm1:~$ cd /var/www/git/kivitendo-erp/

Und prüfen den Status und in welchem Branch wir uns aktuell befinden 

user1@vm1:/var/www/git/kivitendo-erp$ git status
user1@vm1:/var/www/git/kivitendo-erp$ git branch


Neuste Version von Kivitendo installieren

Dazu müssen wir wieder in den Master-Branch wechseln 

user1@vm1:/var/www/git/kivitendo-erp$ sudo git checkout master

Und laden über git die neuen Packete herunter 

user1@vm1:/var/www/git/kivitendo-erp$ sudo git pull

Neue Packete notwendig für Kivitendo

Während der Schulung haben wir festgestellt, dass uns noch neue Packete fehlen welche die neue Version von Kivitendo braucht. Über das Script sehen wir welche Packete das sind: 

user1@vm1:/var/www/git/kivitendo-erp$ ./scripts/installation_check.pl
Looking for File::MimeInfo::Magic ....................................... NOT ok
Looking for pdfinfo executable ................................... not installed

Am Schluss gibt es noch eine Anleitung wie man diese neuen Komponenten installieren kann. Wir folgen also der Anleitung und installieren das verfügbare Packet 

user1@vm1:/var/www/git/kivitendo-erp$ sudo apt install libfile-mimeinfo-perl

Die zweite Komponente wurde in cpan nicht gefunden und somit noch nicht notwendig für Kivitendo zum Zeitpunkt wo ich dies schreibe.

Individuelle Konfiguration von Kivitendo anlegen

Falls man als Administrator mehrere Installationen von Kivitendo hat ist es zwingend notwendig einige Dinge zu individualisieren. Doch es schadet auch sonst nicht einige Parameter anzupassen. Dazu erstellen wir uns eine Kopie der Standart-Konfigurationsdatei mit einem anderen Namen 

user1@vm1:/var/www/git/kivitendo-erp$ sudo cp -a config/kivitendo.conf.default config/kivitendo.conf

Und editieren unsere neue Datei anschliessend 

user1@vm1:/var/www/git/kivitendo-erp$ sudo nano config/kivitendo.conf
admin_password = kivitendo123
cookie_name = kivitendo_session_id_vm1
user     = kivitendo
password = kivitendo
default_manager = swiss

- admin_password wird benötigt, wenn man über den Browser auf Kivitendo zugreifen will.
- cookie_name sollte man für jede Installation von Kivitendo individualisieren, da man sonst als Administrator nicht weiss in welcher Installation man gerade arbeitet.
- user und password setzt man auf den neuen PostgreSQL Benutzer von Teil8
- default_manager setzen wir auf die Schweiz

Dass unsere Änderungen aktiv werden müssen wir den Dienst vom Webserver neu starten 

user1@vm1:/var/www/git/kivitendo-erp$ sudo systemctl restart apache2

Neuen Benutzer in PostgreSQL hinzufügen

Dieser Schritt ist nur notwendig, wenn man Teil8 vor dem 15.05.17 gemacht hat. Falls man diesen Teil später macht, hat man bereits die korrigierte Version.
Zuerst wechselt man zum Benutzer postgres 

user1@vm1:/var/www/git/kivitendo-erp$ sudo su postgres

Und erstellt dann den neuen Benutzer 

postgres@vm1:/home/user1$ createuser -p 5433 -d -P kivitendo

-p 5433 -> gibt an auf welchem Port wir dies machen. Da wir einen neuen Cluster erstellt haben, ist es ja nicht der Standard-Port -d -> der neue Benutzer darf Datenbanken erstellen -P -> Wir erstellen ein Passwort für den neuen Benutzer

Im Browser aufrufen

In meinem Fall kann ich Kivitendo im Browser über die folgende Adresse aufrufen. Für jeden wird es jedoch anders sein

192.168.10.91:81

Auf der Seite die wir kriegen wählen wir Administration. Wir müssen dann das Passwort eingeben, welches wir unter /var/www/git/kivitendo-erp/config/kivitendo.conf bei admin_password eingegeben haben. In meinem Fall war das Passwort kivitendo123.

Die nächste Seite ist bereits ausgefüllt, dass wir "Datenbank anlegen" anklicken können.

Die Zeit ist leider mal wieder abgelaufen, dass wir noch weitere Lektionen brauchen werden um fertig zu werden.,

Von «https://wiki.revamp-it.ch/index.php?title=Server-Schulung-Teil9-Weiterer_mit_installieren_von_Kivitendo&oldid=5039»