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

cisco-cookbook (7) Versions 1.2.1

Installs/Configures Cisco NX-OS devices

Policyfile
Berkshelf
Knife
cookbook 'cisco-cookbook', '~> 1.2.1', :supermarket
cookbook 'cisco-cookbook', '~> 1.2.1'
knife supermarket install cisco-cookbook
knife supermarket download cisco-cookbook
README
Dependencies
Changelog
Quality 17%

cisco-cookbook

Cookbook Release
Build Status

Documentation Workflow Map

This workflow map aids users, developers and maintainers of the cisco-cookbook project in selecting the appropriate document(s) for their task.

Please see Learning Resources for additional references.

--

Table of Contents

  1. Overview
  2. Cookbook Description
  3. Setup
  4. Usage
  5. Requirements
  6. Resource Reference
  7. Learning Resources

Overview

The cisco-cookbook allows a network administrator to manage Cisco Network Elements using Chef. This cookbook bundles a set of Chef Resources, providers, Sample Recipes and installation Tools for effective network management. The resources and capabilities provided by this cookbook will grow with contributions from Cisco, Chef Software Inc., and the open source community.

The Cisco Network Elements and Operating Systems managed by this cookbook are continuously expanding. Please refer to the Provider Support Across Platforms section for details on currently supported hardware and software. The Chef and Ruby Requirements section also provides details on compatible Chef client and Ruby versions.

This GitHub repository contains the latest version of the cisco-cookbook source code. Supported versions of the cisco-cookbook are available at Chef Supermarket. Please refer to SUPPORT for additional details.

Contributions to this cookbook are welcome. Guidelines on contributions to the cookbook are captured in CONTRIBUTING

Cookbook Description

This cookbook enables management of supported Cisco Network Elements using Chef. This cookbook enhances the Chef DSL by introducing new Chef Resources and Providers capable of managing network elements.

The set of supported network element platforms is continuously expanding. Please refer to the Provider Support Across Platforms section for an overview of currently supported platforms.

Setup

Chef Server

The cisco-cookbook is installed on the Chef server. Please see The Chef Server for information on Chef server setup. See Chef's knife cookbook site for general information on Chef cookbook installation.

Chef Client

The Chef Client (agent) requires installation and setup on each device. Agent setup can be performed as a manual process or it may be automated. For more information please see the README-agent-install document for detailed instructions on agent installation and configuration on Cisco Nexus devices.

Gems

The cisco-cookbook has dependencies on a few ruby gems. These gems are already installed in the cookbook as vendored gems so there are no additional steps required for installing these gems. The gems are shown here for reference only:

Usage

Place a dependency on cisco-cookbook in your cookbook's metadata.rb

depends 'cisco-cookbook', '~> 1.0'

See the recipes directory for example usage of cisco providers and resources.

Requirements

<a name="chef-ruby-requirements">Chef and Ruby Requirements</a>

  • Cisco NX-OS Chef implementation requires Chef version 12.6.0
  • Ruby 2.0 or higher (preferably from the Chef full-stack installer)

<a name="provider-platform-support">Provider Support Across Platforms</a>

A note about support for specific platform models:

Platform Models

Platform Description Environments
N9k Support includes all N9xxx models bash-shell, guestshell
N3k Support includes N30xx and N31xx models only.<br>The N35xx model is not supported. bash-shell, guestshell
N5k Support includes N56xx models only.<br>The N50xx and N55xx models are not supported at this time. Open Agent Container (OAC)
N6k Support includes all N6xxx models Open Agent Container (OAC)
N7k Support includes all N7xxx models Open Agent Container (OAC)
N9k-F Support includes all N95xx models running os version 7.0(3)Fx(x) bash-shell, guestshell

✅ = Supported

N9k N3k N5k N6k N7k N9k-F Caveats
cisco_command_config
cisco_interface ✅* ✅* Caveat
cisco_interface_ospf
cisco_ospf
cisco_ospf_vrf
cisco_snmp_community
cisco_snmp_group
cisco_snmp_server
cisco_snmp_user
cisco_tacacs_server
cisco_tacacs_server_host
cisco_vlan
cisco_vtp

