diff --git a/fas/README b/fas/README index 8c3bf20..d6e420f 100644 --- a/fas/README +++ b/fas/README @@ -19,18 +19,39 @@ script. .. _TurboGears: http://www.turbogears.org ----------- -Installing ----------- +------------- +Prerequisites +------------- +Before you can get started, make sure to have the following packages installed +(example being from Fedora 8 with a local postgres database server):: -Partial list of prereqs. When we build an rpm we'll nail this down in more -detail: + yum install git-core postgresql-plpython postgresql-server postgresql-python \ + python-TurboMail TurboGears pygpgme python-sqlalchemy python-genshi \ + python-psycopg2 - * pygpgme - * python-psycopg2 - * python-sqlalchemy >= 0.4 - * TurboGears - * python-genshi + # Note: on RHEL5 you need postgresql-pl instead of postgresql-plpython + +At present, the database needs to be a postgres database since we use triggers +to manage some of the data (like syncing accounts with bugzilla). + +If you are unfamiliar with postgres and this is your first time installing it, +you will want to generate the database and allow users to connect. First as +root run:: + + /etc/init.d/postgresql initdb + +Then make sure the bottom of /var/lib/pgsql/data/pg_hba.conf looks like:: + + # TYPE DATABASE USER CIDR-ADDRESS METHOD + + # "local" is for Unix domain socket connections only + local all all ident sameuser + # IPv4 local connections: + #host all all 127.0.0.1/32 ident sameuser + # IPv6 local connections: + #host all all ::1/128 ident sameuser + + host all all 0.0.0.0 0.0.0.0 md5 ------- Hacking @@ -47,15 +68,6 @@ that are created by the build script, setup.py:: This will create the fas.egg-info directory which has metadata about the program. It allows things like the identity provider to work. -Next you need to setup a database to work with FAS. At present, this needs to -be a postgres database since we use triggers to manage some of the data (like -syncing accounts with bugzilla). So install postgres and plpython (the -language that we've written our triggers in):: - # Fedora 8: - sudo yum -y install postgresql-server postgresql-plpython - # RHEL 5: - sudo yum -y install postgresql-server postgresql-pl - Do any configuration necessary and start up the postgres server. Then make the plpython language available on new databases, create a postgres user to manage the data and import the schema::