lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Jan Høydahl (JIRA) <>
Subject [jira] [Commented] (SOLR-3619) Rename 'example' dir to 'server'
Date Fri, 13 Jul 2012 23:22:34 GMT


Jan Høydahl commented on SOLR-3619:

The name "server" is good in that it indicate that there's actually an appserver inside.

But it feels wrong to include one example config in "server" and leave the others by themselves.
After all, the nature of a search engine is that every user needs their own custom schema,
so anything we provide OOTB will per definition be an example. We should not fool people into
thinking that there is a "default" or "generic" schema - we simply provide a starting point.
So to make it even easier for beginners to explore all of Solr including DIH and extracting-handler
etc, let's have simply *one* examples/solrhome with all the examples we wish to expose (and
maintain!). It will give them more prime-time, we can get rid of the old "multicore" etc.

Seen together with the start-scripts issue, I say we should have a top-level {{solr/bin}}
with all the scripts, including zkcli, and a {{feed-example}} script. Here's my take on new

├── bin
│   ├──
│   ├──
│   ├──
│   ├── zkcli.bat
│   └──
├── contrib
├── dist
├── docs
├── examples
│   ├── exampledocs
│   │   ├── docs
│   │   └── products
│   └── solrhome
│       ├── DIH-db
│       ├── DIH-rss
│       ├── docs
│       ├── products
│       └── solr.xml
└── server
    ├── solr.home (file)
    └── webapps

With this setup, the {{products}} core would be today's "collection1", and {{docs}} would
be a handful of PDFs and HTMLs for use with solr-cell and/or DIH files example. Today's "collection1"
is not very well tuned for PDF/HTML kind of docs, so it may be better with a dedicated schema
for such docs.

The one-liner for starting and feeding examples could then be something like:
cd solr/bin; ./; ./ all

But if the example configs are not below {{server/}} anymore, the old {{cd server; java -jar
start.jar}} will not work anymore. Soft-linking a "solr" folder to {{../examples/solrhome}}
wouldn't work for Windows, so a nice solution could be to in addition to looking for a {{./solr}}
folder for our SOLR_HOME, we look for a {{./solr.home}} file with one line poining to SOLR_HOME.
Separating binaries and data this way is also a preferred way for many, and it makes the whole
concept of SOLR_HOME more clear to people - today some are confused about {{solr/example/solr}}
being SOLR_HOME.
> Rename 'example' dir to 'server'
> --------------------------------
>                 Key: SOLR-3619
>                 URL:
>             Project: Solr
>          Issue Type: Improvement
>            Reporter: Mark Miller
>            Assignee: Mark Miller
>             Fix For: 4.0, 5.0
>         Attachments: SOLR-3619.patch, server-name-layout.png

This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators:!default.jspa
For more information on JIRA, see:


To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message