Preparation

Please ensure before the conversion that

• The source data base (custo diagnostics 4) and the target data base (custo diagnostics 5) are reachable and writable.
  (During the conversion all GUIDS of the corresponding newly created elements in the version 5 DB are recorded in the old version 4 DB)
• The source CST  directory is reachable and readable. 
• The tenant functionality is disabled in target system
• The destination DB (custo diagnostics 5) is empty
• All unassigned evaluations are assigned
• All tasks in the task manager are processed (no conversion of tasks takes place)

Optional checks before the conversion

Please check the following points before the conversion which however do not prevent the conversion:

• All user passwords match the password policy rules of the vesion 5 traget system, as the relevant users otherwise will be deactivated.

Automated checks of the tool

The following checks are done automatically by the conversion tool. In case of an error, the following repair steps are displayed:

Check	Stops the conversion process:	Description
Are the source and destination DBs reachable and writable?		If either the source or the destination DB are unreachable the conversion process is aborted,
Is the table scheme of the source DB correct?		In case of a lack of integrity in source DB (missing columns) the conversion is aborted. Please note that the source DB must be in the starte for version 4.5.x to have all tables correct.
Is the target system configured as tenant system?		In case a tenant configuration exists in the target system
Is the custocfg.ini in an integer state?		In case of integrity issues of the custocfg.ini, the conversion is aborted because it cannot be read automatically which system should be converted.
Are the at least 100 GB of free space on the CST target path?		In case of less than 100 GB of free disk space a warning message appears, however the conversion is still possible.
Is the target data base a H2 data base?		If  the target is a H2 DB a warning appears as the warning , as the conversion for H2 DBs may easily cause errors and as there is no possibility to work with multiple threads.
Is the target system old than 90 days?		In case the target system is older than 90 days there is a risk that the conversion may cause the loss of already existing configurations. A warning message appears, but the conversion is still possible.
Are there any evaluations in the target system?		In case there are evaluations in the target system, there is the risk that the conversion may overwrite already existing evaluations. A warning message is displayed, but the conversion can be continued.

Which content will not be converted?

In general everything is converted as well as possible. The folllowing 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 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 tatistics
• Evaluation groups
• The EvalOrderInfo table

Conversion of archived and moved evaluations

All archived evaluations are converted 1:1 and can be opened in custo diagnostics 5 System afterwards still as archived evaluations.

All moved evaluations from the version 4 will become also archived evaluations. In version 5 the flag "moved" does not exist any more. Moved and archived evaluations are hence treated equally in version 5. 

Trend files

For archived and moved evaluations trend files cannot be created, because in most cases it is not possible physically access thoise files. In CSC it is possible, that you get that error message recreation the trend files:

Options for the conversion

Configuration of the conversion

Option Beschreibung (1) Select here the custoCfg.ini of the source system from which it should be converted to custo diagnostics 5. (2) Select here to extend of the conversion (Full oder Smart-converson), see Options for the conversion On top in can be configured whether evalauations should be deleted in source system after the successful conversion of every single CST file. Please be careful with that option: You may have only one try! (3) Select here the time range of the conversion. (4) You may select here the conversion of the trends  ( is time consuming and can be rather performed afterwards) (5) Starts the whole conversion including the settings data base. (6) Starts the conversion of the patient master data and of the evaluations - without the settings.

Full conversion

In case of the full conversion everything configured in the time range (3) gets converted.

If you configure the last 2 years, only patients and evaluations of the last 2 years will be converted. Data beyond that will not be available in target system after the conversion.

Advantage:

 After completion of the full conversion with the time range "All" the custo diagnostics 4 system can be turned off.

Nachteile:

 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 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" 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 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 after the conversion to a full conversion (see Finish the Smart conversion)

Nachteile:

 The version 4 share must not be turned off as there is otherwise no more accessability given to the old evaluations
Trends trends may not be rebuilt completely
All version 5 clients require aceess to the share of the version 4 system

Conversion of trends

With (4) the conversion of trends can be activated.

Workflow

Konvertierung in ein System ohne Mandantensystem

Bei Konvertierung von Versionen kleiner 4.5.x

1. custo diagnostic updaten auf aktuelle 4.5.x oder höher
2. custo manager.exe (Version 4.5..x) einmal starten um sicherzustellen, dass die Datenbank aktuell ist.

Vor der Konvertierung

1. custo diagnostic 5.x installieren und einrichten (Lizenz, Standardarzt)
2. custo service center öffnen und Konverter-Seite aufrufen
3. Auf der Konverter-Seite auf (2) drücken und dort die CustoCfg.ini der 4.x-Version auswählen.
4. Optionen für die Konvertierung auswählen
5. Auf Start Database Conversion drücken. Danach öffnet sich die Seite für die Konvertierung der Konfigurationsdatenbank

Konvertierung der Einstelldatenbank

1. unter (1) stehen nochmal die Hinweise, dass der Supervisor nicht konvertiert und Benutzer, die nicht den Passwortrichtlinien entsprechen deaktiviert werden
2. Nachdem drücken auf (2) wird die komplette Einstelldatenbank konvertiert. Dies kann einige Minuten dauert

Fehler während der Konvertierung der Einstellungen

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

1. 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:
   1. Die Datenbank nicht zu konvertieren (zB weil mehrfach die gleiche gefunden wurde)
   2. Die Datenbank zu konvertieren wie sie ist
   3. Die Datenbank zu konvertieren ohne die Mandantenzuordnung
   4. Die Datenbank zu konvertieren und dabei alle Patienten einem bestimmten Mandanten zuzuordnen (siehe Konvertierung mit Mandantensystem)
2. Wenn alles eingestellt ist, klickt man auf Next.
3. Jetzt läuft die Konvertierung los und man kann den Fortschritt und die Geschwindigkeit sehen

1. Hier sieht man die Anzahl der bereits konvertierten Datenbankeinträge
2. Hier sieht man die Fehler, die bei den jeweiligen Datenbankeinträgen aufgetreten sind
3. 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:

1. Einstellungen (diese können sich zwischen den Versionen geändert haben)
2. Ärzte
3. Mandanten

Konvertierung mit Mandantensystem

Vorbereitungen

• 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
  
   
• Jetzt auch noch die Benutzer dem richtigen Mandanten zuordnen.

Finish the Smart conversion 

Hat man eine Datenbank smart konvertiert und möchte die bestehende diag 4 Instanz aber nach und nach abschalten sind folgende Schritte durchzuführen.

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

ID Beschreibung 1 Stell ein, mit wievielen Threads gleichzeitig der Import arbeiten soll Dieser Wert muss mit Bedacht gewählt werden, auf einem 1 Kernrechner sollte nicht mit mehr als 5 Threads gearbeitet werden, da das System sonst extrem langsam wird 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

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

FAQ