Skip to end of metadata
Go to start of metadata
 

 

These directions explain installing chef-client or chef-solo on hosts that you would like to manage using Chef.


Chef Client is a Chef agent that runs on your nodes.
Chef-client connects to a Chef Server to be told what to do on the node.

Chef Solo is a standalone version of Chef that runs locally on your node, detached from a Chef server.
This means that all the information and Cookbooks required to configure the node have to be present on the local disk.


Both are shipped together and can be installed using the Operating System-specific directions listed below.

Omnibus Directions

Omnibus is a quick way to install Chef with an embedded version of Ruby, Rubygems, and other dependencies Chef needs. More information on it can be found on these pages:

Per Operating System Directions

The following are Operating System-specifc guides to installing Chef Client (or chef-solo) on a host. If your operating system is not listed, use the Other Operating Systems guide, which provides general instructions for install Chef using Rubygems as well as specific notes for various operating systems.

Dependencies

The following are the packages and gems required to install and run chef-client. The directions above handle the installation of all require dependencies. They are listed here for those wishing to install Chef via alternate means.

  • Ruby 1.8.7+ (with SSL bindings and development tools)
  • Rubygems 1.7.2+
  • ri
  • rdoc
  • gcc
  • gcc-c++
  • automake
  • autoconf
  • make

Gems written and provided by Opscode:

  • mixlib-authentication
  • mixlib-cli
  • mixlib-config
  • mixlib-log
  • ohai

External gems:

  • bunny
  • erubis
  • extlib
  • highline
  • json
  • moneta
  • rest-client
  • uuidtools

 

 

 

 

System Requirements

Chef-client is supported on the following platforms

  • Ubuntu (10.04+)
  • Debian (5.0, 6.0)
  • RHEL & CentOS (5.x, 6.x)
  • Fedora 10+
  • openSUSE (12.1+)
  • SLES 11 SP2
  • Solaris 9,10,11 Sparc
  • Solaris 10,11 (x86 and x64)
  • Mac OS X (10.4, 10.5, 10.6, 10.7)
  • Windows 7
  • Windows Server 2003 R2, 2008 R2

Additionally, chef-client is known to run on the following platforms

  • Ubuntu (6.06, 8.04-9.10)
  • RHEL & CentOS (5.x)
  • Gentoo (11.1,11.2)
  • FreeBSD (7.1)
  • OpenBSD (4.4)
  • OpenSolaris (2008.11)
  • Solaris 5.10 (u6)
  • Windows Vista

We will be installing (or updating) the following in this Installation Guide.

Ruby
Ruby 1.8.7, 1.9.1 or 1.9.2 with SSL bindings is required.

RubyGems
Version 1.6.2 or greater. On Ubuntu and Debian Rubygems should be installed from source.

Chef Client Version
Hosted Chef is compatible with chef-client v0.10.0 and greater. Older clients need to be upgraded before connecting.

 

 


Installing Chef Server

 


Upgrade Instructions

 

Labels
  • None