That’s useful for those you are on 3.18 running pulp2, but doesn’t help those you are running pulp3 and are on 4.0+. This chmod problem for instance only occurs on 4.3/pulpcore 3.16.
At a minimum, katello upgrade instructions needed to be updated, e.g. to include a simple find to see if there is a potential issue:
# find /var/lib/pulp/media/ \! -user pulp -ls
and then instruct the user to do the chown.
But I kind of don’t like these upgrade instructions where users have to fix things, that got broken somehow, when it could be easily scripted…