Optional Configuration Modules

Network topology could refer to additional configuration modules that can be used to deploy routing protocols or network services in addition to initial device configuration.

Module-specific parameters can be added to:

  • Nodes, links or interfaces1

  • Topology (global node settings)

  • defaults element in the topology, topology defaults, or global defaults.

  • Default devices settings2

Notes:

  • Global module parameters will be merged with node-specific parameters (see merging default values for details).

  • Link-level module parameters will be merged with interface data.

  • Select node-level parameters (example: OSPF area) are merged into interface data.

  • Further processing of module-specific data is module-dependent.

Specifying Configuration Modules

  • The default configuration modules used in a network topology are specified in module top-level element, for example:

module: [ ospf ]
  • The global list of configuration modules is inherited by all nodes in the network topology. You could change per-node list of configuration modules with the node-specific module element.

Example

Given the following topology…

module: [ ospf ]
nodes:
- name: c_nxos
  device: nxos
  module: [ ospf, bgp ]
- name: c_csr
  device: csr
- name: j_vsrx
  device: vsrx
  module: []

… OSPF and BGP will be configured on c_nxos, OSPF will be configured on c_csr and no extra configuration will be performed on j_vsrx.

Using Modules when Deploying Device Configurations

During the initial device configuration, the netlab initial command generates and deploys configuration snippets for every module specified on individual network devices.

Notes:

  • The configuration snippets are created from templates in the netsim/ansible/templates/module directory.

  • The device-specific template is selected based on netlab_device_type or ansible_network_os value. For example, netsim/ansible/templates/ospf/eos.j2 will be used to create OSPF configuration for an Arista EOS device. More details in Deploying Device Configurations.

For module-specific information, see list of configuration modules

Merging Default Values

Module parameters are dictionaries of values stored under the module-name key in defaults, topology, node, link, or interface. The only exception to this rule: you can disable a few protocols (example: BFD) on an interface, with module: False configuration setting.

Node module parameters are adjusted based on topology parameters and default settings (more details):

  • For every node, the topology-level settings for modules used by that node are merged with the node-level settings.

  • Node settings are further adjusted with device-specific settings and global system defaults

  • Final node-level settings are saved into expanded topology file or Ansible inventory, and used by configuration templates.

Link module parameters are not changed during the topology expansion. They are merged with interface data when individual interfaces are created during the topology transformation process. Interface module settings are later augmented with module-specific subset of node data (example: OSPF area).

Finally, for every module used in network topology, the system default module parameters are merged with topology-level settings (example: setting ospf.area to 0.0.0.0 if it wasn’t defined in the lab topology).

Example

The module parameter defaults will be illustrated with the following OSPF+BGP topology. The topology uses defaults element for simplicity reasons; you could specify the same parameters in topology- or global defaults.

defaults:
  device: iosv
  ospf:
    area: 0.0.0.0
    process: 2
  bgp:
    as: 65000

module: [ ospf ]
ospf:
  process: 1

nodes:
  r1:
    ospf:
      router_id: 10.0.0.17
      area: 0.0.0.1
  r2:
    module: [ bgp,bfd ]

Before the merge process starts, the global list of modules is augmented with node-specific modules, resulting in:

module: [ ospf,bgp,bfd ]

For every module used in network topology, the default values are added to global parameter values, resulting in:

ospf:
  area: 0.0.0.0
  process: 1
bgp:
  as: 65000

Notes:

  • OSPF area is taken from defaults;

  • OSPF process ID is specified as a global parameter and is not overwritten with a default value;

  • Even though there was no global BGP setting, it’s copied from the defaults.

Finally, the global settings are merged with node settings, resulting in:

nodes:
  r1:
    ospf:
      area: 0.0.0.1
      router_id: 10.0.0.17
      process: 1
  r2:
    bgp:
      as: 65000

Notes:

  • OSPF area was specified for R1, and is not replaced.

  • OSPF process ID was not specified for R1. It’s copied from the global OSPF parameters.

  • OSPF router ID was specified for R1, but not in global parameters. It’s not changed.

  • R2 had no BGP parameters. BGP parameters were copied from global BGP parameters.


1

Node data within a link dictionary

2

For the brave souls only. Probably best left alone.