Resource Reference

<a name="resource-by-tech">Resource Catalog (by Technology)</a>

--

<a name="resource-by-name">Resource Catalog (by Name)</a>

--

Resource Details

The following resources are listed alphabetically.

Type: cisco_command_config

Minimum Requirements N9k N3k N5k N6k N7k N9k-F
OS Image 7.0(3)I2(1) 7.0(3)I2(1) 7.3(0)N1(1) 7.3(0)N1(1) 7.3(0)D1(1) 7.0(3)F1(1)
Cisco Cookbook Version 1.0.1 1.0.1 1.1.0 1.1.0 1.1.0 1.2.0

The cisco_command_config resource allows raw configurations to be managed by chef. It serves as a stopgap until specialized resources are created. It has the following limitations:

  • The input message buffer is limited to 500KB. Large configurations are often easier to debug if broken up into multiple smaller resource blocks.
  • The cisco_command_config configuration block must use the same syntax as displayed by the show running-config command on the switch. In some cases, configuration commands that omit optional keywords when entered may actually appear with a different syntax when displayed by show running-config; for example, some access-list entries may be configured without a sequence number but yet an implicit sequence number is created regardless. This then creates an idempotency problem because there is a mismatch between show running-config and the manifest. The solution in this case is for the manifest to include explicit sequence numbers for the affected access-list entries.
  • Order is important. Some dependent commands may fail if their associated feature configuration is not enabled first
  • Indentation counts! It implies sub-mode configuration. Use the switch's running-config as a guide and do not indent configurations that are not normally indented. Do not use tabs to indent.
  • Inline comments must be prefixed by ! or #
  • Negating a submode will also remove configurations under that submode, without having to specify every submode config statement: no router ospf RED removes all configuration under router ospf RED
  • Syntax does not auto-complete: use Ethernet1/1, not Eth1/1
  • If a CLI command is rejected during configuration, the resource will abort at that point and will not continue to issue any remaining CLI. For this reason it is recommended to limit the scope of each instance of this resource.

Examples

cisco_command_config 'loop42' do
  command '
interface loopback42
  description Peering for AS 42
  ip address 192.168.1.42/24
'
end

cisco_command_config 'route42' do
  command ' ip route 192.168.42.42/32 Null0 '
end

Parameters

  • command - The sequence of configuration commands to apply.

Type: cisco_interface

The cisco_interface resource is used to manage general configuration of all
interface types, including ethernet, port-channel, loopback, and SVI (vlan).

Minimum Requirements N9k N3k N5k N6k N7k N9k-F
OS Image 7.0(3)I2(1) 7.0(3)I2(1) 7.3(0)N1(1) 7.3(0)N1(1) 7.3(0)D1(1) 7.0(3)F1(1)
Cisco Cookbook Version 1.0.1 1.0.1 1.1.0 1.1.0 1.1.0 1.2.0

<a name="cisco_interface-caveats">Caveats</a>

Property Caveat Description
svi_autostate Not supported on N56xx and N6k

Examples

cisco_interface 'Ethernet1/1' do
  action :create
  ipv4_address '10.1.1.1'
  ipv4_netmask_length 24
  ipv4_proxy_arp true
  ipv4_redirects true
  shutdown true
  switchport_mode 'disabled'
end

cisco_interface 'Ethernet1/2' do
  action :create
  access_vlan 100
  shutdown false
  switchport_mode 'access'
  switchport_vtp true
end

Parameters

