Versions Compared

Key

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

...

Note

If this options gets acticated, 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 section.


Workflow

Konvertierung in ein System ohne Mandantensystem

...

Conversion to a system without tenants

In case of converson 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 (LizenzLicence, Standardarztdefault 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 converson 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 occured 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 evaluatons "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+Klick 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 helful 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 suffient, 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 pssible 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 enoguh.

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 evaluatins 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 the only new evaluations will be converted.

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