Difference between revisions of "DiscoverEd Quickstart"

From Creative Commons
Jump to: navigation, search
(How to install DiscoverEd)
Line 11: Line 11:
 
</pre>
 
</pre>
  
The script will check for dependencies.
+
The script will check for dependencies, build DiscoverEd, and launch a J2EE server with the software.
  
 
=== What does the script do? ===
 
=== What does the script do? ===
  
* Install the DiscoverEd code in <tt>/var/lib/discovered/</tt>
+
* Install the DiscoverEd code in <tt>./discovered</tt> (relative to the working directory)
 +
* Create a <tt>discovered</tt> database (the default configuration is for MySQL)
 
* Add a sample curator, and a sample feed
 
* Add a sample curator, and a sample feed
 
* Download the web pages linked to by that feed
 
* Download the web pages linked to by that feed
Line 21: Line 22:
  
 
The above steps use the search engine without using a web browser. To make it all work in your web browser, the script will then do the following:
 
The above steps use the search engine without using a web browser. To make it all work in your web browser, the script will then do the following:
* Install a copy of the excellent web server Tomcat in the same place
+
 
 +
* Download a copy of the excellent web server Tomcat in the same directory
 
* Run that copy of Tomcat
 
* Run that copy of Tomcat
 
* Open the search engine in Firefox
 
* Open the search engine in Firefox
Line 31: Line 33:
 
== Or do it manually ==
 
== Or do it manually ==
  
See '''[[DiscoverEd/Install manually]]'''.
+
The script has several variables which control its behavior, including the install location (<tt>DISCOVER_ED_ROOT</tt>) and database name (<tt>DED_DB_NAME</tt>).
 +
 
 +
If you need more control (or are using this in production), you'll probably want to do a '''[[DiscoverEd/Install manually|manual installation]]'''.

Revision as of 00:24, 12 May 2010


How to install DiscoverEd

Run these commands to download a quickstart script.

cd /tmp/ # As good a place as any
wget http://gitorious.org/discovered/repo/blobs/raw/deploy_script/gimme-discovered
bash gimme-discovered

The script will check for dependencies, build DiscoverEd, and launch a J2EE server with the software.

What does the script do?

  • Install the DiscoverEd code in ./discovered (relative to the working directory)
  • Create a discovered database (the default configuration is for MySQL)
  • Add a sample curator, and a sample feed
  • Download the web pages linked to by that feed
  • Run a test search for the term "crime", and print the results to your terminal

The above steps use the search engine without using a web browser. To make it all work in your web browser, the script will then do the following:

  • Download a copy of the excellent web server Tomcat in the same directory
  • Run that copy of Tomcat
  • Open the search engine in Firefox

What you should expect to see

This is a development branch. What you'll see is a search engine that says "DiscoverEd", but which is colored and laid-out incorrectly. The text of the results won't display. (We're working on it.)

Or do it manually

The script has several variables which control its behavior, including the install location (DISCOVER_ED_ROOT) and database name (DED_DB_NAME).

If you need more control (or are using this in production), you'll probably want to do a manual installation.