Note that the setting of the switchport_mode parameter influences which of the
other parameters are permitted. Not all interface types support all of the below
parameters.

  • interface_name - The interface name, in lower case. Defaults to the
    resource name.

  • access_vlan - The access VLAN ID. Only valid with switchport_mode
    set to access or trunk.

  • description - Descriptive label for this interface.

  • encapsulation_dot1q - Enable IEEE 802.1Q encapsulation of traffic on a
    specified subinterface. Valid values are integer, keyword 'default'.

  • shutdown - Set to true to administratively shut down this interface,
    false to administratively enable this interface.

  • ipv4_address - IPv4 address to apply to this interface. Requires
    ipv4_netmask_length.

  • ipv4_netmask_length - Netmask length of this interface's IPv4 address.
    Must be a value between 0 and 32. Requires ipv4_address.

  • ipv4_proxy_arp - Set to true to enable Proxy ARP on this interface,
    false to disable Proxy ARP.

  • ipv4_redirects - Set to false to disable ICMP redirects on this interface,
    true to enable them.

  • mtu - Maximum Trasnmission Unit size for frames received and sent on the specified
    interface. Valid value is an integer.

  • negotiate_auto - Set to true or false to enable or disable
    autonegotiation of interface speed.

  • switchport_autostate_exclude - Set to true or false to exclude or
    include this interface from SVI calculations. Default value: false.

  • switchport_mode - Interface switchport mode. Available options (depending
    on interface type) are 'disabled', 'access', 'tunnel', 'fex_fabric',
    'trunk', 'default'. If set to 'default', the default mode for the interface
    type is used.

  • switchport_trunk_allowed_vlan - The allowed VLANs for the specified
    Ethernet interface. Valid values are string, keyword 'default'.

  • switchport_trunk_native_vlan - The Native VLAN assigned to the switch port.
    Valid values are integer, keyword 'default'

  • switchport_vtp - Set to true or false to enable or disable VTP on this
    interface. Default value: false.

  • svi_autostate - Enable/disable SVI autostate. Default value: true.
    Only applicable to SVI (vlan) interfaces.

  • svi_management - Enable/disable SVI management. Default value: false.
    Only applicable to SVI (vlan) interfaces.

  • vrf - Specify the vrf membership of this interface. Value must be a string.

Actions

  • :create - Creates and/or updates the interface configuration.

  • :destroy - Unconfigures and/or deletes the interface.

Note that logical interfaces (loopback, SVI, etc.) can be created/destroyed,
while physical interfaces (Ethernet, etc.) can only be configured/unconfigured.
The same actions apply regardless.

Type: cisco_interface_ospf

Minimum Requirements N9k N3k N5k N6k N7k N9k-F
OS Image 7.0(3)I2(1) 7.0(3)I2(1) 7.3(0)N1(1) 7.3(0)N1(1) 7.3(0)D1(1) 7.0(3)F1(1)
Cisco Cookbook Version 1.0.1 1.0.1 1.1.0 1.1.0 1.1.0 1.2.0

The cisco_interface_ospf resource is used to manage per-interface OSPF
configuration properties. More broadly applicable OSPF configuration is
managed by the cisco_ospf and cisco_ospf_vrf resources.

Examples

cisco_interface_ospf 'Ethernet1/2' do
  action :create
  ospf 'Sample'
  area 200
  cost 200
  dead_interval 200
  hello_interval 200
  message_digest true
  message_digest_encryption_type 'cisco_type_7'
  message_digest_algorithm_type 'md5'
  message_digest_key_id 7
  message_digest_password '088199c89d4a5ee'
  passive_interface true
end

Parameters

  • interface_name - The interface name, in lower case. Defaults to the
    resource name.

  • ospf - The OSPF process name. Required.

  • area - The OSPF area. Required.

  • cost - The OSPF link cost for this interface. Default is 0, meaning to
    calculate cost automatically.

  • dead_interval - The OSPF dead interval on this interface, in seconds.
    Default value: 40.

  • hello_interval - The OSPF hello interval on this interface, in seconds.
    Default value: 10.

  • message_digest - Enable or disable message-digest authentication on
    on the interface. Available options are true and false. Default value:
    false.

  • message_digest_algorithm_type - OSPF message digest algorithm.
    Default value: md5, which is currently the only supported value.

  • message_digest_encryption_type - Encryption type for the message digest
    password. Available options are 'cleartext', '3des', and 'cisco_type_7'.
    Default value: 'cleartext'.

  • message_digest_key_id - The key ID to use for message digest authentication.
    Valid values are numbers from 0 to 255, with 0 (the default value)
    indicating message digest authentication is disabled.

  • message_digest_password - The message digest key (password), in the format
    specified by message_digest_encryption.

  • passive_interface - Set to true or false to suppress or permit OSPF
    routing updates on this interface.

