SOLR-README.txt 2.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677
  1. # Licensed to the Apache Software Foundation (ASF) under one or more
  2. # contributor license agreements. See the NOTICE file distributed with
  3. # this work for additional information regarding copyright ownership.
  4. # The ASF licenses this file to You under the Apache License, Version 2.0
  5. # (the "License"); you may not use this file except in compliance with
  6. # the License. You may obtain a copy of the License at
  7. #
  8. # http://www.apache.org/licenses/LICENSE-2.0
  9. #
  10. # Unless required by applicable law or agreed to in writing, software
  11. # distributed under the License is distributed on an "AS IS" BASIS,
  12. # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13. # See the License for the specific language governing permissions and
  14. # limitations under the License.
  15. Default Solr Home Directory
  16. =============================
  17. This directory is the default Solr home directory which holds
  18. configuration files and Solr indexes (called cores).
  19. Basic Directory Structure
  20. -------------------------
  21. The Solr Home directory typically contains the following...
  22. * solr.xml *
  23. This is the primary configuration file Solr looks for when starting;
  24. it specifies high-level configuration options that apply to all
  25. of your Solr cores, such as cluster-wide SolrCloud settings like
  26. the ZooKeeper client timeout.
  27. In addition, you can also declare Solr cores in this file, however
  28. it is recommended to just use automatic core discovery instead of
  29. listing cores in solr.xml.
  30. If no solr.xml file is found, then Solr assumes that there should be
  31. a single SolrCore named "collection1" and that the "Instance Directory"
  32. for collection1 should be the same as the Solr Home Directory.
  33. For more information about solr.xml, please see:
  34. https://lucene.apache.org/solr/guide/solr-cores-and-solr-xml.html
  35. * Individual SolrCore Instance Directories *
  36. Although solr.xml can be configured to look for SolrCore Instance Directories
  37. in any path, simple sub-directories of the Solr Home Dir using relative paths
  38. are common for many installations.
  39. * Core Discovery *
  40. During startup, Solr will scan sub-directories of Solr home looking for
  41. a specific file named core.properties. If core.properties is found in a
  42. sub-directory (at any depth), Solr will initialize a core using the properties
  43. defined in core.properties. For an example of core.properties, please see:
  44. example/solr/collection1/core.properties
  45. For more information about core discovery, please see:
  46. https://lucene.apache.org/solr/guide/defining-core-properties.html
  47. * A Shared 'lib' Directory *
  48. Although solr.xml can be configured with an optional "sharedLib" attribute
  49. that can point to any path, it is common to use a "./lib" sub-directory of the
  50. Solr Home Directory.
  51. * ZooKeeper Files *
  52. When using SolrCloud using the embedded ZooKeeper option for Solr, it is
  53. common to have a "zoo.cfg" file and "zoo_data" directories in the Solr Home
  54. Directory. Please see the SolrCloud documentation for more details.
  55. https://lucene.apache.org/solr/guide/solrcloud.html