Difference between revisions of "Fedora-ARM,Dogfood - koji Hub"

From CDOT Wiki
Jump to: navigation, search
 
(74 intermediate revisions by the same user not shown)
Line 5: Line 5:
 
== Project Description ==
 
== Project Description ==
  
The Fedora-ARM koji system uese HongKong,an x86_64 system, as the Koji hub.
+
The Fedora-ARM koji system uese IRAQ,an x86_64 system, as the Koji hub.
  
 
The Fedora-ARM project to use ARM system as the Koji hub(this is called "Eating own dogfood" in the industry)
 
The Fedora-ARM project to use ARM system as the Koji hub(this is called "Eating own dogfood" in the industry)
Line 23: Line 23:
  
 
== Project Details ==
 
== Project Details ==
'''First stage'''
 
* '''Koji Authentication Selection'''
 
  
    Koji primarily supports Kerberos and SSL Certificate authentication. For basic koji command line access,   
+
Setting Up a Koji Build System
    plain user/pass combinations are possible.  However, kojiweb does not support plain user/pass authentication.
 
    Furthermore, once either Kerberos or SSL Certificate authentication is enabled so that kojiweb will work,
 
    the plain user/pass method will stop working entirely.
 
    As such plain user/pass authentication is a stop gap measure at best unless you intend to never setup
 
    a fully functional kojiweb instance.
 
  
    The Kerberos credentials of the initial admin user will be necessary to bootstrap the user database.
+
The Koji components may live on separate resources as long as all resources are able to communicate.
 +
To understand koji configuration is an important in project.
  
    For SSL authentication, SSL certificates for the xmlrpc server, for the various koji components,
