Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status

RSS

solr_6 (3) Versions 1.0.1

Installs/Configures Apache Solr Version 6

Policyfile
Berkshelf
Knife
cookbook 'solr_6', '~> 1.0.1', :supermarket
cookbook 'solr_6', '~> 1.0.1'
knife supermarket install solr_6
knife supermarket download solr_6
README
Dependencies
Quality 17%

solr_6 Cookbook

Coverage Status Build Status Cookbook Version

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.

Recipes

  • 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.

Attributes

Java

  • node['solr']['install_java']
    • Install the Java Virtual Machine
    • Default: true

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']

Solr

Installation

  • node['solr']['version']
    • Version of Solr to install
    • Default: '6.0.1'
  • node['solr']['url']
    • Remote location of the Solr source files
    • Default: Automatically determined from version specified.
  • node['solr']['dir']
    • Where to install Solr
    • Default: '/opt/solr'
  • node['solr']['user']
    • User that owns the Solr process
    • Default: 'solr'
  • node['solr']['create_user']
    • Create the above user?
    • Default: true
  • node['solr']['group']
    • User Group that owns the Solr process
    • Default: 'solr'
  • node['solr']['create_group']
    • Create the above group?
    • Default: true
  • node['solr']['data_dir']
    • Solr Data Directory
    • Default: '/var/solr'
    • Note: a 'data' folder will be appended which will be the SOLR_HOME location

Configuation

General
  • node['solr']['host']
    • Host Name for this Solr instance
    • Default: The FQDN of the machine
  • node['solr']['port']
    • Solr port
    • Default: '8983'
  • node['solr']['timezone']
    • Solr Timezone
    • Default: 'UTC'
Solr Cloud
  • node['solr']['zk_host']
    • Zookeeper Host
    • Default: "" (Disabled)
  • node['solr']['zk_client_timeout']
    • The ZooKeeper client timeout
    • Default: '15000'
Performance
  • node['solr']['java_mem']

    • Amount of memory to allocate to Solr
    • Default: '-Xms512m -Xmx512m'
  • node['solr']['gc_tune']

    • Garbage collection settings
    • Defaults to installer provided settings (see attributes/install.rb)
Logging
  • node['solr']['gc_log_opts']
    • Logging options string
    • Defaults to verbose settings (see attributes/install.rb)
Monitoring
  • node['solr']['enable_remote_jmx_opts']
    • Activate the JMX RMI connector to allow remote JMX client applications to monitor the JVM hosting Solr; set to "false" to disable that behavior
    • Default: false (recommended in production environments)
  • node['solr']['rmi_port']
    • Specifies the port for the RMI connector
    • Default '18983'
    • Note: If node['solr']['enable_remote_jmx_opts'] is "false" then this line will be commented out
Security
  • node['solr']['solr_authentication_client_configurer']
    • Solr authentication client configurer
    • Default: "" (Disabled)
  • node['solr']['solr_authentication_opts']
    • Solr authentication options
    • Default: "" (Disabled)
SSL
  • node['solr']['solr_ssl_key_store']
    • Default: "" (Disabled)
  • node['solr']['solr_ssl_key_store_password']
    • Default: "" (Disabled)
  • node['solr']['solr_ssl_trust_store']
    • Default: "" (Disabled)
  • node['solr']['solr_ssl_trust_store_password']
    • Default: "" (Disabled)
  • node['solr']['solr_ssl_need_client_auth']
    • Default: "" (Disabled)
  • node['solr']['solr_ssl_want_client_auth']
    • Default: "" (Disabled)
  • node['solr']['solr_ssl_client_key_store']
    • Default: "" (Disabled)
  • node['solr']['solr_ssl_client_key_store_password']
    • Default: "" (Disabled)
  • node['solr']['solr_ssl_client_trust_store']
    • Default: "" (Disabled)
  • node['solr']['solr_ssl_client_trust_store_password']
    • Default: "" (Disabled)

Deploy

  • node['solr']['deploy_url']
    • URL from which a tarball can be downloaded containing Solr core(s)
    • Default: nil

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.

Supports

  • Ubuntu
  • CentOS
  • Red Hat
  • Amazon
  • Fedora

Java 8 is not currently installable on Debian with the Java community Chef recipe. Debian could be supported if Java 8 is installed manually.

Changelog

1.0.0 -> 1.0.1

  • Solr core files extracted with the deploy recipe now belong to the specified user. Previously the permissions were incorrect as all the files belonged to root.

0.2.0 -> 1.0.0

  • Breaking Change: Node boolean values were incorrectly being set and read as strings. Now all boolean node values are boolean types.
  • Two new attributes are available 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.
  • The default version of Solr installed was changed to '6.0.1'

Roadmap

v2.0 -- allow configuration of multiple instances through Chef Custom Resources

Contributing

Please see CONTRIBUTING for details.

Authors:: Nate Flood for ECHO Inc. < nflood@echonet.org >

License: MIT

Dependent cookbooks

yum >= 0.0.0
java >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

Collaborator Number Metric
            

1.0.1 failed this metric

Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric
            

1.0.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file

Foodcritic Metric
            

1.0.1 failed this metric

FC066: Ensure chef_version is set in metadata: solr_6/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric
            

1.0.1 passed this metric

Testing File Metric
            

1.0.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric
            

1.0.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number