Random notes on PythonGump install on Solaris

This is most definately a work in progress

Solaris

Install the following:

• Python 2.2 or better from ActiveState. The version of Python on the SunFreeware disk does not include SAX support and the version of PyXML I tried (0.8.3) seems to make some bad assumptions (in particular, it assumes that gcc will be at the location it was when python was installed - which is not true as SFW python is supplied in binary form)

http://www.activestate.com/Products/ActivePython/

• Apache webserver from the SunFreeware disk, http://sunfreeware.com/ website or from http://apache.org/

  CVS from the SunFreeware disk, http://sunfreeware.com/ website or from http://cvshome.org/ . You'll need version 1.11.6 or better - 1.11 (supplied with some versions of Solaris) does not correctly recognise the port number as part of the CVSROOT or "-d" option.

  subversion from the SunFreeware disk, http://sunfreeware.com/ website or from http://subversion.org/

  If your server does not have a graphics card, you will also need to install Xvfb from the SunFreeware disk You may also want to install lynx, curl, htdate, sudo and vim

Create gump user

• create and share the directory/mount point /share/gump

• useradd -d /share/gump -s /bin/bash -G staff gump

• passwd gump xxxxxxxx (preferably with something more imaginative than xxxxxxxx for the password)

• chown gump:gump /share/gump

Other prereqs

• Apache Forrest:

  • cd /usr/local

  • cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic checkout xml-forrest (at time of writting we need CVS HEAD)

  • export JAVA_HOME=/usr/j2se

  • cd xml-forrest

  • ./build.sh

  • cd ..

  • mv xml-forrest/build/dist/shbat forrest

  • rm -rf xml-forrest

  • Note: FORREST_HOME will be exported and added to the PATH in step 4

• Apache Maven:

(version 1.0-rc1 or better - 1.0-beta-8 generates an error if --version is called when no project file is present, causing Gump to think that Maven is not present)

• cd /usr/local

• Download Maven to /tmp (select .tar.gz format)

• tar -xzf /tmp/maven-1.0-rc2.tar.gz

• mv maven-1.0-rc2 maven

• Note: MAVEN_HOME will be exported and added to the PATH in step 4

Gump Setup

The rest of thes document refers to the configuration for 'enterprize.coderage.org'. This host is not configured for multiple flavours.

Set up /share/gump/gump/[flavour]/..., the first flavour being public:

• set CVSROOT per [http://gump.apache.org/gettingstarted.html#Getting+the+source+to+Gump Gump Getting Started]

• mkdir -p /share/gump/gump/

• cd /share/gump/gump/

• cvs login

• cvs checkout gump

• create/edit `hostname`.xml, that is: enterprize.xml

  <workspace name="enterprize-public"
          basedir="/share/gump/gump/work"
          jardir="/share/gump/gump-installed"
          pkgdir="/share/gump/gump-installed"
          logdir="/share/gump/gumphome/log"
          mailserver="mail.internal.coderage.org"
          version="0.4">
  
          <property name="build.sysclasspath" value="only"/>
          <sysproperty name="java.awt.headless" value="true"/>
  
          <profile href="profile/gump.xml"/>
  </workspace>

• install packages in /share/gump/gump-installed [shared, not under 'flavour'], after first diligently clicking on license agreements as required.

• create/edit /share/gump/local-env-py-hostname.sh:

  # Note: These next three are for gumpy.sh and obsoleted
  # for gumpy.py (which reads them from the workspace).
  export GUMP=/share/gump/gump
  export GUMP_WS=/share/gump/gump/work
  export GUMP_LOG_DIR=/share/gump/gumphome/log
  
  export JAVA_HOME=/usr/j2se
  export CLASSPATH=$JAVA_HOME/lib/tools.jar
  export PATH=$PATH:$JAVA_HOME/bin
  
  export FORREST_HOME=/share/forrest
  export PATH=$PATH:$FORREST_HOME/bin
  
  export MAVEN_HOME=/share/maven
  export PATH=$PATH:$MAVEN_HOME/bin

• create/edit /home/gump/.bash_profile: {{{set -o vi

umask 002 . /share/gump/local-env-py-enterprize.sh }}}

• add this crontab entry: {{{0 0 * * * cd /share/gump/gump; /bin/bash gumpy.sh

}}}

• add the following to /etc/apache/httpd.conf immediately after all the other Aliases: {{{Alias /gump/ /share/gump/gumphome/logs

<Directory /share/gump/gumphome/logs>

• Options Indexes MultiViews AllowOverride None Order allow,deny Allow from all

</Directory>}}}

• /etc/init.d/apache restart

• logoff, logon as gump, and run some tests: {{{cd /usr/local/gump/public/gump/python

export PYTHONPATH=pwd which python which cvs python gump/check.py -w ../enterprize.xml all --debug python gump/integrate.py -w ../enterprize.xml all --debug }}}