Cookbook to install, configure, and start a Solr server (version 6).
Solr 6 comes prepackaged with its own installation script, this cookbook simply prepares an appropriate environment and executes that install script.
solr_6::install
- This will install Java (optional), download Solr, configure, install,
and start the server.solr_6::deploy
- This will download a tarball containing one or more solr cores to the
SOLR_HOME directory and restart the server. This is useful for bootstraping Solr when not using Solr Cloud.node['solr']['install_java']
This recipe will automatically install JDK v1.8 from the community cookbook unless node['solr']['install_java']
is set to false. The java verson can be changed by overriding node['java']['jdk_version']
node['solr']['version']
node['solr']['url']
node['solr']['dir']
node['solr']['user']
node['solr']['create_user']
node['solr']['group']
node['solr']['create_group']
node['solr']['data_dir']
node['solr']['host']
node['solr']['port']
node['solr']['timezone']
node['solr']['zk_host']
node['solr']['zk_client_timeout']
node['solr']['java_mem']
node['solr']['gc_tune']
node['solr']['gc_log_opts']
node['solr']['enable_remote_jmx_opts']
node['solr']['rmi_port']
node['solr']['enable_remote_jmx_opts']
is "false" then this line will be commented outnode['solr']['solr_authentication_client_configurer']
node['solr']['solr_authentication_opts']
node['solr']['solr_ssl_key_store']
node['solr']['solr_ssl_key_store_password']
node['solr']['solr_ssl_trust_store']
node['solr']['solr_ssl_trust_store_password']
node['solr']['solr_ssl_need_client_auth']
node['solr']['solr_ssl_want_client_auth']
node['solr']['solr_ssl_client_key_store']
node['solr']['solr_ssl_client_key_store_password']
node['solr']['solr_ssl_client_trust_store']
node['solr']['solr_ssl_client_trust_store_password']
node['solr']['deploy_url']
If the solr_6::deploy
recipe is invoked, but the node['solr']['deploy_url']
is not set the recipe will raise an exception.
Currently only publicly available urls can be downloaded. Providing more options could be added down the road (see Contributing).
One or more Solr core directories can be stored at the root of the archive. The provided url will be downloaded and extracted directly into the SOLR_HOME directory. Solr 6 provides core autodiscovery so cores should be available immediately after the service restarts.
Java 8 is not currently installable on Debian with the Java community Chef recipe. Debian could be supported if Java 8 is installed manually.
deploy
recipe now belong to the specified user. Previously the permissions were incorrect as all the files belonged to root.node['solr']['create_user']
and node['solr']['create_group']
. If set to true
the user and group specified for solr will be created by the install recipe. This allows the creation of users to be disabled if upstream processes need to create the users and/or groups. The default value is true
.v2.0 -- allow configuration of multiple instances through Chef Custom Resources
Please see CONTRIBUTING for details.
Authors:: Nate Flood for ECHO Inc. < nflood@echonet.org >
License: MIT