Differences

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

--- dev:quick-start_introduction_and_virtual_image [2012/03/27 13:34] – Change 'postgres' to 'opensrf' for DB upgrade step, as postgres does not have eg_config in its path dbw2
+++ dev:quick-start_introduction_and_virtual_image [2015/02/10 09:37] (current) – removed klussier
@@ Line 1: / Line 1: @@
-====== Getting started with Evergreen development ======
-Evergreen is built on the OpenSRF application framework. If you're interested in implementing new services in Evergreen, or in calling Evergreen APIs (and who wouldn't be?!), you should probably start by reading through the [[http://journal.code4lib.org/articles/3284|Easing Gently into OpenSRF]] article to get an overview of how OpenSRF works.
-You should also work through this [[http://evergreen-ils.org/~denials/workshop.html|tutorial that focuses on getting up and developing with Evergreen]].
-We have also documented the [[:contributing|norms and processes for contributing to the Evergreen project]] to help you settle into our community.
-To enable you to get hands-on with the code as quickly as possible, the **developer virtual image** available from [[http://evergreen-ils.org/downloads/vm/EvergreenMasterSqueeze.ova]] is current with OpenSRF and Evergreen Master as of 2012-02-10.
-The developer virtual image has a checkout of both OpenSRF and Evergreen's Git repositories, found in the opensrf user's home directory.  Detailed instructions for installing are available via each project's README file, or via the example below.
-<code bash>Grab the updated code from Git (as opensrf)
-cd /home/opensrf/Evergreen && git pull
-Upgrade dependencies (as root)
-cd /home/opensrf/Evergreen && make -f Open-ILS/src/extras/Makefile.install
-Compile the code (ss opensrf)
-cd /home/opensrf/Evergreen && ./configure --prefix=/openils --sysconfdir=/openils/conf
-make
-Install the updated code (as root)
-cd /home/opensrf/Evergreen && make STAFF_CLIENT_STAMP_ID=SomeStamp install
-cd /openils/var/web/xul
-rm server
-ln -sf SomeStamp/server server
-Change ownership of /openils (as root)
-chown -R opensrf:opensrf /openils
-Upgrade the Database (as opensrf)
-cd /home/opensrf/Evergreen/Open-ILS/src/sql/Pg && /home/opensrf/Evergreen/build/tools/update_db.sh localhost evergreen evergreen
-Restart Evergreen Services
-osrf_ctl.sh -l -a restart_all</code>