From Fedora Project Wiki

mNo edit summary
(Added setup details)
Line 3: Line 3:
The whole idea is based on a feature of BUILD-ID which was completed in Fedora 8 time, you can read about it [http://fedoraproject.org/wiki/Releases/FeatureBuildId here].
The whole idea is based on a feature of BUILD-ID which was completed in Fedora 8 time, you can read about it [http://fedoraproject.org/wiki/Releases/FeatureBuildId here].


'''Source Code'''
Source code is under github and can be found [https://github.com/kushaldas/darkserver here].


'''Why we need the service ?'''
'''Why we need the service ?'''
Line 20: Line 23:


The information on the database will be filled up by darkserver-import command, which will only execute through bodhi on every update pushed through.
The information on the database will be filled up by darkserver-import command, which will only execute through bodhi on every update pushed through.
'''How to setup?'''
Install the darkserver and darkserver-import rpms.
Run the createtable.sql under /usr/share/darkserver to create table structure in the database.
<pre>
$ mysql -u user -p -Ddatabasename < /usr/share/darkserver/createtable.sql
</pre>
Edit the configuration file at /etc/darkserver/darkserverweb.conf as
<pre>
[darkserverweb]
host=MYSQL host name
user=MYSQL user (read only access)
password=password
database=database name
</pre>
Remember that the webserver only requires read only access to the mysql.
To use the darkserver-import tool you will have to fill up /etc/darkserver/darkserver.conf in the same way.
<pre>
[darkserver]
host=MYSQL host name
user=MYSQL user (read/write access)
password=password
database=database name
</pre>

Revision as of 12:11, 6 December 2011

Darkserver is a service written to help people finding details of build-id(s). People will be able query the service based on build-id(s) or rpm package names. The service will provide output in JSON format as it will be easier for other tools to parse the output.

The whole idea is based on a feature of BUILD-ID which was completed in Fedora 8 time, you can read about it here.

Source Code

Source code is under github and can be found here.

Why we need the service ?


Architecture of the project

View this image.

Requirements

 * Django >= 1.2.5
 * Mysql server

The web service does not need any authentication. It will require read only access to the database, the users will only require to query the service.

The information on the database will be filled up by darkserver-import command, which will only execute through bodhi on every update pushed through.

How to setup?

Install the darkserver and darkserver-import rpms. Run the createtable.sql under /usr/share/darkserver to create table structure in the database.

$ mysql -u user -p -Ddatabasename < /usr/share/darkserver/createtable.sql

Edit the configuration file at /etc/darkserver/darkserverweb.conf as

[darkserverweb]
host=MYSQL host name
user=MYSQL user (read only access)
password=password
database=database name

Remember that the webserver only requires read only access to the mysql.

To use the darkserver-import tool you will have to fill up /etc/darkserver/darkserver.conf in the same way.

[darkserver]
host=MYSQL host name
user=MYSQL user (read/write access)
password=password
database=database name