[SOLR-3753] Core admin and solr.xml documentation for 4.0 needs to be updated for 4.0 changes

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 4.0-BETA
• Fix Version/s: 4.0, 6.0
• Assignee: Chris M. Hostetter
• Reporter: Tom Burton-West
• Created: 23/Aug/12 17:59
• Updated: 09/May/16 18:47
• Resolved: 17/Sep/12 17:38

Description

The existing documentation on Solr Cores needs to be updated to reflect changes in Solr 4.0

If having at least one solr core declared is mandatory for Solr 4.0, that needs to be stated in the release notes, in the example solr.xml file, and on the wiki page for CoreAdmin. http://wiki.apache.org/solr/CoreAdmin.

In the absence of a solr.xml file, current 4.0 behavior is to use defaults declared in CoreContainer.java. This needs to be documented; probably in solr.xml and/or on the CoreAdmin page. (See line 94 of CoreAdmin.java where the default name "collection1" is declared. Without this documentation, users can get confused about where the "collection1" core name is coming from. (I'm one of them).

The solr.xml file states that paths are relative to the "installation directory" This needs to be clarified. In addition it appears that currently relative paths specified using "." or ".." are interpreted as string literals. If that is not a bug, than this behavior needs to be documented. If it is a bug, please let me know and I'll open another issue.

The example/solr/README.txt Needs to clarify which files need to be in Solr Home and which files are mandatory or optional in the directories containing configuration files (and data files) for Solr cores.

Issue Links

• relates to: SOLR-3288 audit tutorial/example before 4.0 release