devops-israel / chef-sphinxsearch

Chef cookbook to install Sphinx, the open source search server.

sphinxsearch Cookbook

This cookbook installs Sphinx, the open-source search server, available from sphinxsearch.com. This cookbook allows to install sphinx from a package or compile it from source, optionally with libstemmer and mysql/postgresql.

Requirements

Tested on Ubuntu 10.04/12.04 and CentOS 6.3.

packages

• build-essentials - required to compile sphinx from source
• mysql - required for sphinxsearch::source when use_mysql=true
• postgresql - required for sphinxsearch::source when use_postgres=true
• yum - required for sphinxsearch::package on RHEL unless yum_repo_include=nil

Attributes

sphinxsearch::default

Key	Type	Description	Default
sphinxsearch/install_method	String	install from `package` or compile from `source`	package
sphinxsearch/yum_repo_include	String or Nil	include_recipe for a yum repository before installing the package, use `nil` to not include any recipes	yum::epel

sphinxsearch::source

Key	Type	Description	Default
sphinxsearch/source/version	String	sphinx version	2.0.7-release
sphinxsearch/source/install_path	String	installation prefix	/opt/sphinxsearch-{version}
sphinxsearch/source/archive	String	name of tarball to download	sphinx-{version}.tar.gz
sphinxsearch/source/checksum	String	checksum of tarball	{checksum}
sphinxsearch/source/url	String	url to download tarball from	http://sphinxsearch.com/files/{archive}
sphinxsearch/source/stemmer_archive	String	name of libstemmer tarball	libstemmer_c.tgz
sphinxsearch/source/stemmer_checksum	String	checksum of libstemmer tarball	{checksum}
sphinxsearch/source/stemmer_url	String	url to download libstemmer tarball	http://snowball.tartarus.org/dist/{stemmer_archive}
sphinxsearch/source/use_mysql	Boolean	compile sphinx with mysql (requires mysql cookbook)	true
sphinxsearch/source/use_postgres	Boolean	compile sphinx with postgresql (requires postgresql cookbook)	false
sphinxsearch/source/use_stemmer	Boolean	compile sphinx with libstemmer	false

Usage

sphinxsearch::default

Just include sphinxsearch in your node's run_list, optionally change attributes:

{
  "name":"my_node",
  "normal": {
    "sphinxsearch": {
        "install_method": "source"
    }
  },
  "run_list": [
    "recipe[sphinxsearch]"
  ]
}

Contributing

This cookbook is still a work in progress, you are welcome to help by contributing fixes, documentation and tests.

e.g.

1. Fork the repository on Github
2. Create a named feature branch (like add_component_x)
3. Write you change
4. Write tests for your change (if applicable)
5. Run the tests, ensuring they all pass
6. Submit a Pull Request using Github

License and Authors

License

See LICENSE for full details.

Authors:

• Evgeny Zislis [e-mail]