From 3a45aff760f39ac63dc336d82c85b02900e16324 Mon Sep 17 00:00:00 2001 From: Konrad Bucheli Date: Tue, 9 Jul 2024 11:15:21 +0200 Subject: [PATCH] document PSON investigation --- admin-guide/puppet/client.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/admin-guide/puppet/client.md b/admin-guide/puppet/client.md index 26dedc99..32eb6d0b 100644 --- a/admin-guide/puppet/client.md +++ b/admin-guide/puppet/client.md @@ -14,3 +14,19 @@ curl \ "https://puppet01.psi.ch:8140/puppet/v3/node/$FQDN?environment=prod&configured_en" \ | jq . ``` + +## PSON + +Sometimes the puppet agent emits: +``` +Info: Unable to serialize catalog to json, retrying with pson. PSON is deprecated and will be removed in a future release +``` +These should be fixed in the puppet code as with Puppet 8 this will fail hard. + +To figure out what part of the catalog is concerned, look at `/opt/puppetlabs/puppet/cache/client_data/catalog/$(hostname --fqdn).json`. +Then search for `\u` which starts a binary (non-utf8) character in PSON in a way that is still valid JSON. + +Please improve the Puppet code wherever such non-utf8 strings are used. Be aware that not only resources, but also arguments to profiles, classes, etc. end up in the catalog. + + +