{"id":793,"date":"2020-07-17T14:04:19","date_gmt":"2020-07-17T12:04:19","guid":{"rendered":"https:\/\/www.virtualberater.com\/?p=793"},"modified":"2020-11-05T12:49:46","modified_gmt":"2020-11-05T11:49:46","slug":"ein-java-dienst-mit-systemctl-einrichten","status":"publish","type":"post","link":"https:\/\/www.virtualberater.com\/index.php\/2020\/07\/17\/ein-java-dienst-mit-systemctl-einrichten\/","title":{"rendered":"Ein Java Dienst mit systemctl einrichten"},"content":{"rendered":"\n

In Debian gibt es seit einigen Jahren f\u00fcr die Diensteverwaltung systemctl <\/em>oder systemd<\/em>. Das Kommandozeilentool systemctl <\/em>gibt dir dabei die M\u00f6glichkeit einen Dienst einzurichten bzw. zu starten<\/em>, stoppen<\/em>, bei Konfigurations-\u00e4nderungen zu reloaden <\/em>oder zu restarten<\/em>. Ausserdem kannst die dir auch jederzeit mit status <\/em>den Zustand deines Dienstes anschauen. Auch systemctl greift dabei auf einen Dienst zu, das ist der Dienst systemd<\/em>(Daemon). In diesem Howto will ich zeigen, wie du einen eigenen Dienst mit systemctl <\/em>in einem Debian System einrichtest.<\/p>\n\n\n\n

Die Umgebung<\/h2>\n\n\n\n

Ich f\u00fchre das ganze Howto auf einem Armbian durch, also ein Debian das f\u00fcr den ARM Prozessor A20 von AllwinnerTech<\/a> ausgerichtet ist. Es ist ganz genau ein Cubietruck 3<\/a>, also ein Einplatinencomputer. Das Armbian basiert auf ein Debian 8. <\/p>\n\n\n\n

Der Dienst<\/h2>\n\n\n\n

Mein Dienst besteht aus einen Java Programm mit dem sch\u00f6nen sprechenden Namen MultiUserChatServer.jar<\/strong>. Das Programm zeigt auf einfache Weise wie einfach man mit Java Netzwerverbindungen erstellen kannst. Die Java Programmierung steht hier aber nicht auf dem Plan. Der Dienst <\/p>\n\n\n\n

Der Client<\/h2>\n\n\n\n

Um meinen Dienst nach dem einrichten zu testen, existiert auch noch ein Client mit dem Namen MultiUserNetworkClient.jar<\/strong>.<\/p>\n\n\n\n

Die Vorbereitung<\/h2>\n\n\n\n

Das es sich bei meinen Diensten um ein Java Programm handelt, muss ein Java auf dem Zielsystem eingerichtet sein. Mein MultiUserChatServer ist mit dem JDK 8 compiliert worden. Das bedeutet, das auf meinem Zielsystem auch ein Java 8 installiert sein muss. Mit apt installiert man das ben\u00f6tigt Java wie hier:<\/p>\n\n\n\n

sudo apt install openjdk-8-jre<\/pre>\n\n\n\n
Nach der erfolgreichen Installation, ben\u00f6tige ich ein Heimatverzeichniss. Grunds\u00e4tzlich handhabe ich das so , das ich eigene Programme im Linuxsystem immer unter \/opt ablege. Dort erstelle ich mir ein Verzeichniss in das ich meine MultiUserChatServer.jar ablege. Ich nenne das Verzeichniss chatserver.<\/p>\n\n\n\n
mkdir \/opt\/chatserver<\/code><\/pre>\n\n\n\n
Nachdem ich die Datei MultiUserChatServer.jar dorthin kopiert habe, ben\u00f6tige ich noch einen User der s\u00e4mtlich berechtigungen f\u00fcr das ausf\u00fchren der MultiChatServer „funktionen“ hat. Daf\u00fcr lege ich mir ersteinmal eine Gruppe appmanager an:<\/p>\n\n\n\n
sudo groupadd -r appmanager<\/code><\/pre>\n\n\n\n
und einen User chatserveruser:<\/p>\n\n\n\n
sudo useradd -r -s \/bin\/false -g appmanager chatserveruser<\/code><\/pre>\n\n\n\n
der parameter -r erstellt einen Systemuser, also einen User der sich nicht einloggen kann, -s sorgt daf\u00fcr das er keine Shell bekommt (\/bin\/false). Die Gruppe sollte klar sein und dann der eigentliche Username. Ich schau mir nochmals das Produkt meiner Arbeit an, dabei Sieht man folgendes:<\/p>\n\n\n\n
id chatserveruser\nuid=998(chatserveruser) gid=997(appmanager) groups=997(appmanager)<\/code><\/pre>\n\n\n\n
mein User ben\u00f6tigt noch rechte auf dem \/opt\/chatserver Verzeichniss:<\/p>\n\n\n\n
sudo chown -R jvmapps:appmgr \/opt\/chatserver<\/code><\/pre>\n\n\n\n
Die Usereinrichtung ist fertig.<\/p>\n\n\n\n
Erstellen der systemd Servicedatei<\/h2>\n\n\n\n
mit dem Befehl:<\/p>\n\n\n\n
 sudo nano \/etc\/systemd\/system\/multichat.service<\/code><\/pre>\n\n\n\n
erstelle ich mir eine Textdatei im mitgegebene Verzeichniss \/etc\/systemd\/system. Dort trage ich folgende Infos ein:<\/p>\n\n\n\n
[Unit]\nDescription=Java MultiChatServer\n\n\n[Service]\nWorkingDirectory=\/opt\/chatserver\nExecStart=\/usr\/lib\/jvm\/java-8-openjdk-armhf\/bin\/java -jar \/opt\/chatserver\/MultiUserChatServer.jar\nUser=chatserveruser\nType=simple\nRestart=on-failure\nRestartSec=10\n\n[Install]\nWantedBy=multi-user.target\n<\/code><\/pre>\n\n\n\n
Die oben aufgef\u00fchrten Einstellungen habe ich auf dieser Kurz\u00fcbersicht <\/a>nochmals zusammengefasst und erkl\u00e4rt. Nachdem ich die oben dargestellt Datei abgespeichert habe, ben\u00f6tigt mein systemd ein reload:<\/p>\n\n\n\n
sudo systemctl daemon-reload<\/code><\/pre>\n\n\n\n
Nun kann ich den Dienst starten mit:<\/p>\n\n\n\n
sudo systemctl start multichat.service<\/code><\/pre>\n\n\n\n
Mit dem Befehl:<\/p>\n\n\n\n
systemctl status multichat<\/code><\/pre>\n\n\n\n
Aus dem o.g. Befehl erfolgt folgende Ausgabe:<\/p>\n\n\n\n
root@aquatruck:\/# systemctl status multichat\n\u25cf multichat.service - Java MultiChatServer\n   Loaded: loaded (\/etc\/systemd\/system\/multichat.service; enabled)\n   Active: active (running) since Thu 2020-07-02 07:05:22 CEST; 8s ago\n Main PID: 21008 (java)\n   CGroup: \/system.slice\/multichat.service\n           \u2514\u250021008 \/usr\/lib\/jvm\/java-8-openjdk-armhf\/bin\/java -jar \/opt\/prod\/MultiUserChatServer.jar\n\nJul 02 07:05:22 aquatruck systemd[1]: Started Java MultiChatServer.\nJul 02 07:05:23 aquatruck java[21008]: Server horcht......\n\n<\/code><\/pre>\n\n\n\n
Also mein Server horcht und wartet nun auf den Test.<\/p>\n\n\n\n
Der Test<\/h2>\n\n\n\n
Beim testen sollte nat\u00fcrlich klar sein was das oben eingerichtet Programm macht. In der Einleitung hatte ich bereits grob  beschrieben worum es bei dem MultiUserChatServer geht. Der Server horcht, ganz genau auf dem Port  4445, und wartet auf eine Anfrage auf einem Client. Wenn ich nun den Client starte, an der Kommandozeile werde ich aufgefordert etwas zum Server zu senden. Danach schaue ich mir den Status an, dort sollte das eingegebene auftauchen. Ich start den Client mit:<\/p>\n\n\n\n
franz@aquatruck:~$ java -jar MultiUserNetworkClient.jar\nClient Address : aquatruck\/192.168.178.113\nGeben Sie ihre Nachricht ein und bet\u00e4tigen Sie ENTER ( Enter QUIT f\u00fcr beenden):\n<\/code><\/pre>\n\n\n\n
Und gebe dort die Nachricht systemd ist cool ein.<\/p>\n\n\n\n
franz@aquatruck:~$ java -jar MultiUserNetworkClient.jar\nClient Address : aquatruck\/192.168.178.113\nGeben Sie ihre Nachricht ein und bet\u00e4tigen Sie ENTER ( Enter QUIT f\u00fcr beenden):\nsystemd ist cool\nServer Antwort : systemd ist cool 2020-07-02T07:07:20.680\n<\/code><\/pre>\n\n\n\n
Der Server Antwortet mit dem Inhalt der Nachricht und der Uhrzeit. In dem Status meines Services erscheint nach absenden des Befehls:<\/p>\n\n\n\n
sudo systemctl status multichat<\/code><\/pre>\n\n\n\n
Die Ausgabe:<\/p>\n\n\n\n
root@aquatruck:\/# systemctl status multichat\n\u25cf multichat.service - Java MultiChatServer\n   Loaded: loaded (\/etc\/systemd\/system\/multichat.service; enabled)\n   Active: active (running) since Thu 2020-07-02 07:05:22 CEST; 6min ago\n Main PID: 21008 (java)\n   CGroup: \/system.slice\/multichat.service\n           \u2514\u250021008 \/usr\/lib\/jvm\/java-8-openjdk-armhf\/bin\/java -jar \/opt\/prod\/MultiUserChatServer.jar\n\nJul 02 07:05:22 aquatruck systemd[1]: Started Java MultiChatServer.\nJul 02 07:05:23 aquatruck java[21008]: Server horcht......\nJul 02 07:06:14 aquatruck java[21008]: Verbindung zum clint aufgebaut\nJul 02 07:07:20 aquatruck java[21008]: Response to Client  :  systemd ist cool 2020-07-02T07:07:20.680\n<\/code><\/pre>\n\n\n\n
Der Test war also erfolgreich.<\/p>\n\n\n\n
Zusammenfassung<\/h2>\n\n\n\n
  1. Servicevorbereitungen bestehend aus: