Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

Image Modified


OptionBeschreibung
(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

conversion), see Options for the conversion

On top in can be configured whether

evalauations

evaluations should be deleted in source system after the successful conversion of every single CST file.

(warning) 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  ((warning) 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.


Anchor
conversionOption
conversionOption
Full conversion

...

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

...

Disadvantages:

(error) The conversion takes very long, as all CST files must be copied.
(error) 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:

(tick) The conversion can be performed very quickly
(tick) Most probably disk space can be saved in the target system
(tick) It is possible to complete the smart convesion conversion after the conversion to a full conversion (see Finish the Smart conversion)

...

Disadvantages:

(error) The version 4 share must not be turned off as there is otherwise no more accessability access ability given to the old evaluations
(error) Trends trends may not be rebuilt completely
(error) 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

  1. Upgrade the custo diagnostic updaten auf aktuelle to the most current version of 4.5.x oder höheror higher
  2. Start custo manager.exe (Version version 4.5..x) einmal starten um sicherzustellen, dass die Datenbank aktuell ist.

Vor der Konvertierung

  1. once to ensure that the DB scheme is the current one.

Before the conversion

  1. Install and configure custo diagnostic 5.x installieren und einrichten (Lizenz, Standardarzt(Licence, default doctor)
  2. Open custo service center öffnen und Konverter-Seite aufrufen(5.x) and open the conversion page
  3. 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.
  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

Image Removed

  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
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

  1. Select the options of the conversion.
  2. Click on Start Database Conversion. Afterwards the page for the conversion of the configuration DB will open.

Conversion of the configuration DB

Image Added

  1. 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.
  2. 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

Image Removed

Conversion of the patient DB and the evaluations

Image Added

  1. 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:
    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

Image Removed

  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:
Image Removed

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
Note

Die anzeigte Zahl der konvertierten Auswertungen "Successfully converted Evaluations" kann von der tatsächlichen Zahl der CST-Dateien abweichen, da:

  • Multidayauswertungen zusammengefasst werden
  • Archivierte Auswertungen und Trendauswertungen nicht konvertiert werden
  • Gewisse Altlastenstände gelegentlich nicht konvertiert werden können

...

  1. There are the following options:
    1. To not convert the DB (e.g. because the same one has been found several times)
    2. To convert the DB as it is.
    3. To convert the DB without tenant assignment.
    4. To convert the DB assigning the all patients to a particular tenant (see Conversion with tenant system)
  2. Once everything is configured click on Next.
  3. Now the conversion starts and you can see the progress and the speed.

Image Added

  1. Here you can see the number of the already converted DB records
  2. Hier you can see the errors, which have occurred in the relevant DB records
  3. 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:
Image Added

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:

  1. Settings (those may have changed from version to version)
  2. Doctors
  3. Tenants


Note

The displayed numbers of converted evaluations "Successfully converted evaluations" may differ from the number CST files for the following reasons:

  • Multi day evaluations are merged
  • Archived and trend evaluations are not converted
  • Certain orphan states may not be converted


Conversion with tenant system
Anchor
convertWithTenant
convertWithTenant

...

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!

Image Added

  • 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:
    Image Added
  • 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:
    Image Removed
  • 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
    Image Removed
     
  • 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.
    Image Added
     
  • Now assign as well the users to the right tenantJetzt auch noch die Benutzer dem richtigen Mandanten zuordnen.

Finish the Smart conversion 
Anchor
smartConversionFinish
smartConversionFinish

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

Image Removed

Einstellen der Einlagerung

Warning

Die Anzahl der Threads für die Konvertierung sollte immer defensiv gewählt werden. Maximal sind 48 Threads möglich

...

Image Removed

IDBeschreibung
1Stell ein, mit wievielen Threads gleichzeitig der Import arbeiten soll
(warning)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 (warning)
2Hier 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
3Ist diese Option aktiviert, werden die Auswertungen nach dem Einlagern im diag 5 System aus dem Datenverzeichnis von diag 4 gelöscht
4Startet 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:

Image Added

Configuration of the import

Warning

The number of threads for the conversion should be selected with care - max 48 threads are possible.


Image Added


IDDescription
1Configures with how many threads in parallel the import should be performed 
(warning)This value should be selected with care: Per core not more than 5 threads should be used, as the system otherwise will be extremely slow (warning)
2Here it is possible to define an additional data directory, in which it should be searched for CST files. This is helpful in case evaluations wee moved or manually archived.
3If this option is active, evaluations are deleted from the version 4 data directory after the transfer to the version 5 system.
4Starts the import of the evaluations.


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 messageFixFehlermeldungAbhilfe
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 openedEventuell 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