Commit graph

46 commits

Author SHA1 Message Date
Tomas Kopecek
e72a7be0a1 stricter config file permissions
Fixes: https://pagure.io/koji/issue/2124
2020-09-07 09:37:11 +02:00
Tomas Kopecek
5fd89dd0cd doc: access control 2020-08-26 09:19:50 +02:00
Tomas Kopecek
f8419e3626 remove deprecated krbV support
Fixes: https://pagure.io/koji/issue/1991
2020-07-24 15:08:47 -04:00
Tomas Kopecek
8cd79f48e7 builder: py2 fixes
Relates: https://pagure.io/koji/issue/1905
2020-07-22 10:33:33 -04:00
Ken Dreyer
39d55aac9b doc: improve hub selinux instructions
Make the Server HowTo SELinux instructions simpler and easier to read.
Describe each step for users to copy-and-paste.

Use semanage and restorecon instead of chcon in order to make the
changes persist across relabling operations.

Only recommend httpd_can_network_connect_db=1 if the user is using a
TCP/IP connection to PostgreSQL. If koji-hub is using a local Unix
socket connection, Apache does not need this setting.
2020-07-01 11:39:05 +02:00
Tomas Kopecek
19295bf7da kojira: drop kojira.sysconfig
Fixes: https://pagure.io/koji/issue/2171
2020-06-30 14:48:21 +02:00
Ken Dreyer
bc129afe12 doc: update documentation for SSLCACertificateFile
Be more specific about the exact Apache directive to configure the CA
that will validate client certificates (SSLCACertificateFile).
2020-06-24 14:49:34 +02:00
Ken Dreyer
14daa94d82 doc: rewrite PostgreSQL authorization instructions
Rewrite the PostgreSQL authorization instructions in the Server HowTo
guide.

Provide two complete examples: the "all-in-one localhost" option, and
the "separate postgres over the network" option. This reduces the
decision trees and makes it easier to copy and paste the entire
pg_hba.conf file. Explain what each mystery setting does and link to the
PostgreSQL documentation.

Only set listen_addresses to "*" if we need it, and turn it off if we
don't.

Simplify the instructions so that the user only restarts the postgresql
daemon once.

Clarify that koji-web does not need DB access, and the hub is the only
service that requires direct DB access.

Remove the example of authorizing the apache system user, because that
implies that the admin must run a series of complicated GRANT
instructions to allow both koji and apache to write to the DB. Just
grant the koji user full trust access for simplicity.
2020-06-24 14:44:44 +02:00
Ken Dreyer
b47f94a09a doc: update postgresql-setup command for el8 and Fedora
Fedora and RHEL 8 use a newer syntax for postgresql-setup's initdb
command. Provide the older command and the newer command in the Server
Howto documentation.

(We can remove the RHEL 7 version when we drop RHEL 7 support.)
2020-05-13 10:03:59 +02:00
Ken Dreyer
9bdb0687d4 doc: fix koji-sweep-db filename typo
"sweepd" -> "sweep"
2020-04-29 10:15:44 +02:00
Ken Dreyer
aa17d743bc doc: indent SQL query for user ID discovery
Prior to this change, Sphinx rendered the SQL query outside of the
"Note" box.

Indent the query further so that Sphinx renders it inside the "Note"
border.
2020-04-29 10:14:37 +02:00
Tomas Kopecek
9f6e273774 docs: remove obsoleted recommendation to restart kojira
Fixes: https://pagure.io/koji/issue/2170
2020-04-28 09:35:25 +02:00
Ken Dreyer
c932f4cdbc doc: use newer configuration boilerplate for kojira
The Server Howto documentation describes how to configure Kerberos
authentication in kojira.conf.

Prior to this change, the Server Howto documentation's boilerplate
configuration copied the older stale format.
eea730300a added a dedicated section for
Kerberos authentication to kojira.conf. Copy this newer format into the
Server Howto documentation.