Actions

  • :create - Creates and/or updates the OSPF configuration on the interface.

  • :destroy - Removes all OSPF configuration on the interface.

Type: cisco_ospf

Minimum Requirements N9k N3k N5k N6k N7k N9k-F
OS Image 7.0(3)I2(1) 7.0(3)I2(1) 7.3(0)N1(1) 7.3(0)N1(1) 7.3(0)D1(1) 7.0(3)F1(1)
Cisco Cookbook Version 1.0.1 1.0.1 1.1.0 1.1.0 1.1.0 1.2.0

The cisco_ospf resource is used to enable/disable OSPF on the switch.
More detailed OSPF configuration is managed by the cisco_ospf_vrf and
cisco_interface_ospf resources.

Examples

cisco_ospf 'Sample' do
  action :create
end

Parameters

  • name - The name of the OSPF process. Defaults to the resource name.

Actions

  • :create - Enables the given OSPF process, first configuring feature ospf
    if necessary.

  • :destroy - Destroys the given OSPF process. If no OSPF configuration
    remains, will also disable feature ospf.

Type: cisco_ospf_vrf

Minimum Requirements N9k N3k N5k N6k N7k N9k-F
OS Image 7.0(3)I2(1) 7.0(3)I2(1) 7.3(0)N1(1) 7.3(0)N1(1) 7.3(0)D1(1) 7.0(3)F1(1)
Cisco Cookbook Version 1.0.1 1.0.1 1.1.0 1.1.0 1.1.0 1.2.0

The cisco_ospf_vrf resource is used to manage per-VRF OSPF configuration,
including the default VRF.

Examples

cisco_ospf_vrf 'dark_blue default' do
  auto_cost 45000
  default_metric 5
  log_adjacency 'detail'
  timer_throttle_lsa_start 5
  timer_throttle_lsa_hold  5500
  timer_throttle_lsa_max   5600
  timer_throttle_spf_start 250
  timer_throttle_spf_hold  1500
  timer_throttle_spf_max   5500
end

cisco_ospf_vrf 'dark_blue vrf1' do
  auto_cost 46000
  default_metric 10
  log_adjacency 'log'
  timer_throttle_lsa_start 8
  timer_throttle_lsa_hold  5600
  timer_throttle_lsa_max   5800
  timer_throttle_spf_start 277
  timer_throttle_spf_hold  1700
  timer_throttle_spf_max   5700
end

Parameters

  • ospf - Name of the parent OSPF process. Defaults to the first word of
    the resource name.

  • vrf - Name of the VRF to apply OSPF configuration to. Defaults to the
    second word of the resource name. A value of default refers to the default
    VRF.

  • auto_cost - The reference bandwidth, in Mbps, used to calculate interface
    default metrics. Default value: 40000.

  • default_metric - The default cost metric for redistributed routes.

  • log_adjacency - Whether to generate system log messages whenever a neighbor
    changes state. Available options are 'none', 'log', or 'detail'.
    Default value: 'none'.

  • router_id - IPv4 address to use as a router-id for OSPF.

  • timer_throttle_lsa_start - LSA generation start interval, in milliseconds.
    Default value: 0.

  • timer_throttle_lsa_hold - LSA generation hold interval, in milliseconds.
    Default value: 5000.

  • timer_throttle_lsa_max - LSA generation maximum interval, in milliseconds.
    Default value: 5000.

  • timer_throttle_spf_start - Initial SPF schedule delay, in milliseconds.
    Default value: 200.

  • timer_throttle_spf_hold - Minimum hold time between SPF calculations,
    in milliseconds. Default value: 1000.

  • timer_throttle_spf_max - Maximum wait time between SPF calculations, in
    milliseconds. Default value: 5000.

