# Parallele Ausführung

QV2QS konvertiert mehrere Projekte gleichzeitig mithilfe eines konfigurierbaren Prozesspools.

## Worker-Konfiguration

Standardmäßig erkennt QV2QS automatisch die optimale Worker-Anzahl basierend auf der Anzahl der logischen CPU-Kerne auf dem Rechner. Die Standardeinstellung (`--batchWorkers 0`) verwendet einen Worker weniger als die Anzahl der Kerne, sodass ein Kern für den Orchestrator-Prozess und das Betriebssystem frei bleibt.

Um mit einer expliziten Anzahl zu überschreiben, übergeben Sie `--batchWorkers N`:

```
QV2QS.exe --batchDir "C:\Projects" --outputDir C:\Output --batchWorkers 4 --unbuildOnly
```

Wenn die angegebene Worker-Anzahl die Anzahl der verfügbaren CPU-Kerne überschreitet, gibt QV2QS eine Warnung aus. Jeder zusätzliche Worker über die Anzahl der Kerne hinaus verursacht einen Speicher-Overhead von etwa 80 MB bei minimaler Verbesserung der Wall-Clock-Zeit.

Die lokale Konvertierungsphase verwendet einen Prozesspool. Jeder Worker wird in einem separaten Prozess ausgeführt, was echte CPU-Parallelität für das XML-Parsing, das Traversieren des Objektgraphen und die JSON-Generierung ermöglicht, aus denen die Konvertierung besteht. Wenn ein Projekt fehlschlägt, laufen die verbleibenden Projekte weiter. Jeder Worker-Prozess schreibt eine separate Protokolldatei in den Projektunterordner `logs/`.

Die Cloud-Bereitstellung verwendet einen Thread-Pool mit derselben Worker-Anzahl. Nachdem alle lokalen Konvertierungen abgeschlossen sind, stellt QV2QS die konvertierten Apps parallel in Qlik Cloud bereit. Die Konsolenausgabe wird während der parallelen Cloud-Bereitstellung vereinfacht — animierte Spinner werden durch statische Fortschrittszeilen ersetzt, um eine unleserliche Ausgabe zu vermeiden.

## Fehlerbearbeitung

Der Batch-Modus wird trotz Fehlern fortgesetzt. Wenn ein Projekt während der Konvertierung fehlschlägt, protokolliert QV2QS den Fehler und fährt mit den verbleibenden Projekten fort. Das fehlgeschlagene Projekt wird in der Batch-Zusammenfassung mit einer Fehlerbeschreibung angezeigt. Der Batch-Exit-Code lautet `0`, wenn alle Projekte erfolgreich sind, und `1`, wenn ein Projekt fehlschlägt.

Die Fehlerisolierung gilt auch für die Berichterstellung. Wenn ein Projekt erfolgreich konvertiert wird, aber der Excel-Bericht nicht generiert werden kann, wird das Projekt dennoch als erfolgreich gewertet. Der Berichtsfehler wird separat protokolliert.

Fehler bei der Cloud-Bereitstellung werden auf dieselbe Weise isoliert. Wenn die Bereitstellung eines Projekts fehlschlägt, werden die verbleibenden Projekte weiterhin bereitgestellt.

## Mehr erfahren

* [So funktioniert das Stapelscannen](https://help.qlik.com/de-DE/migration/Content/Qv2qsMigration/batch-conversion/how-batch-scanning-works.htm)
* [Stapelberichterstellung](https://help.qlik.com/de-DE/migration/Content/Qv2qsMigration/batch-conversion/batch-reporting.htm)
* [Leistungsbenchmarks](https://help.qlik.com/de-DE/migration/Content/Qv2qsMigration/batch-conversion/performance-benchmarks.htm)