[OPEN-ILS-DEV] Simplifying Ubuntu install documentation (was: Installing on Ubuntu7.10 - ejabber problem)

[Faiz Ishaq]

Hi Dan & Dan,

Good idea! I will be happy to do the testing of the Ubuntu install doc. 
I am looking for a reproducible installation procedure before actually 
deploying Evergreen as a solution. We may start with the new Ubuntu 8.04 
as base since it is a LTS release.

Cheers, Faiz Ishaq

-----Original Message-----
From: "Dan Scott" <denials at gmail.com>
To: "Evergreen Development Discussion List" <open-ils-
dev at list.georgialibraries.org>
Date: Sat, 26 Jul 2008 11:52:10 -0400
Subject: [OPEN-ILS-DEV] Simplifying Ubuntu install documentation (was: 
Installing on Ubuntu7.10 - ejabber problem)

> Hi Dan Wells:
> 
> 2008/7/26 Dan Scott <denials at gmail.com>:
> > Hi Faiz:
> >
> > 2008/7/26 Faiz Ishaq <Faiz at szabist.ac.ae>:
> >> Hello!
> >>
> >> Totally new to Evergreen, I am trying to get it to run on Ubuntu.
> Started
> >> with Edubuntu 7.10 install and carried out the steps as given in the
> >> pre-install and install text files. Everything worked fine until
> step 27,
> >> finalizing the OPAC, using the command:
> >>
> >> sudo -u opensrf ./autogen.sh /openils/conf/opensrf_core.xml
> >>
> >> It gives 'Unable to connect to Jabber server' errors. The ejabber
> log file
> >> has 'Accepted Connection' entries.
> >
> > Just a wild guess - you followed the Ubuntu install instructions and
> > changed hostnames from "localhost" to your fully-qualified domain
> name
> > in various configuration files (including ejabberd.cfg)?
> >
> > For what it's worth, the development team recommends keeping all of
> > the entries (except for the <hosts> entry in opensrf.xml) as
> > "localhost" unless you're dealing with a system spread over multiple
> > servers. I'll start a new thread to talk about replacing the existing
> > Ubuntu instructions.
> 
> I really appreciate all of the work you did in finishing off the
> Ubuntu install documentation way back when - but based on the ongoing
> complications people experience using FQDN throughout various config
> files, would you mind horribly if I replaced the Ubuntu 7.10 install
> documentation with a copy of the Debian Etch install instructions,
> modified slightly to reflect the minor differences for Ubuntu? The
> primary differences would be:
>   * the use of Makefile.install to eliminate all of the prerequisite
> install steps
>   * keeping "localhost" throughout to simplify the network setup
>   * modifying the opensrf user's environment variables rather than
> modifying the autogen.sh and osrf_ctl.sh scripts (as the latter
> approach doesn't hit all of the scripts that need to be modified and
> is likely to be forgotten during upgrades)
> 
> One benefit to the project of making the install documentation for
> Debian and Ubuntu consistent would be that it would help keep the
> configuration of the various systems "in the wild" relatively similar
> so that it would simplify our attempts to troubleshoot problems.
> 
> -- 
> Dan Scott
> Laurentian University