-*-outline-*-

  $Id: zope-build.txt,v 1.2 2004/06/07 14:11:37 biggers Exp $

* ================================ Zope 2.7+ build on Redhat Ent Linux 3.x
                                   (actually, CentOS 3.x)

** -------- RHEL / CentOS 3.x Zope paths

  ## This build-recipe should work on other Linux distros - it's
  ## very generic

  ## NOTE:  I use 'sudo' to run commands as 'root'
  ##        (instead of using a root login-shell)
  ## 
  ##        SEE  http://www.courtesan.com/sudo/sudo.html
  ##             http://www.onlamp.com/lpt/a/2680 "Eliminating root w/sudo"

  ZHOME=/usr/local/Zope     ## Zope installation 'symlink' (possible)
  ZHOME=''

  ZSRC=/alpha/local/src/Zope  ## all tarfiles, Products, CMapp CVS "workspace"

  PYDIR=/usr/local/Python-2.3

  ## Python 2.3.3, from my RPM custom-build ...
  ## ADDED LATER - lib/python2.3/site-packages/mx "mxTools"
  ##               lib/python2.3/site-packages/psycopg.so ... 
  ##               "PsycoPG" for PgSQL

** -------- install-time vars

  zope_vers=Zope-2.7.0     ## version being built
  zope_ins=Zope-2.7.0.2    ## install-dir basename

  zope_grp=zope            ## edit-group for Zope developer(s)


** -------- actual Zope installation

  LOG=$ZSRC/${zope_ins}.log
  rm $LOG

  cd $ZSRC

  /bin/rm -rf ${zope_vers}
  tar zxf tarfiles/${zope_vers}.tgz

  ( cd ${zope_vers}          ## configure & build

    ./configure --prefix=/usr/local/${zope_ins} \
	      --optimize \
              --with-python=$PYDIR/bin/python

    make

   ) >> $LOG 2>&1 &

** -------- change owner to Zope

  sudo /bin/rm -f /usr/local/${zope_ins}

  ( cd $ZSRC/${zope_vers}/
    sudo make install 
  ) >> $LOG 2>&1 &

  cd /usr/local
  if [$ZOPE != ""]; then sudo ln -s ${zope_ins} $ZOPE; fi

  cd /usr/local/${zope_ins}

  ## create Zope group, user 

  sudo groupadd -g 104 zope
  sudo useradd -c 'Zope server user' -u 104 -g zope -d /usr/local/Zope \
    -s /bin/ksh zope

  sudo chown -R zope.zope .
  find . -type d | sudo xargs chmod g+rws

** -------- create a new Zope instance ...

  sudo -u zope /usr/local/${zope_ins}/bin/mkzopeinstance.py

    Directory: /usr/local/${zope_ins}/www/home1    ## must "fill in" $zope_ins
    Username: zope-Admin-user        (you provide)
    Password: zope-Admin-user-pass   (you provide)

  ## handy sh ALIASES for Zope admin ...

  alias zhome1="sudo -u zope /usr/local/${zope_ins}/www/home1/bin/zopectl"
  alias suz="sudo -u zope"

  zhome1 start  ## or 'status' or 'stop' or ... just type 'zhome1'

  ## Edit /usr/local/Zope/www/home1/etc/zope.conf ...
  ## 
  ## Use port-base (better idea) to adjust Zope HTTP, FTP, WebDAV ports
  ## 
  ## "Break out" a separate WebDAV server, for security
  ##