Changes

Jump to navigation Jump to search
546 bytes added ,  09:38, 11 September 2023
Line 29: Line 29:     
== Install ==
 
== Install ==
{{Note box|You can run both the hub and build on the one server, just press enter when first prompted for the Build Server FQDN.}}
+
{{Note box|1=You can run everything (the hub, web and build) on the one server, just add build=<Hub FQDN> to the install-koji-farm.sh line.}}
Create your hub and build servers (Rocky 8 minimal install).
+
 
 +
Create your hub, web and build servers (Rocky 8 minimal install).
    
On all servers enable the network and name the servers as the FQDN (the servers need to be accessible via their FQDN's, so either via DNS or you need to add them to your /etc/hosts files).
 
On all servers enable the network and name the servers as the FQDN (the servers need to be accessible via their FQDN's, so either via DNS or you need to add them to your /etc/hosts files).
Line 45: Line 46:  
./install-koji-farm.sh
 
./install-koji-farm.sh
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
The install-koji-farm.sh script will accept multiple parameters (up to a total of 7)<syntaxhighlight lang="bash">
 +
install-koji-farm.sh [web=<web FQDN> | build=<build FQDN> | debug]
 +
</syntaxhighlight>
 +
 +
* web=<FQDN> - defaults to hub FQDN
 +
* build=<FQDN> - multiple allowed. If you want an All-in-One server (all services ion the one server), enter the Hub FQDN here
 +
* debug - will list each line executed, plus lots of other gunk (very noisy)
 +
 
You will be prompted for various items
 
You will be prompted for various items
   −
* ssh values (e.g. Country, State, City, Organization, Organisational Unit)
+
* values for your ssl certificates (e.g. Country, State, City, Organization, Organisational Unit)
* For each Build server (It will loop until a blank input)
+
* For the web server (unless it's the hub)
** Build server FQDN (pressing enter for the first loop will use the Hub FQDN as an all-in-one server).  
+
** to accept the build server signature
** to accept the build server ssl signature
+
** for the root password on the Hub server
 +
*For each Build server (It will loop until a blank input)
 +
** If you haven't passed build=<FQDN> as a parameter, the Build server FQDN (pressing enter for the first loop will use the Hub FQDN as an all-in-one server).
 +
** to accept the build server signature
 
** for the root password on the Hub server
 
** for the root password on the Hub server
    
The web interface will be available via http://<your hub server>/koji
 
The web interface will be available via http://<your hub server>/koji
 +
 +
=== Additional Build Servers ===
 +
    
You can add additional build servers later, via<syntaxhighlight lang="bash">
 
You can add additional build servers later, via<syntaxhighlight lang="bash">
 
koji-add-builder.sh <FQDN of build server> [debug]
 
koji-add-builder.sh <FQDN of build server> [debug]
</syntaxhighlight>Updates/Admin can be made via the kojiadmin user on the hub. Usage etc. will be discussed elsewhere.
+
</syntaxhighlight>
<syntaxhighlight lang="bash">
+
 
su - kojiadmin
+
=== Additional Users ===
koji help
+
You can add end Users via<syntaxhighlight lang="bash">
</syntaxhighlight>You can add end Users via<syntaxhighlight lang="bash">
   
koji-add-user.sh <User Name> [ permission=<permission> | debug ]
 
koji-add-user.sh <User Name> [ permission=<permission> | debug ]
 
</syntaxhighlight>This will add them into the db and generate ssl CLI and browser keys, which will be bundled up in a tgz file at /etc/pki/koji/bundle/koji-\<User Name\>-bundle.tgz.
 
</syntaxhighlight>This will add them into the db and generate ssl CLI and browser keys, which will be bundled up in a tgz file at /etc/pki/koji/bundle/koji-\<User Name\>-bundle.tgz.
Line 70: Line 84:  
</syntaxhighlight>
 
</syntaxhighlight>
   −
== The long way ==
+
=== The long way ===
    
===== Hub/Web Server =====
 
===== Hub/Web Server =====
371

edits

Navigation menu