Quelltext der Seite Server-Schulung-Teil10-Abschluss Installation Kivitendo

{{#switch:{{#IfLang:}}
|en=

== Preface ==

This training session took place on 06-08-17. We finally finished the installation of Kivitendo. What would remain is to enter the necessary data into the program, but that doesn't belong into a server training in my opinion.
<br />

<pre>
If there are still questions open after these instructions, please go to "Views" and then "Discussion" to leave your feedback, so I can add more Details to this page. jr
</pre>

== Setup an administrator in Kivitendo ==

We open Kivitendo in the browser. In my case it was the address 192.168.10.91:81. We get a login mask and we log in at administration. 
<br />
- Next we go to "Users, Mandator, User groups" (Benutzer, Mandanten, Benutzergruppen) and select there "New User group" (Neue Benutzergruppe). Since this administrator should have full access, we put everywhere a check mark.<br>
- Our next step is to create a "new user" (Neuer Benutzer). For this training enviroment I selected the username "Admin" with the password "admin".<br>
- Now the select the group "Full Access" (Vollzugriff) for our newly created user.<br>
- we selected the menu variant "top with CSS" (oben mit CSS)<br>
<br />
It's useful to create departments if you have various cost centers. You have to select Yes/No (Ja/Nein) (default=No/Nein)
<br />
== Create a database in Kivitendo ==

To be able to do that we go to our administrator part and there to "database administrator" (Datenbankadministration) and select "new database" (Neue Datenbank). The fields will already be filled out. We only have select the name of the new databse and press the button "Create new database" (Neue Datenbank anlegen:). In our case we selected "kivitendotest". Additionally we have to select the "chart of accounts to be used" (Zu verwendender Kontenplan:). As German speaking Swiss we selected "Switzerland-deutsch_MWST-2014".<br />


== Create mandator in Kivitendo ==

To create a mandator we select "New Mandator"(Neuer Mandant). There we will out the "mandator name" (Mandantenname:) and "database name" (Datenbankname:). In our test case it was "kivitendotest" for both fields. We also select the "user and group allocations" (Benutzer und Gruppenzuordnung). In our case we selected everything, as we didn't have any additional entries.<br />
<br />
For the moment we can "log out" (Abmelden) of the browser.
<br />
== Repetition: Update Kivitendo ==

On our virtual machine where Kivitendo is installed we go to the CLI. As I saw with "git status" that I'm currently in the "master branch" can I simply enter the following command to update the packages through git:
 user1@vm1:/var/www/git/kivitendo-erp$ sudo git pull

As we had to have root privileges to execute the "git pull" command, we need to change the ownership of some files back to www-data. For that we use the next command:
 user1@vm1:/var/www/git/kivitendo-erp$ sudo chown -R www-data:www-data .
<br />
As we've updated the program we need to restart the web server:
 user1@vm1:/var/www/git/kivitendo-erp$ sudo systemctl restart apache2

We should also refresh the browser content. We need to back to the admin section (Adminbereich). I received the following message:
<pre>
    Führe all_drafts_edit.pl aus: Zugriffsrecht auf alle Entwürfe

...fertig
</pre>

When we login afterwards with the username I got the next message:

<pre>
 kivitendo wird gleich die Datenbank [ kivitendotest ] aktualisieren.

Sie sollten eine Sicherungskopie der Datenbank erstellen, bevor Sie fortfahren, da die Aktualisierung unter Umständen nicht umkehrbar ist. 


    Führe filemanagement_filesystem.pl aus: add directory for filemanagment

...fertig
</pre>

== Bonus assignment setup taskserver ==

To setup a taskserver for Kivitendo, you go in the browser to the admin section of the program and create a new user. The username was "taskserver" and we chose a difficult password that we're allowed to forget, once it's been configured.<br />

In the next step we go to the CLI of our virtual machine with the Kivitendo application and open the following file with the preferred editor:
 user1@vm1:/var/www/git/kivitendo-erp$ sudo nano config/kivitendo.conf

<pre>
[task_server]
debug = 1
run_as =  www-data

[task_server/notify_on_failure]
send_email_to  = juerg.ruettimann@revamp-it.ch
email_subject  = kivitendo vm1 Task-Server: Hintergrundjob fehlgeschlagen
email_from     = kivitendo vm1 Daemon <www-data@vm2>

[periodic_invoices]
send_email_to  = admin
email_from     = kivitendo vm1 Daemon <www-data@vm2>
</pre>

If you wish to have the log files somewhere else and not in /tmp/, you can modify the path in the same file:
<pre>
# location of a separate log file for the console. everything normally written
# to the kivitendo log will be put here if triggered from the console
log_file = /tmp/kivitendo_console_debug.log
</pre>

That the changes become active we need to restart the web server:
 user1@vm1:/var/www/git/kivitendo-erp$ sudo systemctl restart apache2

We go back to the browser and login as our user. There we select "System\Background-Jobs and Taskserver\Taskserver control" (System\Hintergrund-Jobs und Taskserver\Taskserversteuerung). 

== Assignment for next session ==

In the documentation of Kivitendo we find at the point 2.7.3.3 how to automatically start the taskserver when the machine boots. This is our assignement for the next time and so I got to do it three times for me and the remaining participants.

<div class="toccolours mw-collapsible mw-collapsed">
'''In case you wish to get to the solution on your own, I'll post the steps I took to make it work, but it will be hidden inicially.'''<br />
<div class="mw-collapsible-content">
'''To the solution:'''<br />
user1@vm1:/var/www/git/kivitendo-erp$ sudo cp scripts/boot/systemd/kivitendo-task-server.service /etc/systemd/system/<br />
user1@vm1:/var/www/git/kivitendo-erp$ sudo nano /etc/systemd/system/kivitendo-task-server.service<br />
       ExecStart=/var/www/git/kivitendo-erp/scripts/task_server.pl start
       ExecStop=/var/www/git/kivitendo-erp/scripts/task_server.pl stop

user1@vm1:/var/www/git/kivitendo-erp$ sudo systemctl start kivitendo-task-server.service<br />
user1@vm1:/var/www/git/kivitendo-erp$ sudo systemctl enable kivitendo-task-server.service<br />
</div>
</div>

|#default=

== Vorwort ==

Diese Schulung hat am 08.06.17 stattgefunden. Wir haben die Installation von Kivitendo endlich abschliessen können. Was bleiben würde wäre all die notwendigen Daten in dem Programm eingeben, doch das gehört aus meiner Sicht nicht zu einer Server-Schulung.
<br />
<pre>
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
</pre>

== Administrator in Kivitendo einrichten ==

Wir rufen unser Kivitendo im Browser auf. In meinem Fall war es 192.168.10.91:81. Wir erhalten die Grundmaske und loggen uns bei Administration ein. 
<br />
- Anschliessend gehen wir zu "Benutzer, Mandanten, Benutzergruppen" und wählen dort eine "Neue Benutzergruppe". Da dieser Administrator Vollzugriff haben soll setzen wir überall die Hacken.<br>
- Als nächstes erstellen wir einen "Neuer Benutzer". Ich habe für dieses Übungsumfeld den Benutzernamen "Admin" gewählt mit dem Passwort "admin".<br>
- Nun wählen wir die Gruppe "Vollzugriff" für unseren neu erstellten Benutzer aus.<br>
- Menüvariante wurde von uns "oben mit CSS" gewählt<br>
<br />
Es ist sinnvoll Abteilungen zu erstellen, wenn man diverse Kostenstellen hat. Man muss dort Ja/Nein wählen (default=Nein)
<br />
== Datenbank in Kivitendo erstellen ==

Dazu gehen wir in unserem Administratorbereich zu "Datenbankadministration" und wählen "Neue Datenbank". Die Angaben sind bereits ausgefüllt. Wir müssen noch bei "Neue Datenbank anlegen:" den Namen für diese neue Datenbank angeben. In unserem Fall wurde "kivitendotest" gewählt. Ebenfalls wird der "Zu verwendender Kontenplan:" benötigt. Als Deutsch sprechende Schweizer haben wir "Switzerland-deutsch_MWST-2014" gewählt.<br />


== Mandanten in Kivitendo erstellen ==

Um den Mandanten zu erstellen wählen wir "Neuer Mandant". Dort füllen wir den "Mandantenname:" und "Datenbankname:" aus. In unserem Testfall war es beide Male "kivitendotest". Wir machen ebenfalls noch die "Benutzer und Gruppenzuordnung". In unserem Fall konnten wir alles anwählen, da noch nicht mehr vorhanden war.<br />
<br />
Für den Moment dürfen wir uns im Browser "Abmelden".
<br />
== Wiederholung: Kivitendo auf den neusten Stand bringen ==

Auf unserer virtuellen Maschine wo wir Kivitendo installiert haben gehen wir mal wieder auf die Konsole. Da ich über "git status" gesehen habe, dass ich mich bereits im "master branch" befinde kann ich einfach über den folgenden Befehl die Packete über git aktualisieren.
 user1@vm1:/var/www/git/kivitendo-erp$ sudo git pull

Da wir den git pull als root ausgeführt haben müssen wir einige Dateien wieder www-data als Inhaber/Gruppe zuweisen. Dies machen wir mit dem nächsten Befehl:
 user1@vm1:/var/www/git/kivitendo-erp$ sudo chown -R www-data:www-data .
<br />
Dass wir auch die aktualisierte Version vom Programm haben müssen wir den Webserver neu starten:
 user1@vm1:/var/www/git/kivitendo-erp$ sudo systemctl restart apache2

Unseren Browserinhalt sollten wir ebenfalls neu laden. Wir müssen uns nochmals im Adminbereich einloggen. Bei mir gab es die folgende Meldung:
<pre>
    Führe all_drafts_edit.pl aus: Zugriffsrecht auf alle Entwürfe

...fertig
</pre>

Wenn wir uns anschliessend wieder als Benutzer anmelden kommt noch die folgende Meldung:

<pre>
 kivitendo wird gleich die Datenbank [ kivitendotest ] aktualisieren.

Sie sollten eine Sicherungskopie der Datenbank erstellen, bevor Sie fortfahren, da die Aktualisierung unter Umständen nicht umkehrbar ist. 


    Führe filemanagement_filesystem.pl aus: add directory for filemanagment

...fertig
</pre>

== Zusatzaufgabe Taskserver einrichten ==

Um einen Taskserver für Kivitendo einzurichten geht man im Browser zum Admin-Bereich des Programmes und erstellt einen neuen Benutzer. Dem Benutzer gibt man den Namen taskserver und wählt ein komplexes Password, welches man nach einmal eingeben wieder vergessen darf.<br />

Als nächstes gehen wir in die Befehlszeile auf dem Server und öffnen die folgende Datei mit dem bevorzugten Editor:
 user1@vm1:/var/www/git/kivitendo-erp$ sudo nano config/kivitendo.conf

<pre>
[task_server]
debug = 1
run_as =  www-data

[task_server/notify_on_failure]
send_email_to  = juerg.ruettimann@revamp-it.ch
email_subject  = kivitendo vm1 Task-Server: Hintergrundjob fehlgeschlagen
email_from     = kivitendo vm1 Daemon <www-data@vm2>

[periodic_invoices]
send_email_to  = admin
email_from     = kivitendo vm1 Daemon <www-data@vm2>
</pre>

Falls man die Logdateien woanders haben will und nicht in /tmp/ kann man auch noch den Pfad anpassen gehen in der gleichen Datei:
<pre>
# location of a separate log file for the console. everything normally written
# to the kivitendo log will be put here if triggered from the console
log_file = /tmp/kivitendo_console_debug.log
</pre>

Dass diese Änderung aktiv wird muss man den Webserver noch neu starten:
 user1@vm1:/var/www/git/kivitendo-erp$ sudo systemctl restart apache2

Wir wechseln wieder zum Browser und melden und als Benutzer an. Dort wählen wir "System\Hintergrund-Jobs und Taskserver\Taskserversteuerung. 

== Hausaufgabe ==

In der Dokumentation von Kivitendo findet man unter dem Punkt 2.7.3.3 wie man den Taskserver automatisch startet beim aufstarten der Maschine wo Kivitendo installiert ist. Dies ist unsere Hausaufgabe fürs nächste Mal und somit durfte ich die Hausaufgabe 3x machen für mich und die restlichen Teilnehmer

<div class="toccolours mw-collapsible mw-collapsed">
'''Für den Fall, dass man die Lösung selber erarbeiten will, poste ich die Lösung zwar, doch man muss den Text ausklappen um ihn zu sehen.'''<br />
<div class="mw-collapsible-content">
'''Also zur Lösung:'''<br />
user1@vm1:/var/www/git/kivitendo-erp$ sudo cp scripts/boot/systemd/kivitendo-task-server.service /etc/systemd/system/<br />
user1@vm1:/var/www/git/kivitendo-erp$ sudo nano /etc/systemd/system/kivitendo-task-server.service<br />
       ExecStart=/var/www/git/kivitendo-erp/scripts/task_server.pl start
       ExecStop=/var/www/git/kivitendo-erp/scripts/task_server.pl stop

user1@vm1:/var/www/git/kivitendo-erp$ sudo systemctl start kivitendo-task-server.service<br />
user1@vm1:/var/www/git/kivitendo-erp$ sudo systemctl enable kivitendo-task-server.service<br />
</div>
</div>

}}
[[Kategorie:Schulungen_/_Workshops]],[[Kategorie:Server-Schulung]]