Testumgebung erstellen (für Anfänger)

Diese Anleitung richtet sich an Testwillige, die noch sehr unsicher im Umgang mit dem Computer sind und eine Schritt für Schritt Anleitung beim Erstellen einer Testumgebung benötigen.
Die Installation für die Testumgebung soll auf einem separaten Computer, der nicht mit der Praxisdatenbank verbunden ist erfolgen.

Ich habe versucht die Anleitung möglichst einfach und verständlich zu halten.
Sollte etwas doch unklar sein, bitte ich um Rückmeldung per Nachricht über das Forum https://www.thera-pi-software.de/forum/memberlist.php?mode=email&u=1615

Testwillige, die unbedingt auf dem Praxisrechner testen wollen oder müssen, wenden sich bitte an einen der Supporter im Forum.

Benötigte Hard- und Software

1 Windows (10 oder 11) Laptop oder Desktoprechner
die Installationsanweisung von Thera-pi https://www.thera-pi-software.de/download/2638/?tmstv=1722155957
die Basissoftware für die Installation von Thera-Pi aus dem Downloadbereich der Thera-pi Homepage https://www.thera-pi-software.de/downloads (die Thera-pi Bibliotheken und der Installer werden nicht benötigt! Thera-pi muss nicht nochmal installiert werden!)
das Programm 7-Zip https://7-zip.org/a/7z2407-x64.exe
für Datensicherung (Backup) und Wiederherstellung (Restore) diese beiden Skripte herunterladen und ans eigene System anpassen

Vorbereitung des Testrechners

Installieren Sie die Basissoftware wie in der Installationsanweisung beschrieben (Schritte I bis VI)
merken Sie sich unbedingt das root-Passwort für die Datenbank!
statt die MariaDB Parameter händisch anzupassen, können Sie auch einfach die my.ini vom Praxisrechner in das entsprechende Verzeichnis auf dem Testrechner kopieren
legen Sie einen Ordner Backups auf Laufwerk C: an
kopieren Sie das Skript Wiederherstellung_manuell (für die Wiederherstellung der Datenbank) in dieses Verzeichnis

Erstellen einer Testdatenbank

doppelklicken Sie auf Ihrem Desktop auf das Icon HeidiSQL
es öffnet sich der Verbindungsmanager
es sollte im linken Bereich eine Verbindung Unnamed stehen
sollte unter Verbindungsname noch nichts stehen, so klicken Sie unten auf Neu und es wird eine Verbindung Unnamed angelegt. Unter Host sollte 127.0.0.1 stehen
im rechten Bereich geben Sie bei Benutzername: root ein
bei Passwort geben Sie ihr Passwort ein, das Sie sich weiter oben merken sollten
bei Port muss 3306 eingestellt sein
klicken Sie nun auf Öffnen

Es öffnet sich ein neues Fenster. Im linken Bereich sollten sich bereits die Datenbanken information_schema, mysql, performance_schema (diese 3 nicht löschen!) und im Idealfall Ihre bei der Installation von MariaDB erstellte Testdatenbank

Sollte sich Ihre Testdatenbank nicht dort befinden so

klicken sie in einem freien Bereich mit der rechten Maustaste
wählen Sie Neu erstellen - > Datenbank
trage Sie unter Name: den Datenbanknamen ein
Kollation: muss utf8mb3_general_ci sein
klicken Sie auf OK und sie haben eine (noch leere) Testdatenbank

Anpassen des Wiederherstellung Skriptes

gehen Sie in den Ordner Backups
klicken Sie rechts auf Wiederherstellung_manuell
wählen Sie im sich öffnenden Menü Bearbeiten
lassen Sie alle Einstellungen bis auf die folgenden Zwei
geben Sie ganz unten bei set db= Ihren Datenbanknamen auf dem Testrechner ein
in der Zeile set pw=-p können Sie nach dem „-p“ ihr Passwort für die Datenbank eingeben. Geben Sie hier nichts ein, so fragt das Skript das Passwort später ab
Klicken Sie nun auf Datei→ Speichern unter
(wichtig) fügen Sie dem Dateinamen ein .cmd an ( die Datei heißt dann Wiederherstellung_manuell.cmd)
bei Codierung sollte UTF-8 stehen
klicken Sie auf Speichern