This also updates our Server Howto document to use the default
/etc/kojira/kojira.keytab file path, which we added in
f232e49194.
2020-04-22 09:51:28 +02:00
Mike McLean
b5f1737ccb Make the docs more in line with our example configs 2020-04-14 09:12:59 +02:00
Tomas Kopecek
672e367263 update docs on httpd configuration
Fixes: https://pagure.io/koji/issue/1878
2020-04-14 09:12:59 +02:00
Ken Dreyer
b7e8ad06c5 docs: MaxRequestsPerChild -> MaxConnectionsPerChild
As of httpd 2.4, this setting is named "MaxConnectionsPerChild".
2019-11-18 09:37:41 +01:00
Ken Dreyer
8e9698bd69 docs: explain "compile/builder1" user principal
Update the server howto doc to describe the "compile/*" Kerberos user
principal.
2019-11-18 09:34:21 +01:00
Ken Dreyer
9f3f0ce463 docs: recommend 2048 bit keys
The US NIST recommends 2048-bit keys for RSA.
2019-11-18 09:28:46 +01:00
Ken Dreyer
4f2d52c2f6 docs: fix indent for reloading postgres settings
Dedent the description of reloading postgres, so it's clearer that this
must be done after all the modifications to pg_hba.conf.
2019-11-18 09:27:28 +01:00
Ken Dreyer
f53ea2c607 docs: simplify admin bootstrapping intro
Use the active voice when describing how to bootstrap the initial admin
user, and remove some complicated language so this is simpler to read
and understand.
2019-11-18 09:25:18 +01:00
Tomas Kopecek
312c160afc fix indenting 2019-11-18 09:23:02 +01:00
Ken Dreyer
c75f8ef416 docs: fix rST syntax for DB listening section
Clean up some rST syntax issues in the section about altering the
postgres listen_address.
2019-11-15 10:44:06 -07:00
Yu Ming Zhu
353fe2c510 doc: change user creating sql for kerberos auth
a follow-up of PR #1648
2019-10-15 13:07:20 +02:00
Tomas Kopecek
ba54425854 clean build_reservations table 2019-10-15 09:00:22 +02:00
Tomas Kopecek
54d6630345 Add vaccum to sessions cleanup 2019-10-15 09:00:22 +02:00
Tomas Kopecek
2da8d92bae improve docs 2019-10-15 09:00:22 +02:00
Tomas Kopecek
f68eeb6cc0 bundle db maintenance script to hub
Fixes: https://pagure.io/koji/issue/1478
2019-10-15 09:00:22 +02:00
Ken Dreyer
52d706aa85 docs: use systemctl enable --now for kojid
Replace the RHEL 6-era command with the systemd equivalent.

Newer versions of systemd (RHEL 7.3+) support the --now flag to start
and enable the service in one command.
2019-04-05 15:29:27 -04:00
Ken Dreyer
b0d42dfd73 docs: use systemctl enable --now for postgres
Newer versions of systemd (RHEL 7.3+) support the --now flag to start
and enable the service in one command.
2019-04-05 15:29:27 -04:00
Tomas Kopecek
29e9c87b50 kojid.conf documentation
Fixes: https://pagure.io/koji/issue/1241
2019-04-04 17:06:13 -04:00
Pat Riehecky
f8882edd1c Update server doc for newer TLS and event worker 2019-04-04 16:56:29 -04:00
Ken Dreyer
5ae5ba651c docs: koji package provides schema.sql file
Point administrators to the "koji" package for the schema.sql file.
2019-03-12 13:52:48 -04:00
Ken Dreyer
46fc81a2ca docs: drop HTML tags from howto doc
When copying this page from Fedora's wiki, some HTML tags were missed in
the translation. Translate the HTML tags to their reStructuredText
equivalents.
2019-01-28 17:08:27 -07:00
Ken Dreyer
3a83f61292 docs: use "postgresql-setup initdb" to initialize database
Replace the old RHEL 5-era command with the newer command, available in
RHEL 7 and later.
2018-11-13 11:04:17 -05:00
Ken Dreyer
c4a6ae25ff docs: unify "dnf" and "yum" instructions in server howto
Drop the references to old EOL Fedora versions and simplify the package
install steps by using "Yum" everywhere.
2018-10-26 11:41:30 -06:00
Alex Iribarren
92219abf3a Doc: add repos-dist to koji filesystem skeleton 2018-04-30 16:53:08 -04:00
Mike McLean
4ca42db01b correct docs spelling errors 2017-09-25 15:30:29 -04:00
Mike McLean
f4a50c36a6 release notes for builder changes 2017-09-25 15:30:28 -04:00
Ville Skyttä
10bc242c32 Spelling fixes 2017-07-30 12:49:19 +03:00
Tomas Kopecek
b98d93d788 drop mod_python support
Fixes: https://pagure.io/koji/issue/466
2017-07-06 14:04:19 +02:00
Mike McLean
ae078d2285 first stab at release notes 2017-06-30 12:23:09 -04:00
Tomas Kopecek
6f8df41889 fix docs for mod_auth_gssapi 2017-06-06 09:29:14 -04:00
Mike McLean
5f27889296 update docs for allowed_scms 2017-05-22 15:49:38 -04:00
Tomas Kopecek
73de0c4e79 add default_md to docs (ssl.cnf)
Related: https://pagure.io/koji/issue/371
2017-04-28 16:36:09 +02:00
Mike McLean
a6affa38d5 pull docs updates from Fedora wiki 2016-08-23 17:48:18 -04:00
Adam Miller
3fd4275fe3 first pass at converting docs to sphinx-doc reStructured Text 2016-05-07 16:42:02 -04:00