Section Number and Name:
U&U guide: 4.5. Reclaiming PostgreSQL Space After an Upgrade
Administering guide: 11.5. Reclaiming Disk Space from MongoDB
Describe the issue:
The sections are very related to each other but they reside in different guides, so it is complicated to find one after finishing another.
Suggestions for improvement:
1. Review the section about cleaning MongoDB because it is outdated. For example it uses systemctl instead of foreman-maintain to stop and start services. The correct command must be the following:
# foreman-maintain service stop --only pulp_celerybeat.service,pulp_resource_manager.service,pulp_streamer.service,pulp_workers.service
# foreman-maintain service start
2. Possible verify the secion on reclaiming MongoDB space with pmoravec.
2. I suggest reusing the sections in both Admin and U&U guides. They belong to the admin guide because they really have something to do with Maintaining Satellite Server. And they belong to the U&U guide because cleaning space after an upgrade is a real post-upgrade task, because during the upgrade lots of space is taken by backups.
3. In the U&U guide, the section 4.4. Upgrading the MongoDB Storage Engine refers to the KCS article How to compact MongoDB files and/or reclaim disk space in "/var/lib/mongodb" in Satellite 6? . The reference should point to the corresponding section in our docs, not to a KCS article. I linked the KCS article because did not know that such section exists in our documentation.