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

RSS

iscsi (4) Versions 1.0.0

Installs configures open-iscsi for storage arrays

Berkshelf/Librarian
Policyfile
Knife
cookbook 'iscsi', '~> 1.0.0'
cookbook 'iscsi', '~> 1.0.0', :supermarket
knife cookbook site install iscsi
knife cookbook site download iscsi
README
Dependencies
Quality 44%

iSCSI Cookbook

Build Status

Description

This cookbook 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.

Here is a link to my own whitepaper in blog form, 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 linked blog post.

  • Red Hat KB 2877
  • Dell PowerEdge Systems Red Hat Enterprise Linux 5.4 Install Notes (dead link)
  • Red Hat Linux v5.x Software iSCSI Initiator Configuration and tuning Guide (dead link)
  • Open-iSCSI documentation

Requirements

Required Cookbooks

  • multipath
  • sysctl
  • dbench

Attributes

iscsid.conf

  • 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

  • iscsi.udev (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.
    • [reload_command'] platform version specific command to reload udev rules.

sysctl.params

  • sysctl.params.net.ipv4 (namespace)
    • ['conf']['all']['arp_ignore'] Modes of ARP replies. Default 1, reply only if local IP address.
    • ['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 on RHEL5.

Usage

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'
  }
},
run_list 'recipe[iscsi]', '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'
  }
},
run_list 'recipe[iscsi]', '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

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Dependent cookbooks

sysctl >= 0.0.0
multipath >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

Collaborator Number Metric
            

1.0.0 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.0 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.0 failed this metric

FC064: Ensure issues_url is set in metadata: iscsi/metadata.rb:1
FC065: Ensure source_url is set in metadata: iscsi/metadata.rb:1
FC066: Ensure chef_version is set in metadata: iscsi/metadata.rb:1
FC069: Ensure standardized license defined in metadata: iscsi/metadata.rb:1
Run with Foodcritic Version 12.2.1 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

License Metric
            

1.0.0 passed this metric

No Binaries Metric
            

1.0.0 passed this metric

Publish Metric
            

1.0.0 passed this metric

Supported Platforms Metric
            

1.0.0 passed this metric

Testing File Metric
            

1.0.0 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.0 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