You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@lucene.apache.org by "Yonik Seeley (Created) (JIRA)" <ji...@apache.org> on 2012/03/20 14:31:42 UTC

[jira] [Created] (SOLR-3259) Solr 4 aesthetics

Solr 4 aesthetics
-----------------

                 Key: SOLR-3259
                 URL: https://issues.apache.org/jira/browse/SOLR-3259
             Project: Solr
          Issue Type: New Feature
            Reporter: Yonik Seeley
             Fix For: 4.0


Solr 4 will be a huge new release... we should take this opportunity to improve the out-of-the-box experience.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org


[jira] [Commented] (SOLR-3259) Solr 4 aesthetics

Posted by "Hoss Man (Commented) (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/SOLR-3259?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13234012#comment-13234012 ] 

Hoss Man commented on SOLR-3259:
--------------------------------

bq. the concept of an "example" server that you must configure yourself has become less than ideal... perhaps we should just create a "server" directory (but leave things like exampledocs under example)
bq. Would also be nice to remove the "multicore" directory in there (since the normal server is already multi-core enabled). Of course if we moved just the essential parts to "server", then "multicore", "example-DIH" and "exampledocs" would all be left behind in "example", as they should be.

once upon a time, i argued heavily that we should renamed "example" to "examples" and have many more of them ("minimal", "tech-products-from-the-90s", "books", "kitchen-sink", "multicore", "dih", etc...) .. and the only reason i never pushed harder for this was because that kind of directory structure would have made running the "main" example (whatever we might have called it) much harder then "java -jar start.jar" because it would have required specifying solr.solr.home.

Thinking about it some more now that you've brought this issue up, it occurs to me that in that intervening time, multicore solr setups have been come the norm, not the exception ... so i'm now much more on board the idea of having a single example setup -- even calling it "server" if people think that's a good idea -- provided we move all of the various examples we have into that example setup as multiple cores.

they don't have to all be enabled, they don't even have to be commented out in solr.xml, it would just be nice if they lived in the same directory and could easily be added as new cores with a simple CREATE commands a relative paths.

So by default if you did "cd server && java -jar start.jar" you might only get one collection (or maybe two if we also want to show off a "minimal" collection) but the docs for features like DIH might say "to see an example of this, hit the following URL to create a new collection using the DIH configs: http://localhost...CREATE"

bq. If anything I'd vote for making the distro closer to what people would want in production. You could then have a pure "solr/jetty" folder with ONLY jetty, a "solr/example-home" folder which holds todays "example/solr" ... start-solr.[cmd|sh], which copies the war from dist to jetty/webapps, sets -Dsolr.solr.home and starts Jetty

while i like the idea of creating clearer/cleaner separation between what files are "jetty" and what files are "solr" and what files are "config" i'm not a fan of your specific suggestions here because it moves away from the really clean simplicity of "cd something && java -jar start.jar" -- which make it *really* trivial for anyone anywhere to try solr out regardless of their os, or what weird eccentricities are in their shell, or whether the file perms on some scripts are correct, etc...

if we want to start shipping init.d scripts and what not for "production usage" (something we typically avoided in the past because there are so many different ways people like to do these things, not to mention that many people like to use tomcat or some other servlet container) then that seems like it could/should really be distinct from how people run the example for the tutorial ... it shouldn't be completely orthogonal, we should be able to say something like: "if you copy this ./server/ directory to some place on your production server, this directory of ./service-tools/ can be used to automatically start/stop when your machine comes up or down, just configure the path where you copied ./server/" ... but people shouldn't have to use some start.sh just to try out the tutorial not compared to how easy "java -jar start.jar" is today.
                
> Solr 4 aesthetics
> -----------------
>
>                 Key: SOLR-3259
>                 URL: https://issues.apache.org/jira/browse/SOLR-3259
>             Project: Solr
>          Issue Type: New Feature
>            Reporter: Yonik Seeley
>             Fix For: 4.0
>
>
> Solr 4 will be a huge new release... we should take this opportunity to improve the out-of-the-box experience.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org


[jira] [Commented] (SOLR-3259) Solr 4 aesthetics

Posted by "Yonik Seeley (Commented) (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/SOLR-3259?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13233629#comment-13233629 ] 

Yonik Seeley commented on SOLR-3259:
------------------------------------