Datensicherung (Backup) auf dem Praxis Rechner

Im Idealfall haben Sie bereits ein funktionierendes Backup-Skript auf Ihrem Praxisrechner.
In diesem Fall machen Sie nun bitte eine Sicherung der Datenbank sowie vom RehaVerwaltung Ordner und speichern Sie Diese auf einem USB Stick.

Haben Sie allerdings noch kein funktionierendes Backup Skript, dann ist heute Ihr Glückstag, denn Sie bekommen jetzt ein Solches.

Vorbereitungen auf dem Praxisrechner

Prüfen Sie , ob das Programm 7-Zip auf dem Praxisrechner installiert ist, wenn nicht installieren sie es (siehe Link oben)
Erstellen Sie einen Ordner Backups auf Laufwerk C:
kopieren Sie die Datei Backup_Manuell aus dem Download oben in diesen Ordner Backups

Anpassen des Datensicherungs Skripts

gehen Sie in den Ordner Backups
klicken Sie rechts auf Datensicherung_manuell
wählen Sie im sich öffnenden Menü Bearbeiten
set mysql= wenn Sie MariaDB 10.6 installiert haben lassen Sie die Einstellung, ansonsten ändern Sie es auf die installierte Version, z.B 10.5
in der Zeile set pw=-p können Sie nach dem „-P“ ihr root Passwort für die Datenbank eingeben. Geben Sie hier nichts ein, so fragt das Skript das Passwort später ab
set host= liegt Ihre Datebank auf dem Praxisrechner brauchen Sie nichts zu ändern
liegt die Datenbank auf einem Server (NAS oder Homeserver), so geben Sie hier die IP Adresse ein. Sie finden die IP Adresse in der rehajava.ini unter c:RehaVerwaltung/ini/ihr IK der Zeile DBKontakt1 = jdbc:mysql://**IP Adresse**:3306/datenbankname
set db= Datenbankname hier bitte den Datenbanknamen eintragen
alle anderen Einstellungen können Sie so belassen
Klicken Sie nun auf Datei→ Speichern unter
(wichtig) fügen Sie dem Dateinamen ein .cmd an ( die Datei heißt dann Datensicherung_manuell.cmd)
bei Codierung sollte UTF-8 stehen
klicken Sie auf Speichern

Herzlichen Glückwunsch, Sie haben jetzt ein Backup-Skript und können nun Ihre Datenbank sichern!

Sicherung der Datenbank

Beenden Sie Thera-Pi, falls es noch läuft
Öffen Sie den Ordner C:Backups
doppelklicken Sie mit der linken Maustaste auf Datensicherung_Manuell
das Backup Skript startet nun
beantworten Sie die ersten 2 Fragen mit J für Ja und drücken Sie Enter
nun fragt das Skript was alles gesichert werden soll…wählen Sie 3 für Beides und drücken Sie Enter
nun beginnt die Datensicherung
wenn Sie im Backup Skript bei set pw=-p nichts weiter eingetragen haben, wird nun nach dem Passwort der Datenbank gefragt. Geben Sie das Passwort nun ein und drücken Sie Enter
wenn die Datenbank gesichert ist, erhalten Sie eine Rückmeldung Fertig mit dem Kopieren der SQL-Datenbank
Drücken Sie nun eine beliebige Taste
nun wird der RehaVerwaltung Ordner gesichert, ggf. wird wieder das Datenbankpasswort abgefragt
Sie bekommen nun eine Rückmeldung Fertig mit dem Packen des Ordners
drücken Sie 2x eine beliebige Taste
je nach Datenbankgröße und Rechnerleistung kann die Sicherung zwischen 1 und 10 Minuten dauern
Nun sind alle Daten gesichert
drücken Sie 4 und Enter um das Backup Skript zu beenden

Nun haben Sie auf Laufwerk C: im Ordner Backups einen neuer Unterordner BackUp_TheraPi. In diesem Ordner befindet sich ihre Datensicherung im Format „Datenbankname_JJJJ_MM_TT“, die Sie auf einen USB Stick kopieren.

Wiederherstellung (Restore) der Datenbank auf dem Testrechner

