HowtoForge

So installierst du OpenMRS unter Ubuntu 22.04

von ·

OpenMRS ist ein effizientes System zur Speicherung und Abfrage von elektronischen Krankenakten (EMR), das als Open-Source-Software veröffentlicht wurde. Es unterstützt die Gesundheitsversorgung in Entwicklungsländern bei der Behandlung von Millionen von HIV/AIDS- und Tuberkulosepatienten. Es basiert auf den Prinzipien der Offenheit, um Patientendaten mit anderen medizinischen Informationssystemen auszutauschen. Du kannst alle elektronischen Krankenakten über die webbasierte Schnittstelle von OpenMRS verwalten.

In diesem Tutorial wird erklärt, wie du die OpenMRS-Software auf Ubuntu 22.04 installierst.

Voraussetzungen

  • Ein Server, auf dem Ubuntu 22.04 läuft.
  • Ein Root-Passwort ist auf dem Server eingerichtet.

Installiere OpenJDK 8

OpenMRS ist eine Java-basierte Anwendung und unterstützt nur die Java-Version 8. Daher musst du Java 8 auf deinem Server installieren. Du kannst es mit dem folgenden Befehl installieren.

apt install openjdk-8-jdk

Als Nächstes überprüfst du die Java-Version mit dem folgenden Befehl:

java -version

Du erhältst die folgende Ausgabe:

openjdk version "1.8.0_352"
OpenJDK Runtime Environment (build 1.8.0_352-8u352-ga-1~22.04-b08)
OpenJDK 64-Bit Server VM (build 25.352-b08, mixed mode)

Jetzt ist Java 8 auf deinem Server installiert. Du kannst jetzt mit der Installation des MySQL-Servers fortfahren.

MySQL Server 5.6 installieren

Jetzt musst du die MySQL Server Version 5.6 auf deinem Server installieren. Denn OpenMRS unterstützt nur die MySQL-Version 5.6. Standardmäßig ist MySQL 5.6 nicht im Standard-Repository von Ubuntu 22.04 verfügbar. Du musst sie also von der Quelle aus installieren.

Erstelle zunächst mit dem folgenden Befehl einen Benutzer und eine Gruppe für MySQL:

groupadd mysql
useradd -g mysql mysql

Als Nächstes lädst du den Quellcode von MySQL 5.6 mit folgendem Befehl von der offiziellen Website herunter:

wget https://dev.mysql.com/get/Downloads/MySQL-5.6/mysql-5.6.46-linux-glibc2.12-x86_64.tar.gz

Entpacke dann die heruntergeladene Datei mit folgendem Befehl:

tar -xvf mysql-5.6.46-linux-glibc2.12-x86_64.tar.gz

Verschiebe das extrahierte Verzeichnis mit folgendem Befehl nach /usr/local:

mv mysql-5.6.46-linux-glibc2.12-x86_64 /usr/local/mysql

Wechsle dann das Verzeichnis in das Verzeichnis /usr/local/mysql und setze mit folgendem Befehl die richtigen Eigentümer:

cd /usr/local/mysql
chown -R mysql:mysql *

Als Nächstes installierst du die erforderlichen Abhängigkeiten mit dem folgenden Befehl:

apt-get install libaio1 libncurses5 libnuma-dev -y

Als Nächstes führst du das folgende Skript aus, um den MySQL-Server zu installieren:

scripts/mysql_install_db --user=mysql

Du erhältst die folgende Ausgabe:

You can start the MySQL daemon with:

  cd . ; ./bin/mysqld_safe &

You can test the MySQL daemon with mysql-test-run.pl

  cd mysql-test ; perl mysql-test-run.pl

Please report any problems at http://bugs.mysql.com/

The latest information about MySQL is available on the web at

  http://www.mysql.com

Support MySQL by buying support/licenses at http://shop.mysql.com

New default config file was created as ./my.cnf and
will be used by default by the server when you start it.
You may edit this file to change server settings

Als Nächstes musst du die Eigentumsrechte für das mysql- und das data-Verzeichnis festlegen:

chown -R root .
chown -R mysql data

Als Nächstes kopierst du die MySQL-Konfigurationsdatei und die Servicedatei an den richtigen Ort:

cp support-files/my-default.cnf /etc/my.cnf
cp support-files/mysql.server /etc/init.d/mysql.server

