[railroad-dev] Installing RailRoad for Plone on FreeBSD

[Tom Lazar]

To a) give a context for my following error reports but also as a 
starting point for a
FreeBSD-RailRoad-Walkthrough setup guide I'm posting the notes I took 
for setting up
RailRoad so far. Once everything is up and running I intend to publish 
it on my blog and/
or contribute it to the existing RailRoad documentation.

It's in chronological order, so the bits most likely pertaining to my 
errors are further down.

Best regards,

Tom

--snip--
## Apache

   - install from www/apache2 thus:

     make clean ; \
     make WITH_DAV_MODULES WITH_MISC_MODULES WITH_AUTH_MODULES 
WITH_PROXY_MODULES ; \
     make deinstall ; \
     make reinstall ;

   - install www/mod_python3/ from the ports collection.

     to make mod_python work check
     http://www.modpython.org/FAQ/faqw.py?req=show&file=faq02.011.htp

     (it means, you need to add the following to your environment, i.e. 
edit /usr/local/sbin/envvars)

       LD_PRELOAD=/usr/lib/libc_r.so
       export LD_PRELOAD


   - added the following to httpd.conf:

     LoadModule proxy_module libexec/apache2/mod_proxy.so
     LoadModule proxy_http_module libexec/apache2/mod_proxy_http.so
     LoadModule python_module libexec/apache2/mod_python.so
     LoadModule dav_module libexec/apache2/mod_dav.so
     LoadModule dav_fs_module libexec/apache2/mod_dav_fs.so
     LoadModule rewrite_module libexec/apache2/mod_rewrite.so


## Postgresql

   - install from databases/postgresql80-server using the default 
settings

   - install databases/py-psycopg

   - created the database

     $ su - pgsql
     $ createuser -P # enter username and password, answer no to both 
questions
     $ createdb --owner=railpg rr
     $ createlang -d rr plpgsql    #IMPORTANT!!


## Railroad

   for Railroad you need to install textproc/libxml2 and 
textproc/py-libxml2

### PyDav client

   with the above mentioned ports installed it's just a matter of

   $ sudo python setup.py install

### RailRoad Server

   $ cd /usr/opt/zope/instances/testrr/
   $ tar xzf /usr/opt/zope/setup/RailRoad/distfiles/railroad-0.1.5.tar.gz
   $ cd railroad-0.1.5
   $ python mk_conf.py -o 
/usr/local/etc/apache2/Includes/rr_apacheconf.txt

   --session--
   <00> Installation directory of the RR scripts 
[/usr/opt/zope/instances/testrr/railroad-0.1.5]:
   <01> Name of the repository [railroad_data]:
   <02> The prefix is the part before `over` the repository.
   Prefix to path to the top of the repository [/rrr/]:
   <03> The RR server needs to access the local file system to perform 
some of its duties.
   Absolute path to the parent dir of the repository on the file system 
(must exist!): /usr/opt/zope/instances/testrr/htdocs
   <04> Name of the Python interpreter [rrpy]:
   <05> Host/port the repository is running on [localhost]: media
   <06> Use authorization (needs the DB!) [on]:
   <07> Use property search (needs the DB!) [on]:
   <08> Authorization domain [Railroad]:
   <09> DB module to use [db_pg]:
   <10> Name of database to use: rr
   <11> User to use for db-connection: railpg
   <12> Password to use []: rrrpwd
   <13> Host the db is running on []: localhost
   -----------

   $ psql -U railpg rr < db_pg.sql

   $ repoadm.py show   # should yield the following:
   -----------
   repository listing:
   Repository: unowned
               Id: 0
             Host:
             Path:
      Upload path:
    Top directory:
   -----------

   $ python repoadm.py add railroad_data railpg rrrpwd media /rrr/ 
/rrr/service/formupload /zope/instances/testrr/htdocs
   $ python clientadm.py add testrr 
http://testrr/portal_railroad/railroad/authorize RailRoad
   $ python clientadm.py activate testrr railroad_data

### RailRoad for Zope and Plone

   - untar them into your Products folder, restart the zope instance, 
install
     PloneRailroad via prefs_install_products_form

   - add an instance 'railroad' at /portal_railroad/ with the following 
values:

     Client_name:      testrr
     Repo_url:         http://media/rrr/repo/
     Repository_name:  railroad_data
     Services_url:     http://media/rrr/service/

--snap--
--
tom lazar <tom at tomster.org>
http://tomster.org