If preconf attendees aren't yet on the Google Group specific to the
event, get yourself on:
<http://groups.google.com/group/code4libpreconf>
There are files posted, and I'd love feedback on how the steps work
for you, at least the very basics - fire Solr up, hit the admin page
- see 16 documents there? If you get that far, you should be in good
shape. If not, if my instructions are broken let me know. If your
environment is broken, fix it :)
Erik
Begin forwarded message:
From: Erik Hatcher <[EMAIL PROTECTED]>
Date: February 18, 2007 11:50:15 PM EST
To: code4libpreconf <[EMAIL PROTECTED]>
Subject: starter kit, alpha release
Reply-To: [EMAIL PROTECTED]
Welcome preconferencers!
I've uploaded a couple of files to the "Files" area of this here
Google Group.
Directions for their use are in the preconf-alpha.zip file, and pasted
below so you know what to do even before cranking open a .zip file.
Note that the instructions reference a preconf-final.zip, though I
uploaded preconf-alpha.zip. If you're interested in jump starting
things before next week, give it a shot and report back any
weirdnesses that you may encounter in your environments. I'll publish
a preconf-final.zip, and possibly an updated base Solr apache-
solr-1.2-
solr4lib-dev.zip as well prior to the pre-conference. There will
also be a handful of CD's and USB drives with the files available for
sharing at the pre-conference.
Please try to give the SOLR 101 section a try before the
preconference. But rest assured that coming to the pre-conference
cold is fine, and in fact expected. However, ironing out
environmental issues with Java installation or any kinks that might be
in my instructions is recommended to make the pre-conference go most
smoothly for you. Remember, the pre-conference is about Solr, not
about installing Java, configuring paths, editing registry keys. The
more prepared your environment, the more fun you'll have!
For those of you bringing laptops and your own data, please also be
sure bring along all necessary development tools installed and its a
good idea to have documentation that might come in handy installed
locally (rather than relying on a network connection). USB drives
come in handy for sharing files, so bring 'em if you got 'em.
I'm really looking forward to this event, and have been preparing for
it for a while now. I've even been making changes to Solr itself to
enable easy launching of different datasets.
Let me know what is broken with the examples or instructions.
Thanks,
Erik
== code4lib07_preconf_guide.txt ==
Pre-requisites:
* Java 1.5+, preferably a JDK, though a JRE may suffice (though may
error on admin JSP pages)
* apache-solr-1.2-solr4lib-dev.zip and preconf-final.zip downloads.
To get started:
- Unzip apache-solr-1.2-solr4lib-dev.zip into your home directory.
It will put all its files under a solr4lib subdirectory.
- Unzip preconf-final.zip into your new solr4lib directory. You
should now have ~/solr4lib/preconf.
- Open solr4lib/preconf/code4lib07_preconf_guide.txt
- Open solr4lib/preconf/flowchart.tiff
= SOLR 101 =
{{{
# svn co https://svn.apache.org/repos/asf/lucene/solr/trunk solr4lib
# -r 508922 ???
# cd solr4lib
# ant example # unnecessary with the preconf download
# - problems? try "ant test"
cd preconf/solr
java -jar start.jar
------- new shell window -------
# preconf download already includes built index, skip this step for
now
cd solr4lib/preconf/solr/exampledocs
java -jar post.jar http://localhost:8983/solr/update *.xml
# TRY IT: http://localhost:8983/solr/select?q=ipod (view source)
# for better source viewing, try http://localhost:8983/solr/
select?q=ipod&wt=json&indent=true
# TIP: append &wt=json&indent=true to Solr query URLs in your
browser
# to see the output nicely formatted and readable.
# Substitute in "python" or "ruby" for "json", to taste.
# for preconf folks that skipped the previous load, follow these
step:
# * stop Solr
# * delete the solr4lib/preconf/solr/data directory
# * restart Solr
# * post the example XML files
# * continue after successfully querying with your browser as
above.
== Solr's Administration Console ==
# http://localhost:8983/solr/admin
== Use the force, Luke ==
# Luke is included in the preconf download, under solr4lib/preconf/
luke
cd solr4lib/luke
java -jar luke.jar
# open solr4lib/preconf/solr/solr/data/index
== Fire up your own dataset ==
# copy example solr directory
mkdir solr4lib/preconf/myfirst
cd solr4lib/preconf/myfirst
cp -R ../solr/solr/* . # should have conf and data subdirectories,
etc
# test that solr works on the newly moved directory
cd solr4lib/preconf/solr
java -Dsolr.solr.home=../myfirst -jar start.jar
# Now to customize the configuration to your needs:
# * shut down solr
# * remove solr4lib/myfirst/data directory
# * customize solr4lib/myfirst/conf/schema.xml and solrconfig.xml
# index your data
# test queries through Solr's HTTP interface and administrative
console at:
# http://localhost:8983/solr/admin
}}}
= SOLR 201 =
{{{
== Playing with built-in sample sets ==
# The following samples live under the solr4lib/client/ruby/solr-ruby/
examples directory.
# For best results, stop Solr and restart it with a different data
directory specified
# (-Dsolr.data.dir=... on the command-lines below).
=== Delicious Library ===
# Launch Solr
cd solr4lib/preconf/solr
java -Dsolr.solr.home=../../client/ruby/solr-ruby/solr/solr/ -
Dsolr.data.dir=delicious_library -jar start.jar
# index the data
cd solr4lib/client/ruby/solr-ruby/examples/delicious_library
# CSV sample data in sample_export.txt
# Homework: write a script in your language of choice to import this
data into Solr
# The Ruby importer scripts leverage the solr-ruby rubygem (gem
install solr-ruby).
# See additional documentation on the necessary Ruby configuration
for these
# examples to work properly.
# index Delicious Library sample data:
ruby dl_importer.rb sample_export.txt
# See what fields were indexed:
# http://localhost:8983/solr/select?qt=indexinfo&wt=ruby&indent=on
=== Tang poems ===
# The Tang poem data originated from the University of Virginia's
Etext Center
# http://etext.virginia.edu/chinese/tangeng.html
# NOTE: the site is Chinese Big5 Traditional encoded, but the
data file
# used here has been converted to UTF8.
# Launch Solr
cd solr4lib/preconf/solr
java -Dsolr.solr.home=../../client/ruby/solr-ruby/solr/solr/ -
Dsolr.data.dir=tang -jar start.jar
# Hpricot is required to index the Tang poems using this Ruby script
(gem install hpricot).
# index the data
cd solr4lib/client/ruby/solr-ruby/examples/tang
ruby tang_importer.rb
# Multi-lingual goodness, with facets!
#
http://localhost:8983/solr/select?
&wt=ruby&facet=true&facet.field=type_zh_facet&facet.field=author_zh_fa
cet&facet.field=type_en_facet&facet.field=author_en_facet&facet.mincou
nt=1&q=*:*&fl=*,score&qt=standard&facet.sort=true&rows=0&indent=on
=== MARC ===
# Launch Solr
cd solr4lib/preconf/solr
java -Dsolr.solr.home=../../client/ruby/solr-ruby/solr/solr/ -
Dsolr.data.dir=marc -jar start.jar
# ruby-marc library required (gem install marc) to import the sample
MARC data using this Ruby script.
# index the data
cd solr4lib/client/ruby/solr-ruby/examples/marc
unzip sample_marc.mrc.zip
ruby marc_importer.rb sample_marc.mrc
== Flare (for extra credit) ==
# Rails 1.2.2 is required (gem install rails)
# (currently working on removing Sparklines dependency)
cd solr4lib/client/ruby/flare
script/server
# http://localhost:3000
}}}
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google
Groups "code4libpreconf" group.
To post to this group, send email to [EMAIL PROTECTED]
To unsubscribe from this group, send email to code4libpreconf-
[EMAIL PROTECTED]
For more options, visit this group at http://groups.google.com/
group/code4libpreconf?hl=en
-~----------~----~----~----~------~----~------~--~---