Starte als Nächstes den MySQL-Dienst im abgesicherten Modus:

bin/mysqld_safe --user=mysql &

Als Nächstes legst du das MySQL-Root-Passwort mit folgendem Befehl fest:

bin/mysqladmin -u root password secure-password

Als Nächstes erstellst du einen symbolischen Link auf die MySQL-Binärdatei mit folgendem Befehl:

ln -s /usr/local/mysql/bin/mysql /usr/local/bin/mysql

Zum Schluss startest du deinen Server mit dem folgenden Befehl neu:

reboot

Nach dem Neustart des Systems startest du den MySQL-Dienst und aktivierst ihn so, dass er beim Neustart des Systems gestartet wird:

/etc/init.d/mysql.server start
update-rc.d -f mysql.server defaults

Du kannst nun den Status des MySQL-Dienstes mit folgendem Befehl überprüfen:

/etc/init.d/mysql.server status

Du erhältst die folgende Ausgabe:

? mysql.server.service - LSB: start and stop MySQL
     Loaded: loaded (/etc/init.d/mysql.server; generated)
     Active: active (running) since Tue 2022-12-13 04:08:18 UTC; 15s ago
       Docs: man:systemd-sysv-generator(8)
      Tasks: 22 (limit: 2238)
     Memory: 455.3M
        CPU: 329ms
     CGroup: /system.slice/mysql.server.service
             ??1120 /bin/sh /usr/local/mysql/bin/mysqld_safe --datadir=/usr/local/mysql/data --pid-file=/usr/local/mysql/data/ubuntu2204.pid
             ??1228 /usr/local/mysql/bin/mysqld --basedir=/usr/local/mysql --datadir=/usr/local/mysql/data --plugin-dir=/usr/local/mysql/lib/…

Dec 13 04:08:17 ubuntu2204 systemd[1]: Starting LSB: start and stop MySQL...
Dec 13 04:08:17 ubuntu2204 mysql.server[1112]: Starting MySQL
Dec 13 04:08:18 ubuntu2204 mysql.server[1112]: . *
Dec 13 04:08:18 ubuntu2204 systemd[1]: Started LSB: start and stop MySQL.

Wenn du damit fertig bist, kannst du mit dem nächsten Schritt fortfahren.

Tomcat 8 installieren

Als Nächstes musst du Tomcat 8 installieren, um OpenMRS einzusetzen.

Zuerst erstellst du mit dem folgenden Befehl einen Benutzer und eine Gruppe für Tomcat:

groupadd tomcat
useradd -s /bin/false -g tomcat -d /opt/tomcat tomcat

Als Nächstes lädst du Tomcat 8 mit folgendem Befehl von der offiziellen Website herunter:

wget https://dlcdn.apache.org/tomcat/tomcat-8/v8.5.84/bin/apache-tomcat-8.5.84.tar.gz

Erstelle dann ein Verzeichnis für Tomcat und entpacke die heruntergeladene Datei in das Verzeichnis /opt/tomcat:

mkdir /opt/tomcat
tar -xvzf apache-tomcat-8.5.84.tar.gz -C /opt/tomcat/ --strip-components=1

Als Nächstes musst du die Eigentumsrechte für das Verzeichnis /opt/tomcat festlegen:

chown -R tomcat:tomcat /opt/tomcat

Wenn du damit fertig bist, kannst du mit dem nächsten Schritt fortfahren.

Eine Systemd-Dienstdatei für Tomcat erstellen

Als Nächstes musst du eine systemd-Dienstdatei erstellen, um den Tomcat-Dienst zu verwalten. Du kannst sie mit dem folgenden Befehl erstellen:

nano /etc/systemd/system/tomcat.service

Füge die folgenden Zeilen ein:

[Unit]
Description=Apache Tomcat Web Application Container
After=network.target
[Service]
Type=forking
Environment=JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-amd64
Environment=CATALINA_PID=/opt/tomcat/temp/tomcat.pid
Environment=CATALINA_HOME=/opt/tomcat
Environment=CATALINA_BASE=/opt/tomcat
Environment=’CATALINA_OPTS=-Xms512M -Xmx1024M -server -XX:+UseParallelGC’
ExecStart=/opt/tomcat/bin/startup.sh
ExecStop=/opt/tomcat/bin/shutdown.sh
User=tomcat
Group=tomcat
UMask=0007
RestartSec=10
Restart=always
[Install]
WantedBy=multi-user.target