Would also be nice to remove the "multicore" directory in there (since the normal server is already multi-core enabled).  Of course if we moved just the essential parts to "server", then "multicore", "example-DIH" and "exampledocs" would all be left behind in "example", as they should be.
                
> Solr 4 aesthetics
> -----------------
>
>                 Key: SOLR-3259
>                 URL: https://issues.apache.org/jira/browse/SOLR-3259
>             Project: Solr
>          Issue Type: New Feature
>            Reporter: Yonik Seeley
>             Fix For: 4.0
>
>
> Solr 4 will be a huge new release... we should take this opportunity to improve the out-of-the-box experience.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org


[jira] [Commented] (SOLR-3259) Solr 4 aesthetics

Posted by "Mark Miller (Commented) (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/SOLR-3259?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13233686#comment-13233686 ] 

Mark Miller commented on SOLR-3259:
-----------------------------------

bq. Would also be nice to remove the "multicore" directory in there

I have an issue somewhere that does this - I'm sure its out of date, but just as a note to dig it up when this is done.
                
> Solr 4 aesthetics
> -----------------
>
>                 Key: SOLR-3259
>                 URL: https://issues.apache.org/jira/browse/SOLR-3259
>             Project: Solr
>          Issue Type: New Feature
>            Reporter: Yonik Seeley
>             Fix For: 4.0
>
>
> Solr 4 will be a huge new release... we should take this opportunity to improve the out-of-the-box experience.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org


Re: [jira] [Commented] (SOLR-3259) Solr 4 aesthetics

Posted by Bill Bell <bi...@gmail.com>.
+1 to all folder suggestions

Bill Bell
Sent from mobile


On Mar 20, 2012, at 8:07 AM, Jan Høydahl (Commented) (JIRA)<ji...@apache.org> wrote:

> 
>    [ https://issues.apache.org/jira/browse/SOLR-3259?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13233414#comment-13233414 ] 
> 
> Jan Høydahl commented on SOLR-3259:
> -----------------------------------
> 
> +1 to the general idea of lifting the first-time experience of Solr. I like all your proposals except...
> 
> I'm not sure if we gain much by moving the example to a "server" folder. I think it's a Good Thing™ that we make it clear that what's provided is just an example, not for production. Another name for the example folder could be "jetty", because that's what it really is - which many are confused by today, they think that the "lib" and "etc" folders below "example" belong to Solr...
> 
> If anything I'd vote for making the distro closer to what people would want in production. You could then have a pure "solr/jetty" folder with ONLY jetty, a "solr/example-home" folder which holds todays "example/solr" making it more obvious what folder is actually the SOLR_HOME, and finally a start script on top level, start-solr.[cmd|sh], which copies the war from dist to jetty/webapps, sets -Dsolr.solr.home and starts Jetty. By default start-solr.sh would log to stdout, but a param could have it log to file.
> 
>> Solr 4 aesthetics
>> -----------------
>> 
>>                Key: SOLR-3259
>>                URL: https://issues.apache.org/jira/browse/SOLR-3259
>>            Project: Solr
>>         Issue Type: New Feature
>>           Reporter: Yonik Seeley
>>            Fix For: 4.0
>> 
>> 
>> Solr 4 will be a huge new release... we should take this opportunity to improve the out-of-the-box experience.
> 
> --
> This message is automatically generated by JIRA.
> If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
> For more information on JIRA, see: http://www.atlassian.com/software/jira
> 
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
> For additional commands, e-mail: dev-help@lucene.apache.org
> 

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org


[jira] [Commented] (SOLR-3259) Solr 4 aesthetics

Posted by "Jan Høydahl (Commented JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/SOLR-3259?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13233414#comment-13233414 ] 

Jan Høydahl commented on SOLR-3259:
-----------------------------------

+1 to the general idea of lifting the first-time experience of Solr. I like all your proposals except...

I'm not sure if we gain much by moving the example to a "server" folder. I think it's a Good Thing™ that we make it clear that what's provided is just an example, not for production. Another name for the example folder could be "jetty", because that's what it really is - which many are confused by today, they think that the "lib" and "etc" folders below "example" belong to Solr...

If anything I'd vote for making the distro closer to what people would want in production. You could then have a pure "solr/jetty" folder with ONLY jetty, a "solr/example-home" folder which holds todays "example/solr" making it more obvious what folder is actually the SOLR_HOME, and finally a start script on top level, start-solr.[cmd|sh], which copies the war from dist to jetty/webapps, sets -Dsolr.solr.home and starts Jetty. By default start-solr.sh would log to stdout, but a param could have it log to file.
                
> Solr 4 aesthetics
> -----------------
>
>                 Key: SOLR-3259
>                 URL: https://issues.apache.org/jira/browse/SOLR-3259
>             Project: Solr
>          Issue Type: New Feature
>            Reporter: Yonik Seeley
>             Fix For: 4.0
>
>
> Solr 4 will be a huge new release... we should take this opportunity to improve the out-of-the-box experience.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org


[jira] [Commented] (SOLR-3259) Solr 4 aesthetics

Posted by "Upayavira (Commented) (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/SOLR-3259?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13233542#comment-13233542 ] 

Upayavira commented on SOLR-3259:
---------------------------------

If you're going to have a jetty directory, it'd be pretty easy to have a 'tomcat' one also. The use would have to download and unpack Tomcat, point CATALINA_HOME at the Tomcat distribution, and CATALINA_BASE to this new 'tomcat' directory, and then they'd have a running Solr in Tomcat.

Just a thought.
                
> Solr 4 aesthetics
> -----------------
>
>                 Key: SOLR-3259
>                 URL: https://issues.apache.org/jira/browse/SOLR-3259
>             Project: Solr
>          Issue Type: New Feature
>            Reporter: Yonik Seeley
>             Fix For: 4.0
>
>
> Solr 4 will be a huge new release... we should take this opportunity to improve the out-of-the-box experience.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org


[jira] [Commented] (SOLR-3259) Solr 4 aesthetics

Posted by "David Smiley (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/SOLR-3259?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13296111#comment-13296111 ] 

David Smiley commented on SOLR-3259:
------------------------------------

I noticed Yonik's commit to schema.xml to move the fields ahead of the type definitions.  I like it!  But while you're at it, isn't this a good time to finally fix the indentation?  The first indentation level in the types section is only one space yet the rest on these lines are two -- it should be two throughout for all configuration files.  I recommend a complete re-indentation of the file by an IDE to clean it up, and hand-tweak as necessary.
                
> Solr 4 aesthetics
> -----------------
>
>                 Key: SOLR-3259
>                 URL: https://issues.apache.org/jira/browse/SOLR-3259
>             Project: Solr
>          Issue Type: New Feature
>            Reporter: Yonik Seeley
>             Fix For: 4.1
>
>
> Solr 4 will be a huge new release... we should take this opportunity to improve the out-of-the-box experience.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org


[jira] [Commented] (SOLR-3259) Solr 4 aesthetics

Posted by "David Smiley (Commented) (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/SOLR-3259?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13233611#comment-13233611 ] 

David Smiley commented on SOLR-3259:
------------------------------------

+1 to changing the "example" directory name to something like "server".  I realize I lost my argument in SOLR-2586.
                
> Solr 4 aesthetics
> -----------------
>
>                 Key: SOLR-3259
>                 URL: https://issues.apache.org/jira/browse/SOLR-3259
>             Project: Solr
>          Issue Type: New Feature
>            Reporter: Yonik Seeley
>             Fix For: 4.0
>
>
> Solr 4 will be a huge new release... we should take this opportunity to improve the out-of-the-box experience.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org


[jira] [Commented] (SOLR-3259) Solr 4 aesthetics

Posted by "Erick Erickson (Commented) (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/SOLR-3259?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13234283#comment-13234283 ] 

Erick Erickson commented on SOLR-3259:
--------------------------------------

bq:   that kind of directory structure would have made running the "main" example (whatever we might have called it) much harder then "java -jar start.jar" because it would have required specifying solr.solr.home.

And I totally agree that the less frustrating we make startup for a new person the better. Could we solve it by providing some number of startup scripts? Each is stupid-simple "java -Dsolr.solr.home=blahblah -jar start.jar". Or even a shell script that took a parameter that defaulted to a simple, single core....
                
> Solr 4 aesthetics
> -----------------
>
>                 Key: SOLR-3259
>                 URL: https://issues.apache.org/jira/browse/SOLR-3259
>             Project: Solr
>          Issue Type: New Feature
>            Reporter: Yonik Seeley
>             Fix For: 4.0
>
>
> Solr 4 will be a huge new release... we should take this opportunity to improve the out-of-the-box experience.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org


[jira] [Commented] (SOLR-3259) Solr 4 aesthetics

Posted by "Yonik Seeley (Commented) (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/SOLR-3259?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13233402#comment-13233402 ] 

Yonik Seeley commented on SOLR-3259:
------------------------------------

Some ideas:
 - our fieldType list has grown *huge*... we should probably move the field list to the top of the file where it's easier to find
 - the preference for JSON over XML seems to be continuing - we should make things more JSON oriented by adding a /query handler that defaults to wt=json and perhaps indent=true
 - the concept of an "example" server that you must configure yourself has become less than ideal... perhaps we should just create a "server" directory (but leave things like exampledocs under example)
 - some new JSON based example docs that aren't based on electronics from '05  (or as an alternative for certain "quickstart" guides, start off with a curl command to add some data rather than trying to shove it all in exampledocs)
                
> Solr 4 aesthetics
> -----------------
>
>                 Key: SOLR-3259
>                 URL: https://issues.apache.org/jira/browse/SOLR-3259
>             Project: Solr
>          Issue Type: New Feature
>            Reporter: Yonik Seeley
>             Fix For: 4.0
>
>
> Solr 4 will be a huge new release... we should take this opportunity to improve the out-of-the-box experience.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org


[jira] [Commented] (SOLR-3259) Solr 4 aesthetics

Posted by "Mark Miller (Commented) (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/SOLR-3259?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13233698#comment-13233698 ] 

Mark Miller commented on SOLR-3259:
-----------------------------------

bq. be a 'tomcat' one also. 
Not a fan of supporting another web container out of hte box.

bq. that we make it clear that what's provided is just an example,

You can make this clear in other ways - the folder name is a blunt for this. Most people end up using the example as there base anyhow - I doubt it has much benefit in pointing people to trim down their configs. This whole idea of providing a webapp and then an example setup is just old and ugly. We should care about one containter, the one we ship with, and our default shipping configs should be a good enough starting point that we don't have to call the folder "please_you_must_edit_configs_and_not_start_me_out_of_the_box"

bq. jetty

Not a fan - I think non Java guys should be able to open the package and quickly see the folder they need to move to. jetty is not great here - server is better.
                
> Solr 4 aesthetics
> -----------------
>
>                 Key: SOLR-3259
>                 URL: https://issues.apache.org/jira/browse/SOLR-3259
>             Project: Solr
>          Issue Type: New Feature
>            Reporter: Yonik Seeley
>             Fix For: 4.0
>
>
> Solr 4 will be a huge new release... we should take this opportunity to improve the out-of-the-box experience.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org


[jira] [Commented] (SOLR-3259) Solr 4 aesthetics

Posted by "Erik Hatcher (Commented) (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/SOLR-3259?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13234290#comment-13234290 ] 

Erik Hatcher commented on SOLR-3259:
------------------------------------

bq. And I totally agree that the less frustrating we make startup for a new person the better. Could we solve it by providing some number of startup scripts? Each is stupid-simple "java -Dsolr.solr.home=blahblah -jar start.jar". Or even a shell script that took a parameter that defaulted to a simple, single core....

We kinda already have this, powered by "ant run-example", you can -D control/override any of these, even turning on debug with -Dexample.debug=true

{code}
    <property name="example.solr.home" location="example/solr"/>
    <property name="example.data.dir" location="example/solr/data"/>
    <property name="example.debug.suspend" value="n"/>
    <property name="example.jetty.port" value="8983"/>
    <condition property="example.jvm.line" value="-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=${example.debug.suspend},address=5005">
      <isset property="example.debug"/>
    </condition>
    <property name="example.jvm.line" value=""/>
    <property name="example.heap.size" value="512M"/>
{code}

Granted this is Ant and carries with it a dependency to be installed, so not the not quite what Erick is asking for in end user ease of experience.  But the Ant run-example capability is the basic idea of what should be controllable at a minimum.  

                
> Solr 4 aesthetics
> -----------------
>
>                 Key: SOLR-3259
>                 URL: https://issues.apache.org/jira/browse/SOLR-3259
>             Project: Solr
>          Issue Type: New Feature
>            Reporter: Yonik Seeley
>             Fix For: 4.0
>
>
> Solr 4 will be a huge new release... we should take this opportunity to improve the out-of-the-box experience.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org