Actions

  • :create - Enables the given OSPF process for the given VRF.

  • :destroy - Removes the given VRF from the given OSPF process.

Type: cisco_package

Minimum Requirements N9k N3k N5k N6k N7k N9k-F
OS Image 7.0(3)I2(1) 7.0(3)I2(1) 7.3(0)N1(1) 7.3(0)N1(1) 7.3(0)D1(1) 7.0(3)F1(1)
Cisco Cookbook Version 1.0.1 1.0.1 1.1.0 1.1.0 1.1.0 1.2.0

The cisco_package resource is a subclass of the Chef yum_package resource.
Unlike yum_package, it will always install packages into the NX-OS native
environment, even if the Chef agent is running within guestshell.

Examples

cookbook_file '/bootflash/demo-one-1.0-1.x86_64.rpm' do
  owner 'root'
  group 'root'
  mode '0775'
  source 'rpm-store/demo-one-1.0-1.x86_64.rpm'
end

cisco_package 'demo-one' do
  action :install
  source '/bootflash/demo-one-1.0-1.x86_64.rpm'
end

Parameters

See https://docs.chef.io/resource_package.html

Actions

See https://docs.chef.io/resource_package.html

Type: cisco_snmp_community

Minimum Requirements N9k N3k N5k N6k N7k N9k-F
OS Image 7.0(3)I2(1) 7.0(3)I2(1) 7.3(0)N1(1) 7.3(0)N1(1) 7.3(0)D1(1) 7.0(3)F1(1)
Cisco Cookbook Version 1.0.1 1.0.1 1.1.0 1.1.0 1.1.0 1.2.0

The cisco_snmp_community resource is used to manage SNMP communities.

Examples

cisco_snmp_community 'setcom' do
  action :create
  acl 'testcomacl'
  group 'network-admin'
end

Parameters

  • community - Name of the SNMP community to manage. Defaults to the
    resource name.

  • acl - Access control list (ACL) to filter SNMP requests. Default value: '',
    indicating no ACL.

  • group - SNMP group name. Default value: network-operator.

Actions

  • :create - Create or update the given SNMP community.

  • :destroy - Destroy the given SNMP community.

Type: cisco_snmp_group

Minimum Requirements N9k N3k N5k N6k N7k N9k-F
OS Image 7.0(3)I2(1) 7.0(3)I2(1) 7.3(0)N1(1) 7.3(0)N1(1) 7.3(0)D1(1) 7.0(3)F1(1)
Cisco Cookbook Version 1.0.1 1.0.1 1.1.0 1.1.0 1.1.0 1.2.0

The cisco_snmp_group resource is used to manage SNMP groups. Cisco NX-OS
defines SNMP groups based on user roles, so this resource is unable to create
or delete groups but can only be used to validate that the group exists or not.

Examples

cisco_snmp_group 'network-admin' do
  action :create
end

Parameters

  • group - SNMP group name. Defaults to the resource name.

Actions

  • :create - Ensure that the given group exists, or raise an error if not.

  • :destroy - Ensure that the given group does not exist, or raise an error.

Type: cisco_snmp_server

Minimum Requirements N9k N3k N5k N6k N7k N9k-F
OS Image 7.0(3)I2(1) 7.0(3)I2(1) 7.3(0)N1(1) 7.3(0)N1(1) 7.3(0)D1(1) 7.0(3)F1(1)
Cisco Cookbook Version 1.0.1 1.0.1 1.1.0 1.1.0 1.1.0 1.2.0

The cisco_snmp_server resource is used to manage the SNMP server configuration
on a node. There can only be one instance of this resource per node.

Examples