Speichere und schließe die Datei und lade den systemd-Daemon neu, um die Änderungen zu übernehmen:

systemctl daemon-reload

Starte dann den Tomcat-Dienst mit dem folgenden Befehl:

systemctl start tomcat

Jetzt kannst du den Status des Tomcat-Dienstes mit dem folgenden Befehl überprüfen:

systemctl status tomcat

Du erhältst die folgende Ausgabe:

? tomcat.service - Apache Tomcat Web Application Container
     Loaded: loaded (/etc/systemd/system/tomcat.service; disabled; vendor preset: enabled)
     Active: active (running) since Tue 2022-12-13 04:11:30 UTC; 7s ago
    Process: 1394 ExecStart=/opt/tomcat/bin/startup.sh (code=exited, status=0/SUCCESS)
   Main PID: 1401 (java)
      Tasks: 28 (limit: 2238)
     Memory: 97.0M
        CPU: 2.192s
     CGroup: /system.slice/tomcat.service
             ??1401 /usr/lib/jvm/java-1.8.0-openjdk-amd64//bin/java -Djava.util.logging.config.file=/opt/tomcat/conf/logging.properties -Djav>

Dec 13 04:11:30 ubuntu2204 systemd[1]: Starting Apache Tomcat Web Application Container...
Dec 13 04:11:30 ubuntu2204 startup.sh[1394]: Tomcat started.
Dec 13 04:11:30 ubuntu2204 systemd[1]: Started Apache Tomcat Web Application Container.

Jetzt ist Tomcat gestartet und lauscht auf Port 8080. Du kannst jetzt mit dem nächsten Schritt fortfahren.

OpenMRS unter Ubuntu 22.04 installieren

Erstelle zunächst ein Verzeichnis für OpenMRS und lege mit folgendem Befehl die richtigen Eigentümer fest:

mkdir /var/lib/OpenMRS
chown -R tomcat:tomcat /var/lib/OpenMRS

Als Nächstes lädst du die neueste Version von OpenMRS mit folgendem Befehl herunter:

wget https://sourceforge.net/projects/openmrs/files/releases/OpenMRS_Platform_2.5.7/openmrs.war

Sobald der Download abgeschlossen ist, kopierst du die heruntergeladene Datei in das Verzeichnis Tomcat webapps:

cp openmrs.war /opt/tomcat/webapps/

Als Nächstes änderst du die Eigentumsrechte an der Datei openmrs.war auf tomcat:

chown -R tomcat:tomcat /opt/tomcat/webapps/openmrs.war

Sobald du damit fertig bist, kannst du mit dem nächsten Schritt fortfahren.

OpenMRS-Installation über den Webbrowser durchführen

Öffne deinen Webbrowser und rufe den OpenMRS-Webinstallationsassistenten über die URL http://your-server-ip:8080/openmrs auf. Du solltest den Bildschirm zur Auswahl der OpenMRS-Sprache sehen:

Wähle deine Sprache aus und klicke auf die Schaltfläche =>. Du solltest den Bildschirm „Installationsart“ sehen.

Wähle die gewünschte Installationsart und klicke auf die => Schaltfläche. Du solltest den folgenden Bildschirm sehen:

Gib dein MySQL-Root-Passwort ein, notiere dir das Admin-Passwort und klicke auf die Schaltfläche =>. Du solltest den folgenden Bildschirm sehen:

Klicke auf die Schaltfläche =>, um eine Datenbank für OpenMRS zu erstellen und die Installation abzuschließen.

Gib den Standardbenutzernamen admin und das Passwort Admin123 ein und klicke dann auf die Schaltfläche LOG IN. Auf dem folgenden Bildschirm solltest du das OpenMRS-Dashboard sehen:

Fazit

Glückwunsch! Du hast OpenMRS erfolgreich auf Ubuntu 22.04 installiert. Ich hoffe, dieser Beitrag hilft dir dabei, OpenMRS auf einem Linux-basierten System einzusetzen, um die elektronische Patientenakte zu speichern und zu verwalten. Weitere Informationen findest du auf der OpenMRS-Dokumentationsseite. Wenn du Fragen hast, kannst du dich gerne an mich wenden.

Das könnte dich auch interessieren …