+
'''KOJI Configuration'''
    and one for the admin user will need to be setup
 
  
    1.[http://fedoraproject.org/wiki/Koji/ServerHowTo#Koji_Authentication_Selection  Setting up SSL Certificates for authentication]
+
* SSL and authentication via certificates
 +
* Creating a database in PostgreSQL and importing a schema
 +
* Working with psql
 +
* Apache configuration
 +
* Koji web and Koji hub
  
    2.[http://fedoraproject.org/wiki/Koji/ServerHowTo#Setting_up_Kerberos_for_authentication Setting up Kerberos for authentication]
 
  
So,Release 0.1 results here [http://ycshon.blogspot.com/2010/11/sbr-600-project-release-01.html  in my blog]
 
  
'''Second stage'''
+
'''Packages'''
  
* Koji Database
+
On the server (koji-hub/koji-web)
  
1.Create Database
+
* httpd
 +
* mod_ssl
 +
* postgresql-server
 +
* mod_python (>= 3.3.1 for Kerberos authentication)
  
yum install postgresql-server
+
On the builder (koji-builder)
  
2. Once installed you will then need to initialize the Database with the following command:
+
* mock
 +
* rpm-build
 +
* createrepo
  
service postgresql initdb
+
On the yum repository creation and maintenance (kojira)
  
3.Start the Postgresql service with:
+
On the Bootrapping the Koji build environment
  
service postgresql start
+
* Importing packages and preparing Koji to run builds
 +
* External Repos and preparing Koji to run builds
  
4. At this point the Postgresql server is installed and operational provided no errors were reported with the database initialized.
+
== Project Plan ==
 +
 
 +
Goals for each release:
 +
 
 +
'''release 0.1 - Koji Certificates '''
 +
 
 +
'''setting up SSL Certificates for Authentication'''
 +
 
 +
* Certificate generation
 +
* Generate CA
 +
* Generate the koji component certificates and the admin certificate
 +
* Copy certificates into ~/.koji for kojiadmin
 +
 
 +
 
 +
 
 +
'''release 0.2 - PostgreSQL and koji hub'''
 +
 
 +
'''release 0.2-1'''
 +
 
 +
'''1.PostgreSQL Server'''
  
The next steps is to create a user named “koji”, set up Postgresql and populate the schema:
+
* Install PostgreSQL
 +
* Initialize PostgreSQL DB
 +
* Setup User Accounts
 +
* Setup PostgreSQL and populate schema
 +
* Authorize Koji-web and Koji-hub resources
 +
* Make auth changes live
 +
* SSL Certificate authentication
 +
* Give yourself admin permissions
  
useradd koji
 
passwd -d koji
 
su - postgres
 
createuser koji
 
Shall the new role be a superuser? (y/n) n
 
Shall the new role be allowed to create databases? (y/n) n
 
Shall the new role be allowed to create more new roles?(y/n) n
 
  
createdb -O koji koji
 
logout
 
su - koji
 
psql koji koji < /usr/share/doc/koji*/docs/schema.sql
 
exit
 
  
2.Koji Hub Configuration
+
'''release 0.2-2'''
  
It was agreed that all parts of our Koji build system would reside on IRAQ.
+
'''2.Koji hub'''
After successfully installing and configuring Postgresql the next step is the Koji Hub.
 
In order for the Koji Hub to work Apache should be installed as well as a few additional modules.
 
Run the following command as root:
 
  
yum install koji-hub httpd mod_ssl mod_python
+
* Install koji-hub
 +
* Required Configuration
 +
* Optional Configuration
 +
* SELinux Configuration
 +
* Koji filesystem skeleton
  
Then edit the Apache conf file – ‘/etc/httpd/conf/httpd.conf’ and change the “MaxRequestsPerChild” to 100.
 
On IRAQ these setting were already in place as Apache was running and configured.
 
  
Next edit the ‘/etc/koji-hub/hub.conf’ file and add the following lines:
+
* 0.3 - '''Koji Web'''
DBName = koji
 
DBUser = koji
 
DBHost = localhost
 
KojiDir = /mnt/koji
 
LoginCreatesUser = On
 
KojiWebURL = http://iraq.proximity.on.ca/koji
 
Since we are using SSL for authentication, also add
 
  
DNUsernameComponent = CN
+
'''release 0.3-1'''
ProxyDNs = "/C=CA/ST=Ontario/O=Seneca CDOT/OU=/CN=kojiweb/emailAddress="
 
  
And in the ‘/etc/httpd/conf.d/kojihub.conf’ uncomment the following lines:
+
'''1. kojiweb '''
  
<Location /kojihub>
+
* Install Koji-Web
SSLOptions +StdEnvVars
+
* Required Configuration
</Location>
+
* Optional Configuration
  
Using the Koji certificates, we need to add the following lines to ‘/etc/httpd/conf.d/ssl.conf’, under the section ‘VirtualHost _default_:443′:
+
'''2. Koji Builder'''
  
SSLCertificateFile      /etc/pki/koji/certs/kojihub.crt
+
* Install kojid
SSLCertificateKeyFile  /etc/pki/koji/certs/kojihub.key
+
* Required Configuration
SSLCertificateChainFile /etc/pki/koji/koji_ca_cert.crt
+
* Optional Configuration (SSL certificates)
SSLCACertificateFile    /etc/pki/koji/koji_ca_cert.crt
+
* Add the host entry for the koji builder to the database
SSLVerifyClient        require
+
* Add the host to the createrepo channel
SSLVerifyDepth          10
+
* A note on capacity
Even though SE Linux is not currently in use on IRAQ,
+
* Start Kojid
it may be in the future. In order to allow Apache to connect to the Postgresql database run the following command as root:
 
  
setsebool -P httpd_can_network_connect_db 1
+
'''3.kojira'''
To allow Koji to work, a skeleton filesystem needs to be created and the ownership
 
changed so Apache can write to it as required. The following commands were executed:
 
  
mkdir -p /mnt/koji/{packages,repos,work,scratch}
+
* Install kojira
chown -R apache.apache /mnt/koji
+
* Required Configuration
Then edited the '/etc/koji.conf' file and changed the following lines:
+
* Optional Configuration
 +
* Add the user entry for the kojira user
 +
* Start Kojira
  
;url of XMLRPC server
 
server = http://iraqong.proximity.on.ca/koji
 
;url of package download site
 
pkgurl = http://iraq.proximity.on.ca/packages
 
;path to the koji top directory
 
topdir = /mnt/koji
 
;configuration for SSL athentication
 
;client certificate
 
cert = ~/.koji/client.crt
 
;certificate of the CA that issued the client certificate
 
ca = ~/.koji/clientca.crt
 
;certificate of the CA that issued the HTTP server certificate
 
serverca = ~/.koji/serverca.crt
 
After this is competed, the final step is the addition of the user and builder accounts. First add the kojira account and grant repo privileges with the following command( this should be done before running kojira for the first time) :
 
  
su - kojiadmin
 
koji add-user kojira
 
koji grant-permission repo kojira
 
  
Then add as many builders as required using the following commands editing where required (this should also be done prior to running kojid on each host):
+
'''release 0.3-2'''
 +
 
 +
'''2. Test kojiweb'''
 +
 
 +
* User account
 +
* Build packages
  
koji add-host arm-001-001 arm
 
koji add-host arm-001-002 arm
 
koji add-host arm-001-003 arm
 
  
== Project Plan ==
 
  
Goals for each release:
 
* 0.1 - '''Koji Certificates '''
 
      Koji Hub setup - Certificates/security
 
* 0.2 - '''Koji Hub setup and Koji Database'''
 
      Koji Hub Setup- Configuration
 
      To setup PostgreSQL for use with Koji
 
* 0.3 - '''Koji Web'''
 
      Build software with koji hub
 
 
== Project News ==
 
== Project News ==
  
Line 170: Line 151:
 
19,November I set up Koji Database.
 
19,November I set up Koji Database.
  
26,November I set up Koji hub Configuration
+
26,November Setting up Postgresql server for Koji part 1
  
 +
6,Dec Setting up Postgresql server for Koji part two
 +
 +
16,Dev setting up Koji hub and Koji web,
 
== Resources ==
 
== Resources ==
  
Line 183: Line 167:
  
 
[http://fedoraproject.org/wiki/Koji/ServerHowTo#PostgreSQL_Server PostgreSQL_Server]
 
[http://fedoraproject.org/wiki/Koji/ServerHowTo#PostgreSQL_Server PostgreSQL_Server]
 +
 +
[http://fedoraproject.org/wiki/Koji/ServerBootstrap importing packages and preparing Koji to run builds]
 +
 +
[http://fedoraproject.org/wiki/Koji/ExternalRepoServerBootstrap External Repos and preparing Koji to run builds]

Latest revision as of 09:17, 13 January 2011

Project Name

Fedora-ARM Dogfood -Koji Hub

Project Description

The Fedora-ARM koji system uese IRAQ,an x86_64 system, as the Koji hub.

The Fedora-ARM project to use ARM system as the Koji hub(this is called "Eating own dogfood" in the industry)

The project involves configuring the OpenRD-Client system as koji hub.

The Fedora ARM Koji system is running. It is currently building F13 under the supervision of Whalen and Chris Tyler. Koji have 22 hardware ARM builders. I am in the progress of building Fedora 13 under IRAQ.

Project Leader(s)

Young Chol Shon

Project Contributor(s)

No one contributed to this project

Project Details

Setting Up a Koji Build System

The Koji components may live on separate resources as long as all resources are able to communicate. To understand koji configuration is an important in project.

KOJI Configuration

  • SSL and authentication via certificates
  • Creating a database in PostgreSQL and importing a schema
  • Working with psql
  • Apache configuration
  • Koji web and Koji hub


Packages

On the server (koji-hub/koji-web)

  • httpd
  • mod_ssl
  • postgresql-server
  • mod_python (>= 3.3.1 for Kerberos authentication)

On the builder (koji-builder)

  • mock
  • rpm-build
  • createrepo

On the yum repository creation and maintenance (kojira)

On the Bootrapping the Koji build environment

  • Importing packages and preparing Koji to run builds
  • External Repos and preparing Koji to run builds

Project Plan

Goals for each release:

release 0.1 - Koji Certificates

setting up SSL Certificates for Authentication

  • Certificate generation
  • Generate CA
  • Generate the koji component certificates and the admin certificate
  • Copy certificates into ~/.koji for kojiadmin


release 0.2 - PostgreSQL and koji hub

release 0.2-1

1.PostgreSQL Server

  • Install PostgreSQL
  • Initialize PostgreSQL DB
  • Setup User Accounts
  • Setup PostgreSQL and populate schema
  • Authorize Koji-web and Koji-hub resources
  • Make auth changes live
  • SSL Certificate authentication
  • Give yourself admin permissions


release 0.2-2

2.Koji hub

  • Install koji-hub
  • Required Configuration
  • Optional Configuration
  • SELinux Configuration
  • Koji filesystem skeleton


  • 0.3 - Koji Web

release 0.3-1

1. kojiweb

  • Install Koji-Web
  • Required Configuration
  • Optional Configuration

2. Koji Builder

  • Install kojid
  • Required Configuration
  • Optional Configuration (SSL certificates)
  • Add the host entry for the koji builder to the database
  • Add the host to the createrepo channel
  • A note on capacity
  • Start Kojid

3.kojira

  • Install kojira
  • Required Configuration
  • Optional Configuration
  • Add the user entry for the kojira user
  • Start Kojira


release 0.3-2

2. Test kojiweb

  • User account
  • Build packages


Project News

1,November I will do Project Plan 0.1- I set up Koji Certificates

5,November I did build and create Koji Certifacation on IRAQ server.

19,November I set up Koji Database.

26,November Setting up Postgresql server for Koji part 1

6,Dec Setting up Postgresql server for Koji part two

16,Dev setting up Koji hub and Koji web,

Resources

How to get koji certificate?

Configuration of CDOT_Development system

How To Setting up and Using Koji on Fedora

PostgreSQL9.1 devel Document

PostgreSQL_Server

importing packages and preparing Koji to run builds

External Repos and preparing Koji to run builds