#2724 doc: update kojid steps in server howto
Merged 3 years ago by tkopecek. Opened 3 years ago by ktdreyer.
ktdreyer/koji server-howto-kojid  into  master

file modified
+20 -22
@@ -1105,38 +1105,38 @@ 

  /etc/kojid/kojid.conf

  ^^^^^^^^^^^^^^^^^^^^^

  

- The configuration file for each koji builder must be edited so that the line

- below points to the URL for the koji hub. The user tag must also be edited to

- point to the username used to add the koji builder.

- 

- ::

+ Edit each koji builder's ``kojid.conf`` file to point at the Koji hub::

  

      ; The URL for the xmlrpc server

      server=http://hub.example.com/kojihub

  

-     ; the username has to be the same as what you used with add-host

-     ; in this example follow as below

-     user = kojibuilder1.example.com

+ Set the "user" value to the FQDN of the builder host. For example, if you

+ added the host with ``koji add-host kojibuilder1.example.com``, set "user" to

+ kojibuilder1.example.com::

  

- The koji filesystem may also be needed over http.  Set this as it was

- configured about.

+     user = kojibuilder1.example.com

  

- ::

+ The builder must reach the filesystem over HTTP. Set "topurl" to the same

+ value that you've configured for Koji clients (above)::

  

      # The URL for the file access

      topurl=http://koji-filesystem.example.com/kojifiles

  

- This item may be changed, but may not be the same as KojiDir on the

- ``kojihub.conf`` file (although it can be something under KojiDir, just not

- the same as KojiDir)

+ If the "topurl" setting uses an HTTPS URL with a cert signed by a custom CA,

+ the Koji builder must trust the CA system-wide.

+ 

+ You may change "workdir", but it may not be the same as KojiDir on the

+ ``kojihub.conf`` file. It can be something under KojiDir, just not the same as

+ KojiDir.

  

  ::

  

      ; The directory root for temporary storage

      workdir=/tmp/koji

  

- The root of the koji build directory (i.e., ``/mnt/koji``) must be mounted on the

- builder. A Read-Only NFS mount is the easiest way to handle this.

+ The root of the koji build directory (i.e., ``/mnt/koji``) must be mounted on

+ the builder and configured as "topdir". A Read-Only NFS mount is the easiest

+ way to handle this.

  

  ::

  
@@ -1149,7 +1149,7 @@ 

  /etc/kojid/kojid.conf

  ^^^^^^^^^^^^^^^^^^^^^

  

- If you are using SSL, these settings need to be edited to point to the

+ If you are using SSL, edit these settings to point to the

  certificates you generated at the beginning of the setup process.

  

  ::
@@ -1165,11 +1165,9 @@ 

      ;certificate of the CA that issued the HTTP server certificate

      serverca = /etc/kojid/koji_ca_cert.crt

  

- It is important to note that if your builders are hosted on separate machines

- from koji hub and koji web, you will need to scp the certificates mentioned in

- the above configuration file from the ``/etc/kojid/`` directory on koji hub to

- the ``/etc/koji/`` directory on the local machine so that the builder can be

- authenticated.

+ Every unique builder host must have its own unique keypair (PEM file) in

+ ``/etc/kojid/``. If you generated the certificates on another host, move them

+ to each builder.

  

  Authentication Configuration (Kerberos)

  ---------------------------------------

This pull request has two main changes:

  1. Simplify the language for kojid.conf in the Server HowTo document. This makes it easier for new readers to understand what settings they must change.
  2. Add a note that kojid hosts must have trust the CA that signed an HTTPS topurl in the system-wide store.

rebased onto 083a782

3 years ago

Metadata Update from @tkopecek:
- Pull-request tagged with: doc

3 years ago

Commit 3f8962e fixes this pull-request

Pull-Request has been merged by tkopecek

3 years ago
Metadata