theforeman / foreman-documentation

Documentation for the Foreman Project and its ecosystem
https://docs.theforeman.org
Creative Commons Attribution Share Alike 4.0 International
17 stars 91 forks source link

Fix the "Installing an External Smart Proxy Server on Debian" guide #647

Open ekohl opened 3 years ago

ekohl commented 3 years ago

https://docs.theforeman.org/nightly/Installing_Proxy_on_Debian/index-foreman-deb.html contains many thing that are incorrect. I think some of these also affect Foreman without Katello installations.

The users apache, foreman and postgres will not be needed. apache doesn't even exist on Debian (it's www-data), but no Apache is installed. foreman can also be dropped from the RPM-based guides since it doesn't matter. postgres is only relevant on content proxies.

Port 5646 is irrelevant on non-Katello installs.

This whole chapter is irrelevant on non-Katello since port 5646 isn't used.

Ports need updating

Always lists buster as the distro, but that doesn't work on Ubuntu. I'd recommend using what's on https://docs.theforeman.org/nightly/Quickstart_Guide/index-foreman-deb.html#configuring-repositories_foreman since that also sets up Puppet, which is required.

Is wrong, needs to be what's @ https://docs.theforeman.org/nightly/Quickstart_Guide/index-foreman-deb.html#installing-the-satellite-server-packages_foreman

It's odd to refer to RHEL docs for Debian users.

Completely incorrect on non-Katello installs

We don't package the OpenSCAP plugin for debs.

ekohl commented 3 years ago

https://github.com/theforeman/foreman-documentation/pull/651 made a start on the network ports.

ekohl commented 10 months ago

@Lennonka I didn't find it during today's meeting, but I did start to open concrete issues for guides. This issue is old and some have been addressed. The links are all dead now, but would this be a good format to make guides ready?

By now I would propose to open a PR to mark the guide as ready and then in the review go through the various sections.

Lennonka commented 10 months ago

@ekohl I'm not sure what you mean by "this" as a good format. Do you mean creating an issue for each guide and marking the sections that need fixups for Debian? Something like that?

Probably yes. We can try one and take it from there.

ekohl commented 10 months ago

Yes, that's what I indeed meant.