Troubleshooting

The workflow refuses to start

Start with the first journal diagnostic. Common causes include:

• required input not connected;
• invalid or missing parameter;
• moved source file;
• incompatible changed source schema;
• missing or changed database connection;
• missing required cache for a partial run.

Fix the reported cause rather than bypassing validation.

A cache is stale

A functional upstream change invalidates the cache. Rerun the affected section or run the whole workflow.

If the engine or cache contract changed after an update, regenerate caches. The .etl project can remain compatible even when its caches are not.

A spatial format does not work

The official distribution ships its own spatial runtime. Do not copy QGIS or system-GDAL DLLs into the Catenivo directory.

Check the format, companion files and expected CRS. Unsupported Z/M dimensions or geometry types should produce a diagnostic rather than a silent conversion.

A password is not retained on Linux

“Store on this device” requires a freedesktop Secret Service available in the desktop session, such as GNOME Keyring or compatible KWallet.

If the service is unavailable, use session storage. Catenivo does not write the secret to plaintext as a fallback.

The AppImage does not start

Make it executable:

chmod +x Catenivo_<version>_amd64.AppImage

Ubuntu Desktop 24.04 LTS x64 is the tested Linux reference. On another distribution, base-library incompatibilities can still occur.

Windows displays a warning

Catenivo binaries are currently not signed with a paid Authenticode certificate. Verify that the file comes from the expected release and check its SHA-256.

Report a problem

Keep:

• Catenivo version;
• operating system and version;
• exact error message;
• source/destination type;
• minimal reproduction steps.

Do not include passwords, tokens or sensitive data.