====== 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 [[https://magentacloud.de/s/aXwMYrcxnMmaiCE|Datensicherung]] (Backup) und [[https://magentacloud.de/s/xCETJbwkA9i5PNs|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.