cisco_snmp_server 'default' do
    aaa_user_cache_timeout 1000
    contact 'user1'
    global_enforce_priv true
    location 'rtp'
    packet_size 2500
    protocol false
    tcp_session_auth false
end

Parameters

  • name - Must be default.

  • aaa_user_cache_timeout - Time in seconds before entries in the AAA user
    cache time out. Default value: 3600.

  • contact - SNMP system contact (sysContact).

  • global_enforce_priv - Used to enable/disable SNMP message encryption for
    all users. Default value: true.

  • location - SNMP location (sysLocation).

  • packet_size - Maximum SNMP packet size. Default value: 1500.

  • protocol - Used to enable/disable the SNMP protocol. Default value: true.

  • tcp_session_auth - Used to enable/disable one-time authentication for SNMP
    over a TCP session. Default value: true.

Actions

  • :update - Apply changes to the SNMP server configuration as necessary.

Type: cisco_snmp_user

Minimum Requirements N9k N3k N5k N6k N7k N9k-F
OS Image 7.0(3)I2(1) 7.0(3)I2(1) 7.3(0)N1(1) 7.3(0)N1(1) 7.3(0)D1(1) 7.0(3)F1(1)
Cisco Cookbook Version 1.0.1 1.0.1 1.1.0 1.1.0 1.1.0 1.2.0

The cisco_snmp_user resource is used to manage SNMP user configuration.

Examples

cisco_snmp_user 'v3test' do
  groups ['network-admin']
end

cisco_snmp_user 'withengine 128:128:127:127:124:2' do
  auth_password 'Plus+Minus-'
  auth_protocol 'md5'
  groups ['network-admin']
  localized_key false
  priv_password 'Minus-Plus+'
  priv_protocol 'des'
end

Parameters

  • user - The username to manage. Defaults to the first word of the resource
    name.

  • engine_id - SNMP user engineID. Defaults to the second word of the resource
    name, if any, else ''. Valid values are '' or a string consisting of 5 to 32
    colon-separated decimal octets.

  • auth_password - User authentication password.

  • auth_protocol - Authentication protocol to use. Available options are
    'md5', 'sha', or 'none'. Default value: md5.

  • groups - Array of strings representing the SNMP group(s) that the user
    belongs to.

  • localized_key - Set to true if the auth_password and priv_password
    are in localized key format, false if they are in cleartext format.

  • priv_protocol - Privacy protocol to use. Available options are 'des'
    and 'aes128'. Default value: des.

  • priv_password - User privacy password.

Actions

  • :create - Create or update the given SNMP user.

  • :destroy - Destroy the given SNMP user.

Type: cisco_tacacs_server

Minimum Requirements N9k N3k N5k N6k N7k N9k-F
OS Image 7.0(3)I2(1) 7.0(3)I2(1) 7.3(0)N1(1) 7.3(0)N1(1) 7.3(0)D1(1) 7.0(3)F1(1)
Cisco Cookbook Version 1.0.1 1.0.1 1.1.0 1.1.0 1.1.0 1.2.0

The cisco_tacacs_server resource is used to manage global TACACS+ server
configuration. There can only be one instance of this resource per node.

Examples

cisco_tacacs_server 'default' do
  action :create
  deadtime 20
  directed_request true
  encryption_password 'test123'
  encryption_type 'clear'
  source_interface 'Ethernet1/2'
  timeout 10
end

Parameters

  • deadtime - TACACS+ server deadtime interval, in minutes.

  • directed_request - Set to true to permit users to specify which server to
    query. Default value: false.

  • encryption_password - Specifies the global TACACS+ server preshared key.

  • encryption_type - The encryption type for the encryption_password.
    Available values are 'clear', 'encrypted', or 'default'.

  • source_interface - Global source interface for all TACACS+ server groups.

  • timeout - Global timeout interval for TACACS+ servers, in seconds.
    Default value: 5.

Actions

  • :create - Enable feature tacacs+ and apply any specified configuration.

  • :update - Update existing TACACS+ configuration.

  • :destroy - Disable TACACS+.

