...
Note |
---|
The conversion's source minimum requirement is version 4.5.0, as only from that version on all tables are in the exprected expected state for the conversion tool. In case of older versions please first upgrade the source system first to the current 4.5.x version. |
...
- All user passwords match the password policy rules of the vesion version 5 traget system, as the relevant users otherwise will be deactivated.
...
In general everything is converted as well as possible. The folllowing following features are however not (yet) processed by the conversion:
- The user "Supervisor"
- All data of the custo Kybe
- Open tasks in the task manager
- The table "events" (a log table), respecively respectively also all other log tables
- The table "Cfg_Update" (as well as all data base updates)
- Die table "system data" (is not applicable)
- Die table "Practice data" (now handled via "Doctor")
- Satellite sync data (there is no more satellite system)
- The import list
- Recorder patientens tatisticspatient statistics
- Evaluation groups
- The EvalOrderInfo table
...
For archived and moved evaluations trend files cannot be created, because in most cases it is not possible physically access thoise those files. In CSC it is possible, that you get that error message recreation the trend files:
...
Configuration of the conversion
|
|
|
Anchor | ||||
---|---|---|---|---|
|
...
After completion of the full conversion with the time range "All" the custo diagnostics 4 system can be turned off.
...
Disadvantages:
The conversion takes very long, as all CST files must be copied.
After a full conversion with the time range limit not all patients and evaluations are in the target system (may even be desired)
Smart conversion
The smart converson conversion always converts always the whole DB, but copies only CST-files, which are in the scope configured in (3). All other evaluations are marked internally as "smartConverted" and are only copied, if the relevant evaluation is opened up.
In case the user tries to open a smartConverted" smart Converted evaluation where the relevant files cannot be found, a message dialog appears in which the user should select the directory of the relevant CST file. On top the option "Delete version 4 CST-File after smart converted..." can be activated, which will get the original evaluation removed from the version 4 data directory, after the evaluation has been stored in the verson version 5 system.
Advantages:
The conversion can be performed very quickly
Most probably disk space can be saved in the target system
It is possible to complete the smart convesion conversion after the conversion to a full conversion (see Finish the Smart conversion)
...
Disadvantages:
The version 4 share must not be turned off as there is otherwise no more accessability access ability given to the old evaluations
Trends trends may not be rebuilt completely
All version 5 clients require aceess accees to the share of the version 4 system
...
With (4) the conversion of trends can be activated.
Note |
---|
If this options gets acticatedactivated, all evaluation files will be opened by the server and the trends will be recreated, which can take long time.. We do not recommend to do during the conversion. Trends may afterwards be created for every project in the administraton administration section. |
Workflow
Konvertierung in ein System ohne Mandantensystem
...
Conversion to a system without tenants
In case of conversion from versions lower than 4.5.x
- Upgrade the custo diagnostic updaten auf aktuelle to the most current version of 4.5.x oder höheror higher
- Start custo manager.exe (Version version 4.5..x) einmal starten um sicherzustellen, dass die Datenbank aktuell ist.
Vor der Konvertierung
- once to ensure that the DB scheme is the current one.
Before the conversion
- Install and configure custo diagnostic 5.x installieren und einrichten (Lizenz, Standardarzt(Licence, default doctor)
- Open custo service center öffnen und Konverter-Seite aufrufen(5.x) and open the conversion page
- On the conversion page click on Auf der Konverter-Seite auf (2) drücken und dort die and select there the CustoCfg.ini der of the 4.x-Version auswählenversion.
- Optionen für die Konvertierung auswählen
- Auf Start Database Conversion drücken. Danach öffnet sich die Seite für die Konvertierung der Konfigurationsdatenbank
Konvertierung der Einstelldatenbank
- unter (1) stehen nochmal die Hinweise, dass der Supervisor nicht konvertiert und Benutzer, die nicht den Passwortrichtlinien entsprechen deaktiviert werden
- Nachdem drücken auf (2) wird die komplette Einstelldatenbank konvertiert. Dies kann einige Minuten dauert
Info |
---|
In seltenen Fällen kann es passieren, dass das Service Center eingefroren erscheint (Wenn der Rechner stark ausgelastet ist) In diesem Fall bitte etwas Geduld haben und warten bis das Programm wieder aktiv wird |
Fehler während der Konvertierung der Einstellungen
- Select the options of the conversion.
- Click on Start Database Conversion. Afterwards the page for the conversion of the configuration DB will open.
Conversion of the configuration DB
- In (1) it is displayed again that the supervisor user does not get converted and that users which have no password according the password policy will be deactivated.
- After clicking on (2) the whole configuration DB will be converted. This may take some minutes time.
Info |
---|
It may happen, that the Service Center seems to be frozen. (In case the computer is highly loaded). Please be patient in in this case and wait for the program to reactivate. |
Errors during the conversion of the settings
In case of errors during the conversion of the settings, a dialog displaying the the problems appears. Those can be save later as well as Excel file and are stored in the Service Center logs in the path %PUBLIC%
Treten Fehler während der Konvertierung der Einstellungen auf, erscheint ein Dialog mit dem Hinweis auf die Probleme. Diese können später auch noch als Excel-Datei gespeichert werden und stehen in den service center logs unter %PUBLIC%/Roaming/customed/...servicecenter.log
Konvertierung der Patientendatenbank und der Auswertungen
Conversion of the patient DB and the evaluations
- Here it is possible to select the settings for every found patient master DB to be converted. To do so select the DB in (1) and click on Hier kann man für jede gefundene Patientenstammdatenbank die Einstellungen zur Konvertierung vornehmen. Dazu wählt man die Datenbank aus (1) und klickt auf "Edit Conversion Settings" (2). Hier gibt es folgende Möglichkeiten:
- Die Datenbank nicht zu konvertieren (zB weil mehrfach die gleiche gefunden wurde)
- Die Datenbank zu konvertieren wie sie ist
- Die Datenbank zu konvertieren ohne die Mandantenzuordnung
- Die Datenbank zu konvertieren und dabei alle Patienten einem bestimmten Mandanten zuzuordnen (siehe Konvertierung mit Mandantensystem)
- Wenn alles eingestellt ist, klickt man auf Next.
- Jetzt läuft die Konvertierung los und man kann den Fortschritt und die Geschwindigkeit sehen
- Hier sieht man die Anzahl der bereits konvertierten Datenbankeinträge
- Hier sieht man die Fehler, die bei den jeweiligen Datenbankeinträgen aufgetreten sind
- Zeigt den aktuellen Status (konvertiert / Gesamt + Geschwindigkeit in Einträgen pro Sekunde)
Abschluss der Konvertierung
Anschließend, wenn es keine groben Fehler gab, wird eine Fehler-Zusammenfassung angezeigt:
Mit (1) kann der gesamte Fehlerbericht als Exceltabelle gespeichert werden, so dass man alle Probleme auch nachträglich noch bearbeiten kann.
Danach ist die Konvertierung fertig und es sollten folgende Dinge gecheckt werden:
- Einstellungen (diese können sich zwischen den Versionen geändert haben)
- Ärzte
- Mandanten
Note |
---|
Die anzeigte Zahl der konvertierten Auswertungen "Successfully converted Evaluations" kann von der tatsächlichen Zahl der CST-Dateien abweichen, da:
|
...
- There are the following options:
- To not convert the DB (e.g. because the same one has been found several times)
- To convert the DB as it is.
- To convert the DB without tenant assignment.
- To convert the DB assigning the all patients to a particular tenant (see Conversion with tenant system)
- Once everything is configured click on Next.
- Now the conversion starts and you can see the progress and the speed.
- Here you can see the number of the already converted DB records
- Hier you can see the errors, which have occurred in the relevant DB records
- Shows the current state (converted / total + speed by records per second)
Completion of the conversion
Finally, in case there are no gross errors, an error summary is displayed:
With (1) it is possible to save the error report as Excel file, so that you can process the errors afterwards.
Afterwards the conversion is ready and the following checks should be done:
- Settings (those may have changed from version to version)
- Doctors
- Tenants
Note |
---|
The displayed numbers of converted evaluations "Successfully converted evaluations" may differ from the number CST files for the following reasons:
|
Conversion with tenant system
Anchor | ||||
---|---|---|---|---|
|
...
Preparation
Note |
---|
Vor der Konvertierung muss das Mandantensystem im Zielsystem (diag 5) ausgeschaltet sein! |
...
Before the conversion the tenant system in target system (version 5) must be turned off! |
- In case several patient master DBs should be distributed to several tenants the tenants must be created beforehand.
With that it is possible to simulate the feature that users have there own patient master data (meaning one config DB, several patient DBs)
Conversion to tenants
- Configure the settings the same way as in the conversion process without tenants and start it
- In the conversion settings for each DB in each case a previously created tenant can be selected:
- in case
- Wenn mehrere Patientenstammdatenbanken auf mehrere Mandanten verteilt werden sollen. So müssen die Mandanten vor der Konvertierung angelegt werden.
Damit kann man das Feature nachstellen, dass Benutzer eigene Patientenstammdatenbanken haben (also eine Konfig-DB, mehrere Patienten-DBs)
Konvertierung in die Mandanten
- Einstellung dann genau so wie beider Konvertierung ohne Mandanten machen und starten
- Bei den Conversion Settings zu jeder Datenbank kann dann jeweils ein vorher angelegter Mandant ausgewählt werden:
- Wenn "Convert and keep tenant settings" ausgewählt ist, so werden die Mandanten der Patientenstammdatenbank einfach mit konvertiert und alles ist so wie früher
- Nach der Konvertierung nur "Patienten mandantenbasiert" anmachen. Damit funktioniert das Mandantensystem so wie in der 4.x
- is selected, the tenant of the master DB are simply converted as well and everything is as in the former system
- Turn on "Patients / Patient visits tenant based" after the conversion: This way the tenant system works like in version 4.x.
- Now assign as well the users to the right tenantJetzt auch noch die Benutzer dem richtigen Mandanten zuordnen.
Finish the Smart conversion
Anchor | ||||
---|---|---|---|---|
|
Hat man eine Datenbank smart konvertiert und möchte die bestehende diag 4 Instanz aber nach und nach abschalten sind folgende Schritte durchzuführen.
Note |
---|
Die Konvertierung sollte von einem rechenstarken PC mit guter Netzwerkanbindung, sowohl an den Server als auch das Datenverzeichnis von diag 4 durchgeführt werden, um eine effiziente Konvertierung gewährleisten zu können. |
Suchen der smart-converted Auswertungen
Über die Auswertungssuche im CSC kann sehr komfortabel nach allen Smart-Converted Auswertungen (1) gesucht werden. Möchte man beispielsweise in kleineren Schritten die Migration durchführen, da man immer nur ein kleines Zeitfenster hat, macht es auch Sinn noch nach einem Zeitraum, oder auch Projekt zu filtern. Im folgenden Screenshot werden zum Beispiel nur die (3) LZ-EKGs der (2) letzten 5 Jahre gesucht.
Aus dieser Liste kann man jetzt mit STRG+Klick, oder UMSCHALT+Klick einzelne Auswertungen, oder einen Bereich von Auswertungen, oder mit STRG+A die gesamte Liste auswählen und über (4) Ändern → Import smart converted evaluations in den Import-Dialog gelangen
Einstellen der Einlagerung
Warning |
---|
Die Anzahl der Threads für die Konvertierung sollte immer defensiv gewählt werden. Maximal sind 48 Threads möglich |
...
ID | Beschreibung |
---|---|
1 | Stell ein, mit wievielen Threads gleichzeitig der Import arbeiten soll |
2 | Hier kann ein zusätzliches Datenverzeichnis angegeben werden, in dem nach den CST-Dateien gesucht werden soll. Dies ist hilfreich, falls Auswertungen verschoben, oder manuell archiviert wurden |
3 | Ist diese Option aktiviert, werden die Auswertungen nach dem Einlagern im diag 5 System aus dem Datenverzeichnis von diag 4 gelöscht |
4 | Startet den Import der Auswertungen |
In case a DB has been smart converted, but you want to switch off the version 4 installation step by step the following steps need to be taken.
Note |
---|
The conversion should be performed by a powerful PC with good network connection to both the server as well as the data directory of the version 4 to ensure an efficient conversion. |
Searching of smart converted evaluations
Via the evaluation search in the custo diagnostics Service Center in is possible to easily search for smart converted evaluations (1). In case the migration should be done e.g. in small steps, becasue there always only a small time frame it makes sense to filter by time period or as well by project. In the following example screen shot only the the (3) long term EKGs of the (2) last 5 years were searched.
In this list it is possible to select with STRG+click, or SHIFT+click single evaluations or a scope of evaluations, or with STRG+A the whole list and by (4) change → Import smart converted evaluations to change to the import dialog:
Configuration of the import
Warning |
---|
The number of threads for the conversion should be selected with care - max 48 threads are possible. |
|
Clean-up of custo diagnostic 4
After the transfer of all evaluations or if you consider the transfers made to be sufficient, the version 4 share can be moved to an archive media or deleted.
Trouble shooting
During the conversion it is possible to display the logs from the Service center beneath
Aufräumen von custo diagnostic 4
Nach dem Einlagern aller Auswertungen, oder wenn man der Ansicht ist, dass es jetzt genug ist, kann der diag 4 Share gelöscht oder auf ein Archivmedium verschoben werden
Fehlersuche
Während der Konvertierung ist es möglich die Service-Center logs unter: %PUBLIC%/Roaming/customed/...servicecenter.log
in einem geeigneten Viewer mitlaufen zu lassen. So ist es möglich Fehler schnell schon während der Konvertierung zu entdecken. Zum Abschluss der Konvertierung kann immer der gesamte Fehlerbericht als Excel-Datei zusätzlich gespeichert werden.
Klassische Fehlereinträge
an appropriate viewer. This way it is possible to quickly discover as soon as possible during the conversion.. At the end of the conversion the whole error report cam always be saved as Excel file on top.
Classical error records
Error message | Fix | Fehlermeldung | Abhilfe |
---|---|---|---|
CST file 'xxx' was not foundPrüfen, ob die CST-Datei gelöscht oder wo anders hin verschoben | wurdeCheck whether the CST file was deleted or moved. | ||
CST file 'xxx' is damaged and could not be opened | Eventuell prüfen, ob die CST-Datei noch über ein Backup wieder hergestellt werden kann. Ansonsten ist diese Datei verlorenCheck if it is possible to restore the CST file from a backup. Otherwise the file is lost. | ||
Could not delete file 'xxx' | Es wurde eingestellt, dass die Dateien aus dem diag 4 System gelöscht werden sollen, aber jetzt fehlen scheinbar die Rechte dazu. Die Schreibrechte werden vor der Konvertierung geprüft, Löschrechte nichtIt has been configured, that the files of the version 4 system should be deleted, but then the rights seemed to be missing. Write rights are checked before the conversion, but not the deletion rights.. | ||
Could not decompress file 'xxx' because the ZIP file seems to be empty | Passiert bei archivierten und / oder verschobenen Auswertungen, hier sollte geprüft werden, ob die Auswertungen im diag 4 System noch geöffnet werden können. Falls ja, können sie danach noch in diag 5 eingelagert werdenHappens with archived and / or moved evaluations. There it should be checked whether the evaluations sill can be opened in the version 4 system. If so, they still can be transferred afterwards to version 5 system. | ||
Could not copy file 'xxx' to: 'yyy' | Dieser Fehler tritt auch auf, wenn während der Konvertierung der Plattenplatz ausgegangen ist. Es wird zwar vor der Konvertierung geprüft, ob noch mindestens 100GB frei sind, aber bei großen Systemen können 100GB ggf. nicht ausreichen. |
FAQ
This error occurs as well in case of a lack of disk space during the conversion. It is in fact checked before the conversion if at least 100GB are still free, but for big systems 100 GB may not be enough. |
FAQ
Question | Answer |
---|---|
Is it still possible to work during the conversion in the source system? | This is not recommended, as changes during the conversion may not be transferred. |
I have created still evaluations in the source system during / after the conversion. How to proceed with those ones? | Those evaluations may be imported with the known limitations. |
Is it possible for me to work during the conversion process already in the target system? | No, this is not recommend as there is the risk that newly created data may be overwritten by the conversion. |
I have only a small time frame for the real conversion. What should I do? | By using the Smart Conversion it is possible to convert as well big DBs quickly, without the need not copy CST files from one system to the other. After the completion if the smart conversion the customer may immediately continue to work with the version 5 system and the remaining CST file can be transferred afterwards in custo diagnostics version 5. |
I have made still evaluations in the version 4 system and the version 5 was running as well | The conversion process stores which evaluations already were converted. Hence it is possible always follow-up with the conversion. With that only new evaluations will be converted. |
I have selected smart conversion option only back the last 2 years. Now I need to have also older evaluations. Should I start the migration again? | With the smart conversion the whole database gets converted. So only the evaluations were imported back 2 years. To get also older evaluations imported use the import evaluations function in the Service Center. |
Frage | Antwort |
Kann ich während der Konvertierung noch im Quellsystem arbeiten? | Das ist nicht empfohlen, da Änderungen während der Konvertierung bereits eventuell nicht übernommen werden |
Ich habe während / nach der Konvertierung noch Auswertungen im Quellsystem erzeugt. Was mache ich mit diesen? | Diese Auswertungen können mit den bekannten Einschränkungen eingelagert werden. |
Kann ich während die Konvertierung der Datenbank läuft schon im Zielsystem arbeiten? | Nein, das wird nicht empfohlen, da sonst das Risiko besteht, dass neu erzeugte Daten durch die Konvertierung überschrieben werden |
Ich habe nur wenig Zeit für die tatsächliche Konvertierung, was soll ich tun? | Mit der Smart-Konvertierung kann man auch große Datenbanken relativ schnell konvertieren, ohne dass die CST-Dateien hin- und herkopiert werden müssen. Nach dem Abschluss der Smart-Konvertierung kann der Kunde sofort im diag 5 System weiter arbeiten und man kann die restlichen smart-CST-Dateien nachträglich im diag 5 System einspeisen. |
Ich habe noch Auswertungen im diag 4 System gemacht und die diag 5 lief schon | Die Konvertierung vermerkt sich, welche Auswertungen bereits konvertiert wurden. Man kann also jederzeit nachkonvertieren, dabei werden nur die neuen Auswertungen konvertiert |