PdfHandler Debugging

PdfHandler Troubleshooting: Restart Routine

When adjusting PdfHandler prerequisites (Entware binaries, PATH updates, or MediaWiki configuration), make sure to restart both WebStation and the MediaWiki package.

Steps

Verify prerequisites are installed and callable:

which gs
which pdftoppm
which magick

Restart **WebStation**:

Control Panel → Web Services → WebStation → Restart

Restart **MediaWiki package**:

Package Center → Installed → MediaWiki → Restart

Clear cached test files if needed:

rm /volume1/web/mediawiki/images/*.pdf
rm /volume1/web/mediawiki/images/thumb/*.pdf

Upload a fresh PDF and confirm thumbnails are generated.

Notes

Restarting WebStation alone may not reload MediaWiki’s environment variables.
Restarting MediaWiki ensures new PATH and handler settings are applied.
Always document the rationale for successors: “Restart both packages after changes.”