Type: cisco_tacacs_server_host

Minimum Requirements N9k N3k N5k N6k N7k N9k-F
OS Image 7.0(3)I2(1) 7.0(3)I2(1) 7.3(0)N1(1) 7.3(0)N1(1) 7.3(0)D1(1) 7.0(3)F1(1)
Cisco Cookbook Version 1.0.1 1.0.1 1.1.0 1.1.0 1.1.0 1.2.0

The cisco_tacacs_server_host resource is used to manage per-host TACACS+
configuration.

Examples

cisco_tacacs_server_host 'testhost' do
  action :create
  encryption_password 'foobarpassword'
  encryption_type 'clear'
  port 66
  timeout 33
end

Parameters

  • name - The hostname to manage.

  • encryption_password - The preshared key for this host.

  • encryption_type - The encryption type for the encryption_password.
    Available values are 'clear', 'encrypted', or 'default'.

  • port - Server port for the host. Default value: 49.

  • timeout - Timeout interval for this host, in seconds. Default value: '0',
    indicating to inherit the global TACACS+ server timeout.

Actions

  • :create - Create/update configuration for this TACACS+ server host.

  • :destroy - Remove all configuration for this host.

Type: cisco_vlan

Minimum Requirements N9k N3k N5k N6k N7k N9k-F
OS Image 7.0(3)I2(1) 7.0(3)I2(1) 7.3(0)N1(1) 7.3(0)N1(1) 7.3(0)D1(1) 7.0(3)F1(1)
Cisco Cookbook Version 1.0.1 1.0.1 1.1.0 1.1.0 1.1.0 1.2.0

The cisco_vlan resource is used to manage VLAN configuration.

Examples

cisco_vlan '220' do
  action :create
  shutdown true
  state 'active'
  vlan_name 'newtest'
end

Parameters

  • name - The VLAN ID, in the range 1-4096. Some values are reserved and may
    not be managed by Chef.

  • shutdown - Whether the VLAN is shut down. Default value: false.

  • state - State of the VLAN. Accepted values are 'active' and 'suspend'.
    Default value: active.

  • vlan_name - Descriptive name for the VLAN.

Actions

  • :create - Create/update the specified VLAN.

  • :destroy - Delete the specified VLAN.

Type: cisco_vtp

Minimum Requirements N9k N3k N5k N6k N7k N9k-F
OS Image 7.0(3)I2(1) 7.0(3)I2(1) 7.3(0)N1(1) 7.3(0)N1(1) 7.3(0)D1(1) 7.0(3)F1(1)
Cisco Cookbook Version 1.0.1 1.0.1 1.2.0 1.2.0 1.1.0 1.2.0

The cisco_vtp resource is used to manage VLAN Trunking Protocol (VTP)
configuration. There can only be one instance of this resource per node.

Examples

cisco_vtp 'default' do
  action :create
  domain 'cisco1234'
  filename 'bootflash:/vlan.dat'
  password 'test1234'
  version 2
end

Parameters

  • domain - VTP administrative domain. Required.

  • filename - VTP file name. Default value: bootflash:/vlan.dat

  • password - VTP domain password.

  • version - VTP version number. Default value: 1.

Actions

  • :create - Enable feature vtp and apply VTP configuration as requested.

  • :destroy - Disable VTP.

--

Learning Resources

License

Copyright (c) 2014-2017 Cisco and/or its affiliates.

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

This cookbook has no specified dependencies.

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

Change Log

All notable changes to this project will be documented in this file.
This project adheres to Semantic Versioning.

1.2.1 - 2017-09-26

Added

  • Update the cisco_node_utils vendored gem to version 1.7.0.

Removed

  • grpc and google_protobuf vendored gems.

1.2.0 - 2017-04-04

Added

  • Enabled all providers on the N9k-F platform.
  • Enabled cisco_vtp support on N5k and N6k platforms.

1.1.2 - 2016-02-24

