[OPEN-ILS-GENERAL] Installation

Dan Scott denials at gmail.com
Wed Mar 12 20:56:29 EDT 2008

On 11/03/2008, Gord Ripley <gripley at trentu.ca> wrote:
> Hi:
>  Can anyone throw a bit of light on what is meant by the following lines in the Debian/Evergreen installation instructions? ie. change to what? And for #21, again, set to what? Maybe it will be instructive for insiders to see how a Linux/Evergreen tyro can be seriously baffled by what must seem  trivial. A few words in the documentation could remedy this, I expect. Unless, of course, Linux/Evergreen tyros are expected to play elsewhere.
>  Gord
>  #19 Edit opensrf.xml:
>    1.      Change the database user, name, password, and host entries throughout.
>    2.      Change the opening and closing tags within the <hosts> XML element to reflect your FQDN.
>  #20 Edit opensrf_core.xml:
>    1.      Change the Jabber users and domains.
>  #21 Edit live-db-setup.pl:
>    1.      Set the database connection information. This is used by the cgi-bin config scripts.

Hmm. I had never run across "tyro" before. Anyways...

So one by one, I'll try providing more elaborate instructions. These
actually come almost directly from the workshop presentation I gave at
code4lib (http://open-ils.org/dokuwiki/doku.php?id=advocacy:evergreen_workshop),
in which I was trying to address precisely these areas of ambiguity in
the original docs (when I was just too tired to figure out how to
explain it clearly).

Tell me if it's a move in the right direction:


Change the database name, database user and password, and database
hostname entries throughout opensrf.xml to match the database name,
username, password, and hostname that you created in step #5.

For example:


Change the name of the child element of the <hosts> element in
opensrf.xml to match the fully-qualified domain name of your server.
For example:

            <!-- ^-=-
                Should match the fully qualified domain name of the host.

                On Linux, the output of the following command is authoritative:
          $ perl -MNet::Domain -e 'print Net::Domain::hostfqdn();'

                <!-- services hosted on this machine -->
            ... other stuff here

#20 Edit opensrf_core.xml:

  1.      Change the Jabber usernames and passwords as follows:

/config/opensrf/username = opensrf
/config/gateway/username = opensrf
/config/router/transport/username = router

We also specify the domains from which we'll accept and to which we'll
make connections. Let's just specify "localhost" throughout for a
single-server install for each of the following elements:


# 21. Copy /openils/conf/srfsh.xml.example to .srfsh.xml in the home
directory of each user you want to use to run the srfsh command line
client for testing OpenSRF, and edit .srfsh.xml as follows:

* username and password is your opensrf client
* domain is the router hostname
* logfile is the full path for a log file


#22. Edit live-db-setup.pl:
   1.      Set the database connection information. This is used by
the cgi-bin config scripts. For example:

$main::config{dsn} = 'dbi:Pg:host=;dbname=evergreen;port=5432';
$main::config{usr} = 'evergreen';
$main::config{pw} = 'evergreen';
$main::config{index} = "config.cgi";

Dan Scott
Laurentian University

More information about the Open-ils-general mailing list