verbinden Sie den USB Stick mit dem Testrechner
öffnen Sie auf dem USB Stick das Verzeichnis, in das Sie die Datensicherung kopiert haben
Sie sehen nun den Ordner mit der Datensicherung Datenbankname_JJJJ_MM_TT
gehen Sie mit der Maus auf die Datensicherung, es sollte nun ein „Mouseover“ Fenster erscheinen, in dem Sie sehen können was sich in dem Ordner befindet
merken Sie sich bei Erstelldatum die Uhrzeit (z.B. 18:46 Uhr)
klicken Sie nun mit der rechten Maustaste auf den Dateinamen und wählen Sie kopieren
wechseln Sie auf das Laufwerk C: in den Ordner Backups
klicken Sie mit der rechten Maustaste in einen freien bereich und wählen Sie Einfügen

Nun wird die Datensicherung in diesen Ordner kopiert.

nun Doppelklick auf Wiederherstellung_Manuell
jetzt J Enter eingeben
geben Sie nun das Jahr, den Monat und den Tag der wiederherzustellenden Datensicherung ein und bestätgen Sie jeweils mit Enter
geben Sie nun die Uhrzeit der Datensicherung (ohne Doppelpunkt!) ein, z.B. 1846 bestätigen Sie mit Enter

Nun sollte der Inhalt des Datensicherungsordners angezeigt werden (min. 2 Dateien).

wenn die Dateien angezeigt werden geben Sie nun J Enter ein

Das Wiederherstellung Skript fragt nun, ob die Datenbank im Kasten Databases angezeigt wird.

ist dies der Fall geben Sie J Enter ein

Nun werden nochmal Datenbankname, Benutername, ggf. das Passwort und der Ort der Datenbank (localhost=auf dem Rechner) angezeigt.

Wenn alles korrekt ist geben Sie J Enter ein.

Jetzt wird gefragt, was wiederhergestellt werden soll.

geben Sie zuerst 1 Enter für Datenbank ein

Die Wiederherstellung beginnt nun.
Je nach Datenbankgröße kann dies zwischen 1 und 10 Minuten Dauern…wie bei der Sicherung.
Wenn die Wiederherstellung abgeschlossen ist kommt folgende Meldung:
Fertig mit dem Kopieren der SQL-Datenbank Drücken Sie eine beliebige Taste . . .

Sie sind nun wieder im Auswahlmenü, wählen Sie nun die 2 Enter für den RehaVerwalung Ordner.
Die Wiederherstellung beginnt jetzt.
Der wiederhergestellte RehaVerwaltung Ordner befindet dich nun unter C:Backups

Den wiederhergestellten RehaVerwaltung Ordner nun einmal kopieren
ins Laufwerk C: wechseln
den aktuellen RehaVerwaltung Ordner (wenn vorhanden) umbenennen (z.B. RehaVerwaltung_bis (aktuelles Datum)
zuletzt per Rechtsklick → Einfügen den neuen RehaVerwaltung einfügen

Wenn Ihre Datenbank lokal auf dem Praxisrechner läuft müssen Sie nichts weiter anpassen.

Läuft die Datenbank allerdings auf einem Server o.ä. und oder der Datenbankname hat sich geändert, müssen Sie noch in der rehajava.ini eine Zeile ändern:

DBKontakt1 = jdbc:mysql://localhost:3306/datenbankname
DBName1 = datenbankname
DBBenutzer1 = root
DBPasswort1 =
DBServer1 = localhost

Trägt man bei DBPasswort1 nichts ein, wírd das (Datenbank-)Passwort beim Start von Thera-Pi einmalig abgefragt und wîrd dann automatisch (verschlüsselt) in die rehajava.ini übernommen.

Neue Verknüpfung zu Thera-Pi auf dem Desktop erstellen

Um Thera-Pi bequem per KLick auf ein Icon zu starten, muss nun noch eine Verknüpfung auf dem Desktop erstellt werden:

Doppelklick auf den RehaVerwaltung Ordner
soweit runterscrollen, bis Sie die TheraPi.jar sehen (manchmal wird nur TheraPi angezeigt…je nach Einstellung)
Rechtsklick auf TheraPi.jar
Verknüpfung erstellen auswählen
über Therapi.jar erscheint nun eine Datei TheraPi-Verknüpfung
diese Datei per Rechtsklick kopieren und auf dem Desktop einfügen.

Nun können Sie die Thera-Pi per Doppelklick auf dieses Icon starten.