Added

  • Download link for Nexus 5000 and Nexus 6000 Open Agent Container (OAC).
  • OAC programmability guide links.

1.1.1 - 2016-02-16

Fixed

  • Update README-agent-install.md to reflect higher minimum memory requirement for guestshell
  • Update README-agent-install.md to include workaround for certificate problems in bash-shell

1.1.0 - 2016-02-12

Added

  • Extended cisco_interface (@robert-w-gries)
    • encapsulation dot1q
    • mtu
    • switchport trunk allowed vlan
    • switchport trunk native vlan
    • vrf member
  • Travis-CI integration, currently running Rubocop and Foodcritic validation (@glennmatthews)
  • Documentation workflow map to guide users, developers, and maintainers to the proper docs (@mikewiebe)
  • Doc updates for examples, templates, and install instructions (@chrisvanheuveln)
  • Test Kitchen integration (@adamleff, @edolnx)
  • Serverspec tests (@adamleff)
  • Added support for Chef 12.6.0 (@adamleff)
  • Updated documentation with platform support for providers and required software versions (@robert-w-gries)

Fixed

  • Code changes to satisfy Rubocop. (@glennmatthews)
  • Updated cisco ohai plugin to use correct load path for vendor gems (Alex Hunsberger)
  • Cleaned up demo recipes for N5k, N6k, and N7k platforms (@robert-w-gries)

1.0.1 - 2015-09-21

Fixed

  • Fixed broken documentation links.

1.0.0 - 2015-08-28

Added

  • Added README-maintainers.md

Fixed

  • Several cases where providers would log an error message on receiving invalid input but would not actually raise an exception.
  • Ospf router-id default processing.
  • Added dotted-decimal munging for area in resource_cisco_interface_ospf
  • Modified template placeholder names to meet lint reqs
  • cisco_interface_ospf fix for area property when Fixnum is used
  • cisco_ospf idempotency fix
  • Moved misc READMEs to /docs

[0.9.0] - 2015-06-22

Added

  • Initial release of cisco-cookbook for chef, supporting Cisco NX-OS software release 7.0(3)I2(1) on Cisco Nexus switch platforms: N95xx, N93xx, N30xx and N31xx.
  • Please note: 0.9.0 is an EFT pre-release for a limited audience with access to NX-OS 7.0(3)I2(1). Additional code changes may occur in 0.9.x prior to the final 1.0.0 release.

Collaborator Number Metric
            

1.2.1 passed this metric

Contributing File Metric
            

1.2.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.2.1 failed this metric

FC066: Ensure chef_version is set in metadata: cisco-cookbook/metadata.rb:1
FC069: Ensure standardized license defined in metadata: cisco-cookbook/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric
            

1.2.1 failed this metric

Failure: Cookbook should not contain binaries. Found:
cisco-cookbook/files/default/rpm-store/n9000_sample-1.0.0-7.0.3.x86_64.rpm
cisco-cookbook/files/default/rpm-store/demo-one-1.0-1.x86_64.rpm
cisco-cookbook/files/default/rpm-store/nxos.sample-n8k_EOR-1.0.0-7.0.3.F1.1.lib32_nxos.rpm
cisco-cookbook/files/default/rpm-store/CSCuxdublin-1.0.0-7.0.3.I3.1.lib32_n9000.rpm
cisco-cookbook/files/default/vendor/gems/cisco_node_utils-1.7.0/tests/n9000_sample-1.0.0-7.0.3.x86_64.rpm
cisco-cookbook/files/default/vendor/gems/cisco_node_utils-1.7.0/tests/CSCuxdublin-1.0.0-7.0.3.I3.1.lib32_n9000.rpm
cisco-cookbook/files/default/vendor/gems/cisco_node_utils-1.7.0/docs/agent_files.png
cisco-cookbook/files/default/vendor/cache/net_http_unix-0.2.1.gem
cisco-cookbook/files/default/vendor/cache/cisco_node_utils-1.7.0.gem

Testing File Metric
            

1.2.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.2.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