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

[Dan Scott]

Okay, initial revision is complete and has been tested on a fresh
Ubuntu VMWare image:
http://open-ils.org/dokuwiki/doku.php?id=installing_evergreen_1.2_on_ubuntu_7.10

One good learning experience; if you opt to set a non-zero timeout in
CPAN config, set it to something high like 500, or else MARC::Charset
will time out while compiling its database of conversions and other
modules will fail to be built as a result :)

Dan

2008/7/28 Dan Scott <denials at gmail.com>:
> That's awesome, Dan!
>
> If you could add the Mnesia spool-clearing to a troubleshooting
> section of the wiki, I'm sure that would help lots of people out
> (versus the current draconian "dpkg --purge ejabberd" approach).
>
> I'll let you know when I've updated the docs so you can wrap a Kevlar
> vest around them - thanks a bunch!
>
> Dan
>
> 2008/7/28 Dan Wells <dbw2 at calvin.edu>:
>> Hello Dan S.,
>>
>> I think this sounds like a great idea.  I know the instructions have not kept up with Evergreen installation best practices, but I have been hesitant to rewrite them, since they do (mostly) work.  Ejabberd in particular has always been a problem area, and I have only just recently realized that clearing the Mnesia spool is a quick and dirty way to solve many of them, but if we leave ejabberd listening at localhost I think the worst problems will just go away.
>>
>> I have already moved out the old page to the "Older Versions" archive and added a promise of new things to come in its place, so feel free to deliver on that promise when you get the chance :)  If you go ahead and copy over the Debian instructions and make the changes you already know about, I will be happy to run through with an attempted Ubuntu newbie mentality to help make them as bullet-proof as possible.
>>
>> Thanks,
>> DW
>>
>>
>>
>>>>> "Dan Scott" <denials at gmail.com> 7/26/2008 11:52 AM >>>
>> 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
>>
>>
>
>
>
> --
> Dan Scott
> Laurentian University
>



-- 
Dan Scott
Laurentian University