Summary
The directory-reference pages in docs/_openvox_8x/ carry stale content from the pre-puppetserver era — they document the certificate authority as living inside the agent ssldir, and they label paths with settings that were removed in OpenVox 8. The links still resolve (so this isn't a broken-link issue), but the content is wrong. Surfaced while reviewing the #273 link fixes (#262 workstream E).
1. dirs_ssldir.markdown — CA is documented under the ssldir, but it moved to OpenVox Server
The page lists a ca (directory) as a subdirectory of the ssldir ("The ssldir has the following structure: … ca (directory) … Setting: [cadir]"), with the whole CA tree nested under it (ca_key.pem, ca.pass, inventory.txt, signed/, requests/, etc.).
But in OpenVox 8 the cadir setting defaults to /etc/puppetlabs/puppetserver/ca — the CA is managed by OpenVox Server and lives outside the agent ssldir. So presenting the CA as a child of the ssldir is the old Puppet ≤5 layout.
The CA portion of this page should be reworked (or split out) to reflect that the CA directory is a puppetserver location, not part of the ssldir. (The non-CA ssldir contents — private_keys/, public_keys/, certs/, certificate_requests/, crl.pem — are still accurate.)
2. Removed-setting labels in the directory docs
These label a path with the name of a setting that no longer exists in OpenVox 8 (absent from defaults.rb and the configuration reference):
Drop or update these stale "Setting: <name>" labels.
Related: #275 (Rack/Passenger/WEBrick deployment references).
Summary
The directory-reference pages in
docs/_openvox_8x/carry stale content from the pre-puppetserver era — they document the certificate authority as living inside the agentssldir, and they label paths with settings that were removed in OpenVox 8. The links still resolve (so this isn't a broken-link issue), but the content is wrong. Surfaced while reviewing the #273 link fixes (#262 workstream E).1.
dirs_ssldir.markdown— CA is documented under thessldir, but it moved to OpenVox ServerThe page lists a
ca(directory) as a subdirectory of thessldir("Thessldirhas the following structure: …ca(directory) … Setting:[cadir]"), with the whole CA tree nested under it (ca_key.pem,ca.pass,inventory.txt,signed/,requests/, etc.).But in OpenVox 8 the
cadirsetting defaults to/etc/puppetlabs/puppetserver/ca— the CA is managed by OpenVox Server and lives outside the agentssldir. So presenting the CA as a child of thessldiris the old Puppet ≤5 layout.The CA portion of this page should be reworked (or split out) to reflect that the CA directory is a puppetserver location, not part of the
ssldir. (The non-CAssldircontents —private_keys/,public_keys/,certs/,certificate_requests/,crl.pem— are still accurate.)2. Removed-setting labels in the directory docs
These label a path with the name of a setting that no longer exists in OpenVox 8 (absent from
defaults.rband the configuration reference):dirs_ssldir.markdown—Setting: caprivatedirandSetting: capass(both de-linked in docs: migrate/repoint un-migrated links in openvox 8x (#262 E) #273; the settings are gone).dirs_vardir.markdown—skeleton(module_skeleton_dir) (de-linked in docs: migrate/repoint un-migrated links in openvox 8x (#262 E) #273; setting gone).Drop or update these stale "Setting:
<name>" labels.Related: #275 (Rack/Passenger/WEBrick deployment references).