Language: Deutsch · English

Migrating to JasperReports library 6.17.0

Migrate old Jasper reports to the current library version via the management console.

HOW-TO ADMINISTRATOR UPDATED: JUL 2026 APPLIES TO NUCLOS 4.2026.X

On this page

When to migrate?

This guide assumes a switch to Nuclos ≥ 4.50. Old Jasper reports in the database can be adapted to the current Jasper version via the management console – ideally automatically. This fixes warnings but is not mandatory: if your reports look as usual and there are no warnings in the log, you may keep them in the old version.

Prerequisite: update fonts

Under Configuration → Nuclet, check the Extensions of each nuclet for outdated font JARs. Recreate the font extension in Jaspersoft Studio and replace the old JAR in the nuclet.

Migration via the management console

Open Administration → Management Console….
Choose the command -migrateJasperReports.
Run it without parameters first – the output shows which reports are current and which need migrating.
Then migrate automatically with -patch -removeDeprecatedPdfFonts.
To migrate again with other parameters, add -forceAll.

Parameters

Parameter	Effect
-patch	performs the migration (without: information only).
-forceAll	migrates all reports, not just older ones.
-removeDeprecatedPdfFonts	removes the deprecated „pdfFont“ tag.
-overwriteReportFonts "<font>"	sets all font names (default: „DejaVu Sans“).

Outputs

Outputs include: Successfully patched …, Patching failed for …, Found … report(s) matching/with a newer version. Check reports with a newer version particularly carefully.