en:developer:pharos
no way to compare when less than two revisions
Differences
This shows you the differences between two versions of the page.
— | en:developer:pharos [2023/03/13 01:46] (current) – created - external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | |||
+ | |||
+ | ====== PHAROS Image/Video indexing ====== | ||
+ | Instructions for installing PHAROS Image/Video indexing with Greenstone3. Based on GCC 4.4.3 and Ubuntu Linux 10.4 (Lucid Lynx). | ||
+ | |||
+ | //Initial instructions by Katherine Don, with modifications thanks to Evan Brown and Suzanne Little, Knowledge Media Institute // | ||
+ | |||
+ | ===== Check tools===== | ||
+ | |||
+ | We use svn 1.5 and ant 1.7.1 and java 1.6. | ||
+ | svn --version | ||
+ | ant -version | ||
+ | java --version | ||
+ | |||
+ | ANT_HOME and JAVA_HOME should be set, and the correct versions on your path. | ||
+ | |||
+ | Especially with a fresh install check that the following packages are installed: gettext, automake, autoconf, libtool, libmp4v2, libglib-2.0-dev(+dependencies), | ||
+ | |||
+ | =====checkout greenstone3===== | ||
+ | |||
+ | svn co http:// | ||
+ | cd pharos-greenstone3 | ||
+ | |||
+ | Generate build.properties from build.properties.in | ||
+ | |||
+ | ant | ||
+ | |||
+ | At this stage, you may like to change tomcat' | ||
+ | |||
+ | Check out building and other supplementary code | ||
+ | ant prepare | ||
+ | |||
+ | =====checkout extensions===== | ||
+ | |||
+ | cd ext | ||
+ | svn co http:// | ||
+ | svn co http:// | ||
+ | cd ../ | ||
+ | svn co http:// | ||
+ | cd ../../ | ||
+ | |||
+ | =====compile===== | ||
+ | |||
+ | Prior to running the Ant install build script, if you are running with GCC 4.4.x and/or the latest release of Ubuntu Linux (10.4 Lucid Lynx), the following changes and steps are required: | ||
+ | |||
+ | 1. pharos-greenstone3/ | ||
+ | Line 45: Change to const char *s (to avoid invalid conversion error). | ||
+ | |||
+ | 2. Make sure that the GNU Gettext package is installed - to avoid a missing msgfmt error during compile. | ||
+ | On Ubuntu with standard repositories enabled, this is accomplished most easily by: sudo apt-get install gettext | ||
+ | |||
+ | 3. Make sure that automake and autoconf packages are installed and available. | ||
+ | |||
+ | 4. The faac audio encoder module: changes are required to pharos-greenstone3/ | ||
+ | |||
+ | Remove line: | ||
+ | | ||
+ | Replace with: | ||
+ | | ||
+ | |||
+ | Remove: | ||
+ | | ||
+ | | ||
+ | | ||
+ | |||
+ | Replace with: | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | |||
+ | Then do autoreconf –vif to rebuild the makefiles | ||
+ | |||
+ | 5. Ruby 1.86 package: a change is required to pharos-greenstone3/ | ||
+ | Line 37: change to start #elif defined( rather than #elif define( This is fixed in Ruby 1.87 which is the currently used version. | ||
+ | |||
+ | Now proceed with the installation: | ||
+ | < | ||
+ | ant install | ||
+ | source gs3-setup.sh | ||
+ | compile video extension | ||
+ | cd gs2build/ | ||
+ | ./ | ||
+ | </ | ||
+ | You can ignore the instruction about AddHandler and httpd.conf - that is for Apache in GS2. | ||
+ | < | ||
+ | compile gs3 extensions | ||
+ | |||
+ | cd ../ | ||
+ | </ | ||
+ | Copy the axis jar files into tomcat: | ||
+ | < | ||
+ | mkdir ../ | ||
+ | cp lib/*.jar ../ | ||
+ | </ | ||
+ | Edit tomcat' | ||
+ | < | ||
+ | emacs ../ | ||
+ | </ | ||
+ | Find the shared.loader property and set it to the following: | ||
+ | < | ||
+ | shared.loader=${catalina.home}/ | ||
+ | </ | ||
+ | To compile and install pharos: | ||
+ | < | ||
+ | ant configure | ||
+ | ant compile | ||
+ | ant install | ||
+ | cd ../.. | ||
+ | </ | ||
+ | |||
+ | (Note, there is nothing to do to set up pharos-videois) | ||
+ | |||
+ | =====Test Greenstone3===== | ||
+ | < | ||
+ | | ||
+ | | ||
+ | ant start | ||
+ | </ | ||
+ | Then visit in a browser the URL printed on the screen | ||
+ | Choose ' | ||
+ | |||
+ | =====Collection building===== | ||
+ | |||
+ | Note, pharos derby database and tomcat need to running before building the collections. | ||
+ | If you use a new terminal, ' | ||
+ | |||
+ | ====Build an image collection==== | ||
+ | |||
+ | We have prepared a sample collection - contains some images and an appropriate config file. The images don't matter, but the config file can be tricky to set up. | ||
+ | |||
+ | Download the collection from http:// | ||
+ | |||
+ | Build the collection: | ||
+ | < | ||
+ | import.pl -site localsite image-demo | ||
+ | buildcol.pl -site localsite image-demo | ||
+ | </ | ||
+ | inside web/ | ||
+ | |||
+ | Retstart tomcat: | ||
+ | 'ant restart' | ||
+ | |||
+ | Tomcat must be restarted to (re)load the collection (can also be done with a=s& | ||
+ | |||
+ | View the collection - go back to browser and reload your greenstone3 home page. | ||
+ | |||
+ | From browse-> | ||
+ | |||
+ | ====Build a video collection==== | ||
+ | |||
+ | We have prepared a sample collection - contains some videos and an appropriate config file. The config file can be tricky to set up. And the sample videos are ones that we know can be converted to the correct form. Also contains flash stuff for streaming video player. | ||
+ | |||
+ | Download the collection from http:// | ||
+ | |||
+ | Need to change the default collectionConfig.xml on line 60 should be: | ||
+ | < | ||
+ | <option name=" | ||
+ | </ | ||
+ | Build the collection: | ||
+ | < | ||
+ | import.pl -site localsite video-demo | ||
+ | buildcol.pl -site localsite video-demo | ||
+ | </ | ||
+ | inside web/ | ||
+ | |||
+ | Retstart tomcat: | ||
+ | 'ant restart' | ||
+ | |||
+ | Go to home page and click on Pharos Video Demo. | ||
+ | |||
+ | ====To make a new collection: | ||
+ | < | ||
+ | mkcol.pl -site localsite < | ||
+ | </ | ||
+ | Will make a new collection in pharos-greenstone3/ | ||
+ | Put images and/or videos into the import directory. | ||
+ | |||
+ | Modify the etc/ | ||
+ | |||
+ | Need to copy the flash directory to the new collection so videos will display embedded in the page: | ||
+ | < | ||
+ | cp -r $GSDL3SRCHOME/ | ||
+ | </ | ||
+ | Then run the import and build scripts as above, rename building to index, and restart tomcat. | ||
+ | |||
+ | =====When things go wrong===== | ||
+ | |||
+ | * Greenstone log file is in web/ | ||
+ | * Tomcat log file is in packages/ | ||
+ | |||
+ | ====NoClassDefFoundError==== | ||
+ | |||
+ | The above directions may be enough to get a working version. However if you get a java.lang.NoClassDefFoundError: | ||
+ | < | ||
+ | cp $GSDL3SRCHOME/ | ||
+ | ant restart | ||
+ | </ |
en/developer/pharos.txt · Last modified: 2023/03/13 01:46 by 127.0.0.1