Differences

This shows you the differences between two versions of the page.

--- installing_evergreen_1.2.x_on_ubuntu_7.04 [2007/10/22 14:16] – Added New Step #25, which is the same as the old with updated start/stop commands dbw2
+++ installing_evergreen_1.2.x_on_ubuntu_7.04 [2010/09/06 13:19] (current) – Delete obsolete page dbs
@@ Line 1: / Line 1: @@
-====== Installing Evergreen 1.2.x on Ubuntu 7.04 ======
-For those installing Evergreen versions 1.2.x and up, please base your installation on the instructions for earlier versions given at [[Installing Evergreen on Ubuntu 7.04]] with the following changes, made to account for updates in the software:
-Note, once 1.2.0 is promoted from release candidate to stable version, these instructions should perhaps be merged into a single complete document, but these notes should help people with the release candidate in the meantime.
-==== New Step #4 ====
-**Notes for Downloading Files:**
-  * In addition to the items listed in the old Step #4, make sure to [[http://www.open-ils.org/downloads.php|download]] both OpenSRF and OpenILS, as they are now separate.
-==== New Step #8 ====
-**Install Perl package dependencies**
-  * Text::CSV (package name libtext-csv-perl) was added as dependency on 2007-10-03.  The ammended command is therefore:
-<code>sudo apt-get install \
- libcache-memcached-perl \
- libcgi-perl \
- libclass-dbi-abstractsearch-perl \
- libdatetime-perl \
- libdbd-pg-perl \
- libdbd-sqlite3-perl \
- liberror-perl \
- libexception-class-perl \
- libgd-graph3d-perl \
- libmd5-perl \
- libmodule-build-perl \
- libnet-server-perl \
- libspreadsheet-writeexcel-perl \
- libtemplate-perl \
- libtext-aspell-perl \
- libtext-csv-perl \
- libunix-syslog-perl \
- libxml-libxml-perl \
- libxml-libxslt-perl \
- libxml-simple-perl \
- libuniversal-require-perl \
- liblog-log4perl-perl \
- libmarc-record-perl \
- libmarc-charset-perl \
- libnet-z3950-perl \
- libemail-send-perl \
- libtext-csv-perl
-</code>
-==== New Step #20 ====
-**Notes for Building OpenSRF:**
-  * Download and decrompress to wherever_you_want/OpenSRF-0.9/
-  * Edit OpenSRF-0.9/Makefile, adding, at the top, the line:
-  SHELL=/bin/bash
-  * Leave all options in install.conf at the defaults.
-  * The following lines must be added to /etc/apache2/httpd.conf in order to allow apxs2 to function as expected during our make install (the file should exist but will probably be blank):
-  # This is here for apxs compatibility (and this comment is required!)
-  #LoadModule mod_placeholder /usr/lib/apache2/modules/mod_placeholder.so
-  * In OpenSRF-0.9/ directory, run:
-  CFLAGS=-D_LARGEFILE64_SOURCE make all
-  sudo make install
-**Notes for building OpenILS:**
-  * In Evergreen-ILS-1.2.0-rc1/ directory, run:
-  make config
-  * Select all defaults, with the following exceptions:
-  Build_targets [openils_all evergreen_core]   !!!!IMPORTANT!!!!
-  Database Host [your_host_name_here]     (eg-server if you followed the wiki)
-  Database Name [evergreen]     (if you followed the wiki)
-  Database User [evergreen]     (if you followed the wiki)
-  Database Password [everPass]     (if you followed the wiki)
-  * Run:
-  CFLAGS=-D_LARGEFILE64_SOURCE make
-  sudo make install
-  * Enter password, repeatedly, as needed for database build
-  * The install prompts you to run "chown -R opensrf:opensrf /openils/".  You may ignore this for now, as we do this step a bit later.
-==== New Step #23 ====
-  * Go to your installed Evergreen directory
-  cd /openils/
-  * Create the TWO main configuration files:
-  sudo cp conf/opensrf_core.xml.example conf/opensrf_core.xml
-  sudo cp conf/opensrf.xml.example conf/opensrf.xml
-  * Edit opensrf.xml.  In each <database> node, change the settings as appropriate:
-  <database>
-    <driver>Pg</driver>
-    <host>eg-server</host>
-    <port>5432</port>
-    <name>evergreen</name>
-    <user>evergreen</user>
-    <password>everPass</password>
-  </database>
-...
-  * Continue with the old Wiki step #23, starting at "in the <reporter><base_uri> node..." and ending with "Make the cgis executable":
-  sudo chmod 755 /openils/var/cgi-bin/*.cgi
-...
-  * Add the following lines to the top of /openils/bin/autogen.sh and /openils/bin/osrf_ctl.sh (after the #!/bin/bash line).  There are other ways to accomplish this, but this is one of the simplest and least intrusive:
-  export PATH=$PATH:/openils/bin
-  export PERL5LIB=/openils/lib/perl5
-...
-Continue with old #23, starting at "Make sure all the openils stuff is owned by opensrf:" through the end of the step.
-==== New Step #24 ====
-  * Start OpenILS
-  sudo -u opensrf /openils/bin/osrf_ctl.sh -c /openils/conf/opensrf_core.xml -a start_all
-  * Start (or restart) apache
-  sudo /etc/init.d/apache2 start
-If you are not using a fully qualified domain name, you may get a notice for that, but apache will still start fine.
-==== New Step #25 ====
-This should change in the future, but at the time of this writing, there are apparently some portions of the code which are still Pines specific.  One of these (circulation rules) requires groups named Outreach and Trustee.  These two groups must be created using the CGI config files (http://eg-server/cgi-bin/config.cgi).  From the main config page, click on User Groups and Permissions, then on Users, then fill in the New Child boxes appropriately for each group (at the bottom of the page) and click Add New.  When finished, it seems we should restart the system to get the changes to take full effect:<code>sudo -u opensrf /openils/bin/osrf_ctl.sh -c /openils/conf/opensrf_core.xml -a stop_all</code> wait for activity to stop or use ps to verify that all the services have stopped, then <code>sudo -u opensrf /openils/bin/osrf_ctl.sh -c /openils/conf/opensrf_core.xml -a start_all</code>
-==== New Step #26 ====
-  * Finalize the OPAC.  This command will create all the needed Javascript files to make the OPAC functional (this must be run from /openils/bin):
-  sudo -u opensrf ./autogen.sh /openils/conf/opensrf_core.xml
-You can continue with the previously documented instructions from here through the end, without changes.