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


iscsi (4) Versions 0.0.6

Installs configures open-iscsi for storage arrays

cookbook 'iscsi', '= 0.0.6', :supermarket
cookbook 'iscsi', '= 0.0.6'
knife supermarket install iscsi
knife supermarket download iscsi
Quality -%

iSCSI Build Status


This cookbook provides provides the ability to configure Open-iSCSI for
Enterprise Linux based systems. The default attributes reflect original
research and recommendations gathered from Dell, Equallogic, and RedHat.

I have included a PDF of our own whitepaper discussing the configuration
and tuning of Open-iSCSI with this cookbook, as supplementary documentation.
Here is a list of recommended source documentation in addition to the
included PDF.


Required Cookbooks

  • multipath
  • el-sysctl
  • dbench



  • iscsi (namespace)
    • ["session"]["timeo"]["replacement_timeout"]: Time to wait before failing SCSI commands back to the application, default 15
    • ["conn0"]["timeo"]["noop_out_interval"]: Interval to wait before sending a ping, default 5
    • ["conn0"]["timeo"]["noop_out_timeout"]: Time to wait for a NOP-out before failing the connection, default 5
    • ["session"]["initial_login_retry_max"]: Initial number of login tries, default 12
    • ["session"]["cmds_max"]: How many commands the session will queue, default 1024
    • ["session"]["queue_depth"]: Device queue depth, default 128
    • ["session"]["iscsi"]["fastabort"]: IET targets need Yes, Equallogic needs set to No. Default is Yes

udev rules

  • iscsi (namespace)
    • ["interfaces"] Array of ethernet devices to apply ethtool options via udev. Default empty.
    • ["ethtool_opts"] Turn on or off, certain features on iSCSI ethernet devices. Default flow control on, autonegotiate off, Generic Recieve offload off


  • net (namespace)

    • ["ipv4"]["conf"]["all"]["arp_ignore"] Modes of ARP replies. Default 1, reply only if local IP address.
    • ["ipv4"]["conf"]["all"]["arp_announce"] Modes of ARP announcement. Default 2, use the best lcoal address.
    • ["ipv4"]["netfilter"]["ip_conntrack_tcp_be_liberal"] 1 Disables TCP window tracking, default 1
  • sysctl

    • ["has_iscsi"] Boolean to turn on iSCSI elements in sysctl recipe template, Default false


Default recipe

Set role specific overrides, and add recipe["iscsi"] to runlist

Example iSCSI role for an Equallogic storage array

name "iscsi"
description "Installs and configures Open-iSCSI for EQL. Installs dm-multipath.  Configures sysctl."
override_attributes "iscsi" => {
  "session" => {
    "iscsi" => {
      "fastabort" => "No"
"sysctl" => {
  "has_iscsi" => true
run_list "recipe[iscsi]", "recipe[el-sysctl]", "recipe[multipath]", "recipe[dbench]"

Example iSCSI role for an IET storage array

name "iscsi"
description "Installs and configures Open-iSCSI for IET. Installs dm-multipath.  Configures sysctl."
override_attributes "iscsi" => {
  "session" => {
    "iscsi" => {
      "fastabort" => "Yes"
"sysctl" => {
  "has_iscsi" => true
run_list "recipe[iscsi]", "recipe[el-sysctl]", "recipe[multipath]", "recipe[dbench]"

rescan-scsi-bus recipe

Simply include\_recipe "iscsi::rescan-scsi-bus" to drop off Kurt Garloff's
handy rescan-scsi-bus script. This has nothing to do with iSCSI, other than
it may come in handy to rescan the SCSI bus when you target a new LUN.

This recipe only drops off the script in /usr/local/bin, the recipe does not
execute anything.

License and Author

Copyright 2010-2012, Eric G. Wolfe

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.

Dependent cookbooks

multipath >= 0.0.0
el-sysctl >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

No quality metric results found