cisco.ios.ios_ospfv3 – OSPFv3 resource module

Note

This plugin is part of the cisco.ios collection (version 1.3.0).

To install it use: ansible-galaxy collection install cisco.ios.

To use it in a playbook, specify: cisco.ios.ios_ospfv3.

New in version 1.1.0: of cisco.ios

Synopsis

  • This module configures and manages the Open Shortest Path First (OSPF) version 3 on IOS platforms.

Parameters

Parameter Choices/Defaults Comments
config
dictionary
A list of configurations for ospfv3.
processes
list / elements=dictionary
List of OSPF instance configurations.
address_family
list / elements=dictionary
Enter Address Family command mode
adjacency
dictionary
Control adjacency formation
disable
boolean
    Choices:
  • no
  • yes
Disable adjacency staggering
max_adjacency
integer
Maximum number of adjacencies allowed to be forming
Please refer vendor documentation for valid values
min_adjacency
integer
Initial number of adjacencies allowed to be forming in an area
Please refer vendor documentation for valid values
none
boolean
    Choices:
  • no
  • yes
No initial
afi
string
    Choices:
  • ipv4
  • ipv6
Enter Address Family command mode
areas
list / elements=dictionary
OSPF area parameters
area_id
string
OSPF area ID as a decimal value. Please refer vendor documentation of Valid values.
OSPF area ID in IP address format(e.g. A.B.C.D)
authentication
dictionary
Authentication parameters
key_chain
string
Use a key-chain for cryptographic authentication keys
null
boolean
    Choices:
  • no
  • yes
Use no authentication
default_cost
integer
Set the summary default-cost of a NSSA/stub area
Stub's advertised external route metric
Note, please refer vendor documentation for respective valid values
filter_list
list / elements=dictionary
Filter networks between OSPFv3 areas
direction
string / required
    Choices:
  • in
  • out
The direction to apply on the filter networks sent to and from this area.
name
string
Name of an IP prefix-list
normal
boolean
    Choices:
  • no
  • yes
Specify a normal area type
nssa
dictionary
Specify a NSSA area
default_information_originate
dictionary
Originate Type 7 default into NSSA area
metric
integer
OSPF default metric
metric_type
integer
    Choices:
  • 1
  • 2
OSPF metric type for default routes
OSPF Link State type
nssa_only
boolean
    Choices:
  • no
  • yes
Limit default advertisement to this NSSA area
no_redistribution
boolean
    Choices:
  • no
  • yes
No redistribution into this NSSA area
no_summary
boolean
    Choices:
  • no
  • yes
Do not send summary LSA into NSSA
set
boolean
    Choices:
  • no
  • yes
Enable a NSSA area
translate
string
    Choices:
  • always
  • suppress-fa
Translate LSA
Always translate LSAs on this ABR
Suppress forwarding address in translated LSAs
ranges
list / elements=dictionary
Summarize routes matching address/mask (border routers only)
address
string
IP address to match
advertise
boolean
    Choices:
  • no
  • yes
Advertise this range (default)
Since, advertise when enabled is not shown in running-config idempotency won't be maintained for the play in the second or next run of the play.
cost
integer
User specified metric for this range
netmask
string
IP mask for address
not_advertise
boolean
    Choices:
  • no
  • yes
DoNotAdvertise this range
sham_link
dictionary
Define a sham link and its parameters
authentication
dictionary
Authentication parameters
key_chain
string
Use a key-chain for cryptographic authentication keys
null
boolean
    Choices:
  • no
  • yes
Use no authentication
cost
integer
Associate a cost with the sham-link
Cost of the sham-link
destination
string
IPv6 address associated with sham-link destination (X:X:X:X::X)
source
string
IPv6 address associated with sham-link source (X:X:X:X::X)
ttl_security
integer
TTL security check
maximum number of hops allowed
stub
dictionary
Specify a stub area
Backbone can not be configured as stub area
no_summary
boolean
    Choices:
  • no
  • yes
Do not send summary LSA into stub area
set
boolean
    Choices:
  • no
  • yes
Enable a stub area
authentication
dictionary
Authentication parameters
Authentication operation mode
deployment
boolean
    Choices:
  • no
  • yes
Deployment mode of operation
normal
boolean
    Choices:
  • no
  • yes
Normal mode of operation
auto_cost
dictionary
Calculate OSPF interface cost according to bandwidth
reference_bandwidth
integer
Use reference bandwidth method to assign OSPF cost
Note, refer vendor documentation for respective valid values
set
boolean
    Choices:
  • no
  • yes
Enable OSPF auto-cost
bfd
dictionary
BFD configuration commands
all_interfaces
boolean
    Choices:
  • no
  • yes
Enable BFD on all interfaces
disable
boolean
    Choices:
  • no
  • yes
Disable BFD on all interfaces
capability
boolean
    Choices:
  • no
  • yes
Enable a specific feature
Do not perform PE specific checks
compatible
dictionary
OSPFv3 router compatibility list
rfc1583
boolean
    Choices:
  • no
  • yes
compatible with RFC 1583
rfc1587
boolean
    Choices:
  • no
  • yes
compatible with RFC 1587
rfc5243
boolean
    Choices:
  • no
  • yes
supports DBD exchange optimization
default_information
dictionary
Control distribution of default information
always
boolean
    Choices:
  • no
  • yes
Always advertise default route
metric
integer
OSPF default metric
Note, refer vendor documentation for respective valid values
metric_type
integer
OSPF metric type for default routes
Note, please refer vendor documentation for respective valid range
originate
boolean
    Choices:
  • no
  • yes
Distribute a default route
route_map
string
Route-map reference name
default_metric
integer
Set metric of redistributed routes
discard_route
dictionary
Enable or disable discard-route installation
external
boolean
    Choices:
  • no
  • yes
Discard route for summarised redistributed routes
internal
boolean
    Choices:
  • no
  • yes
Discard route for summarised inter-area routes
sham_link
boolean
    Choices:
  • no
  • yes
Discard route for sham-link routes
distance
integer
Define an administrative distance
Note, please refer vendor documentation for respective valid range
distribute_list
dictionary
Filter networks in routing updates
acls
list / elements=dictionary
IP access list
direction
string / required
    Choices:
  • in
  • out
Filter incoming and outgoing routing updates.
interface
string
Interface configuration (GigabitEthernet A/B)
Valid with incoming traffic
name
string / required
IP access list name/number
protocol
string
Protocol config (bgp 1).
Valid with outgoing traffic
prefix
dictionary
Filter prefixes in routing updates
direction
string / required
    Choices:
  • in
  • out
Filter incoming and outgoing routing updates.
gateway_name
string
Gateway name for filtering incoming updates based on gateway
interface
string
Interface configuration (GigabitEthernet A/B)
Valid with incoming traffic
name
string / required
Name of an IP prefix-list
protocol
string
Protocol config (bgp 1).
Valid with outgoing traffic
route_map
dictionary
Filter prefixes in routing updates
name
string / required
Route-map name
event_log
dictionary
Event Logging
enable
boolean
    Choices:
  • no
  • yes
Enable event Logging
one_shot
boolean
    Choices:
  • no
  • yes
Disable Logging When Log Buffer Becomes Full
pause
boolean
    Choices:
  • no
  • yes
Pause Event Logging
size
integer
Maximum Number of Events Stored in the Event Log
Note, refer vendor documentation for respective valid values
graceful_restart
dictionary
Graceful-restart options
helper support
disable
boolean
    Choices:
  • no
  • yes
disable helper support
enable
boolean
    Choices:
  • no
  • yes
helper support enabled
strict_lsa_checking
boolean
    Choices:
  • no
  • yes
enable helper strict LSA checking
interface_id
dictionary
Source of the interface ID
ios_if_index
boolean
    Choices:
  • no
  • yes
IOS interface number
snmp_if_index
boolean
    Choices:
  • no
  • yes
SNMP MIB ifIndex
limit
dictionary
Limit a specific OSPF feature
dc
dictionary
Demand circuit retransmissions
disable
boolean
    Choices:
  • no
  • yes
Disble the feature
number
integer
The maximum number of retransmissions
non_dc
dictionary
Non-demand-circuit retransmissions
disable
boolean
    Choices:
  • no
  • yes
Disble the feature
number
integer
The maximum number of retransmissions
local_rib_criteria
dictionary
Enable or disable usage of local RIB as route criteria
enable
boolean
    Choices:
  • no
  • yes
Enable usage of local RIB as route criteria
forwarding_address
boolean
    Choices:
  • no
  • yes
Local RIB used to validate external/NSSA forwarding addresses
inter_area_summary
boolean
    Choices:
  • no
  • yes
Local RIB used as criteria for inter-area summaries
nssa_translation
boolean
    Choices:
  • no
  • yes
Local RIB used as criteria for NSSA translation
log_adjacency_changes
dictionary
Log changes in adjacency state
detail
boolean
    Choices:
  • no
  • yes
Log all state changes
set
boolean
    Choices:
  • no
  • yes
Log changes in adjacency state
manet
dictionary
Specify MANET OSPF parameters
cache
dictionary
Specify MANET cache sizes
acknowledgement
integer
Specify MANET acknowledgement cache size
Maximum number of acknowledgements in cache
update
integer
Specify MANET LSA cache size
Maximum number of LSAs in cache
hello
dictionary
Unicast Hellos rather than multicast
multicast
boolean
    Choices:
  • no
  • yes
Multicast Hello requests and responses rather than unicast
unicast
boolean
    Choices:
  • no
  • yes
Unicast Hello requests and responses rather than multicast
peering
dictionary
MANET OSPF Smart Peering
disable
boolean
    Choices:
  • no
  • yes
Disable selective peering
per_interface
boolean
    Choices:
  • no
  • yes
Select peers per interface rather than per node
redundancy
integer
Redundant paths
Number of redundant OSPF paths
set
boolean
    Choices:
  • no
  • yes
Enable selective peering
willingness
integer
Specify and Relay willingness value
max_lsa
dictionary
Maximum number of non self-generated LSAs to accept
ignore_count
integer
Maximum number of times adjacencies can be suppressed
Note, refer vendor documentation for respective valid values
ignore_time
integer
Number of minutes during which all adjacencies are suppressed
Note, refer vendor documentation for respective valid values
number
integer
Maximum number of non self-generated LSAs to accept
Note, refer vendor documentation for respective valid values
reset_time
integer
Number of minutes after which ignore-count is reset to zero
Note, refer vendor documentation for respective valid values
threshold_value
integer
Threshold value (%) at which to generate a warning msg
Note, refer vendor documentation for respective valid values
warning_only
boolean
    Choices:
  • no
  • yes
Only give a warning message when limit is exceeded
max_metric
dictionary
Set maximum metric
Maximum metric in self-originated router-LSAs
disable
boolean
    Choices:
  • no
  • yes
disable maximum metric in self-originated router-LSAs
external_lsa
integer
Override external-lsa metric with max-metric value
Overriding metric in external-LSAs
Note, refer vendor documentation for respective valid values
inter_area_lsas
integer
Override inter-area-lsas metric with max-metric value
Overriding metric in inter-area-LSAs
Note, refer vendor documentation for respective valid values
on_startup
dictionary
Set maximum metric temporarily after reboot
time
integer
Time, in seconds, router-LSAs are originated with max-metric
Note, please refer vendor documentation for respective valid range
wait_for_bgp
boolean
    Choices:
  • no
  • yes
Let BGP decide when to originate router-LSA with normal metric
stub_prefix_lsa
boolean
    Choices:
  • no
  • yes
Set maximum metric for stub links in prefix LSAs
maximum_paths
integer
Forward packets over multiple paths
Number of paths
passive_interface
string
Suppress routing updates on an interface
prefix_suppression
dictionary
Prefix suppression
disable
boolean
    Choices:
  • no
  • yes
Disable prefix suppression
enable
boolean
    Choices:
  • no
  • yes
Enable prefix suppression
queue_depth
dictionary
Hello/Router process queue depth
hello
dictionary
OSPF Hello process queue depth
max_packets
integer
maximum number of packets in the queue
unlimited
boolean
    Choices:
  • no
  • yes
Unlimited queue depth
update
dictionary
OSPF Router process queue depth
max_packets
integer
maximum number of packets in the queue
unlimited
boolean
    Choices:
  • no
  • yes
Unlimited queue depth
router_id
string
Router-id address for this OSPF process
OSPF router-id in IP address format (A.B.C.D)
shutdown
dictionary
Shutdown the router process
disable
boolean
    Choices:
  • no
  • yes
Disable Shutdown
enable
boolean
    Choices:
  • no
  • yes
Shutdown the router process
summary_prefix
dictionary
Configure IP address summaries
address
string
IP summary address (A.B.C.D)
IP prefix <network>/<length> (A.B.C.D/nn)
mask
string
IP Summary mask
not_advertise
boolean
    Choices:
  • no
  • yes
Do not advertise or translate
nssa_only
boolean
    Choices:
  • no
  • yes
Limit summary to NSSA areas
tag
integer
Set tag
timers
dictionary
Adjust routing timers
lsa
integer
OSPF LSA timers, arrival timer
The minimum interval in milliseconds between accepting the same LSA
Note, refer vendor documentation for respective valid values
manet
dictionary
OSPF MANET timers
cache
dictionary
Specify MANET cache sizes
acknowledgement
integer
Specify MANET acknowledgement cache size
redundancy
integer
Specify MANET LSA cache size
hello
boolean
    Choices:
  • no
  • yes
Unicast Hellos rather than multicast
Unicast Hello requests and responses rather than multicast
peering
dictionary
MANET OSPF Smart Peering
per_interface
boolean
    Choices:
  • no
  • yes
Select peers per interface rather than per node
redundancy
integer
Redundant paths
Number of redundant OSPF paths
set
boolean
    Choices:
  • no
  • yes
Enable selective peering
willingness
integer
Specify and Relay willingness value
pacing
dictionary
OSPF pacing timers
flood
integer
OSPF flood pacing timer
The minimum interval in msec to pace limit flooding on interface
Note, refer vendor documentation for respective valid values
lsa_group
integer
OSPF LSA group pacing timer
Interval in sec between group of LSA being refreshed or maxaged
Note, refer vendor documentation for respective valid values
retransmission
integer
OSPF retransmission pacing timer
The minimum interval in msec between neighbor retransmissions
Note, refer vendor documentation for respective valid values
throttle
dictionary
OSPF throttle timers
lsa
dictionary
OSPF LSA throttle timers
first_delay
integer
Delay to generate first occurrence of LSA in milliseconds
Note, refer vendor documentation for respective valid values
max_delay
integer
Maximum delay between originating the same LSA in milliseconds
Note, refer vendor documentation for respective valid values
min_delay
integer
Minimum delay between originating the same LSA in milliseconds
Note, refer vendor documentation for respective valid values
spf
dictionary
OSPF SPF throttle timers - Delay between receiving a change to SPF calculation in milliseconds - Note, refer vendor documentation for respective valid values
between_delay
integer
Delay between first and second SPF calculation in milliseconds
Note, refer vendor documentation for respective valid values
max_delay
integer
Maximum wait time in milliseconds for SPF calculations
Note, refer vendor documentation for respective valid values
receive_delay
integer
Delay between receiving a change to SPF calculation in milliseconds
Note, refer vendor documentation for respective valid values
unicast
boolean
    Choices:
  • no
  • yes
Address Family modifier
vrf
string
Specify parameters for a VPN Routing/Forwarding instance
adjacency
dictionary
Control adjacency formation
max_adjacency
integer
Maximum number of adjacencies allowed to be forming
Please refer vendor documentation for valid values
min_adjacency
integer
Initial number of adjacencies allowed to be forming in an area
Please refer vendor documentation for valid values
none
boolean
    Choices:
  • no
  • yes
No initial
areas
list / elements=dictionary
OSPF area parameters
area_id
string
OSPF area ID as a decimal value. Please refer vendor documentation of Valid values.
OSPF area ID in IP address format(e.g. A.B.C.D)
authentication
dictionary
Authentication parameters
ipsec
dictionary
Use IPsec authentication
hex_string
string
SHA-1 key (40 chars)
md5
integer
Use MD5 authentication
sha1
integer
Use SHA-1 authentication
spi
integer
Set the SPI (Security Parameters Index)
key_chain
string
Use a key-chain for cryptographic authentication keys
default_cost
integer
Set the summary default-cost of a NSSA/stub area
Stub's advertised external route metric
Note, please refer vendor documentation for respective valid values
nssa
dictionary
Specify a NSSA area
default_information_originate
dictionary
Originate Type 7 default into NSSA area
metric
integer
OSPF default metric
metric_type
integer
    Choices:
  • 1
  • 2
OSPF metric type for default routes
OSPF Link State type
nssa_only
boolean
    Choices:
  • no
  • yes
Limit default advertisement to this NSSA area
no_redistribution
boolean
    Choices:
  • no
  • yes
No redistribution into this NSSA area
no_summary
boolean
    Choices:
  • no
  • yes
Do not send summary LSA into NSSA
set
boolean
    Choices:
  • no
  • yes
Enable a NSSA area
translate
string
    Choices:
  • always
  • suppress-fa
Translate LSA
Always translate LSAs on this ABR
Suppress forwarding address in translated LSAs
stub
dictionary
Specify a stub area
Backbone can not be configured as stub area
no_summary
boolean
    Choices:
  • no
  • yes
Do not send summary LSA into stub area
set
boolean
    Choices:
  • no
  • yes
Enable a stub area
authentication
boolean
    Choices:
  • no
  • yes
Authentication parameter mode
Deployment mode of operation
auto_cost
dictionary
Calculate OSPF interface cost according to bandwidth
reference_bandwidth
integer
Use reference bandwidth method to assign OSPF cost
Note, refer vendor documentation for respective valid values
set
boolean
    Choices:
  • no
  • yes
Enable OSPF auto-cost
bfd
boolean
    Choices:
  • no
  • yes
BFD configuration commands
Enable BFD on all interfaces
compatible
dictionary
OSPFv3 router compatibility list
rfc1583
boolean
    Choices:
  • no
  • yes
compatible with RFC 1583
rfc1587
boolean
    Choices:
  • no
  • yes
compatible with RFC 1587
rfc5243
boolean
    Choices:
  • no
  • yes
supports DBD exchange optimization
event_log
dictionary
Event Logging
enable
boolean
    Choices:
  • no
  • yes
Enable event Logging
one_shot
boolean
    Choices:
  • no
  • yes
Disable Logging When Log Buffer Becomes Full
pause
boolean
    Choices:
  • no
  • yes
Pause Event Logging
size
integer
Maximum Number of Events Stored in the Event Log
Note, refer vendor documentation for respective valid values
graceful_restart
dictionary
Graceful-restart options for helper support
disable
boolean
    Choices:
  • no
  • yes
disable helper support
strict_lsa_checking
boolean
    Choices:
  • no
  • yes
enable helper strict LSA checking
help
boolean
    Choices:
  • no
  • yes
Description of the interactive help system
interface_id
boolean
    Choices:
  • no
  • yes
Source of the interface ID
SNMP MIB ifIndex
limit
dictionary
Limit a specific OSPF feature and LS update, DBD, and LS request retransmissions
dc
dictionary
Demand circuit retransmissions
disable
boolean
    Choices:
  • no
  • yes
Disble the feature
number
integer
The maximum number of retransmissions
non_dc
dictionary
Non-demand-circuit retransmissions
disable
boolean
    Choices:
  • no
  • yes
Disble the feature
number
integer
The maximum number of retransmissions
local_rib_criteria
dictionary
Enable or disable usage of local RIB as route criteria
enable
boolean
    Choices:
  • no
  • yes
Enable usage of local RIB as route criteria
forwarding_address
boolean
    Choices:
  • no
  • yes
Local RIB used to validate external/NSSA forwarding addresses
inter_area_summary
boolean
    Choices:
  • no
  • yes
Local RIB used as criteria for inter-area summaries
nssa_translation
boolean
    Choices:
  • no
  • yes
Local RIB used as criteria for NSSA translation
log_adjacency_changes
dictionary
Log changes in adjacency state
detail
boolean
    Choices:
  • no
  • yes
Log all state changes
set
boolean
    Choices:
  • no
  • yes
Log changes in adjacency state
manet
dictionary
Specify MANET OSPF parameters
cache
dictionary
Specify MANET cache sizes
acknowledgement
integer
Specify MANET acknowledgement cache size
redundancy
integer
Specify MANET LSA cache size
hello
boolean
    Choices:
  • no
  • yes
Unicast Hellos rather than multicast
Unicast Hello requests and responses rather than multicast
peering
dictionary
MANET OSPF Smart Peering
per_interface
boolean
    Choices:
  • no
  • yes
Select peers per interface rather than per node
redundancy
integer
Redundant paths
Number of redundant OSPF paths
set
boolean
    Choices:
  • no
  • yes
Enable selective peering
willingness
integer
Specify and Relay willingness value
max_lsa
dictionary
Maximum number of non self-generated LSAs to accept
ignore_count
integer
Maximum number of times adjacencies can be suppressed
Note, refer vendor documentation for respective valid values
ignore_time
integer
Number of minutes during which all adjacencies are suppressed
Note, refer vendor documentation for respective valid values
number
integer
Maximum number of non self-generated LSAs to accept
Note, refer vendor documentation for respective valid values
reset_time
integer
Number of minutes after which ignore-count is reset to zero
Note, refer vendor documentation for respective valid values
threshold_value
integer
Threshold value (%) at which to generate a warning msg
Note, refer vendor documentation for respective valid values
warning_only
boolean
    Choices:
  • no
  • yes
Only give a warning message when limit is exceeded
max_metric
dictionary
Set maximum metric
external_lsa
integer
Override external-lsa metric with max-metric value
Overriding metric in external-LSAs
Note, refer vendor documentation for respective valid values
include_stub
boolean
    Choices:
  • no
  • yes
Set maximum metric for stub links in router-LSAs
on_startup
dictionary
Set maximum metric temporarily after reboot
time
integer
Time, in seconds, router-LSAs are originated with max-metric
Note, please refer vendor documentation for respective valid range
wait_for_bgp
boolean
    Choices:
  • no
  • yes
Let BGP decide when to originate router-LSA with normal metric
router_lsa
boolean / required
    Choices:
  • no
  • yes
Maximum metric in self-originated router-LSAs
summary_lsa
integer
Override summary-lsa metric with max-metric value
Note, please refer vendor documentation for respective valid range
passive_interface
string
Suppress routing updates on an interface
prefix_suppression
boolean
    Choices:
  • no
  • yes
Enable prefix suppression
process_id
integer / required
Process ID
queue_depth
dictionary
Hello/Router process queue depth
hello
dictionary
OSPF Hello process queue depth
max_packets
integer
maximum number of packets in the queue
unlimited
boolean
    Choices:
  • no
  • yes
Unlimited queue depth
router_id
string
Router-id address for this OSPF process
OSPF router-id in IP address format (A.B.C.D)
shutdown
boolean
    Choices:
  • no
  • yes
Shutdown the router process
timers
dictionary
Adjust routing timers
lsa
integer
OSPF LSA timers, arrival timer
The minimum interval in milliseconds between accepting the same LSA
Note, refer vendor documentation for respective valid values
manet
dictionary
OSPF MANET timers
cache
dictionary
Specify MANET cache sizes
acknowledgement
integer
Specify MANET acknowledgement cache size
redundancy
integer
Specify MANET LSA cache size
hello
boolean
    Choices:
  • no
  • yes
Unicast Hellos rather than multicast
Unicast Hello requests and responses rather than multicast
peering
dictionary
MANET OSPF Smart Peering
per_interface
boolean
    Choices:
  • no
  • yes
Select peers per interface rather than per node
redundancy
integer
Redundant paths
Number of redundant OSPF paths
set
boolean
    Choices:
  • no
  • yes
Enable selective peering
willingness
integer
Specify and Relay willingness value
pacing
dictionary
OSPF pacing timers
flood
integer
OSPF flood pacing timer
The minimum interval in msec to pace limit flooding on interface
Note, refer vendor documentation for respective valid values
lsa_group
integer
OSPF LSA group pacing timer
Interval in sec between group of LSA being refreshed or maxaged
Note, refer vendor documentation for respective valid values
retransmission
integer
OSPF retransmission pacing timer
The minimum interval in msec between neighbor retransmissions
Note, refer vendor documentation for respective valid values
throttle
dictionary
OSPF throttle timers
lsa
dictionary
OSPF LSA throttle timers
first_delay
integer
Delay to generate first occurrence of LSA in milliseconds
Note, refer vendor documentation for respective valid values
max_delay
integer
Maximum delay between originating the same LSA in milliseconds
Note, refer vendor documentation for respective valid values
min_delay
integer
Minimum delay between originating the same LSA in milliseconds
Note, refer vendor documentation for respective valid values
spf
dictionary
OSPF SPF throttle timers - Delay between receiving a change to SPF calculation in milliseconds - Note, refer vendor documentation for respective valid values
between_delay
integer
Delay between first and second SPF calculation in milliseconds
Note, refer vendor documentation for respective valid values
max_delay
integer
Maximum wait time in milliseconds for SPF calculations
Note, refer vendor documentation for respective valid values
receive_delay
integer
Delay between receiving a change to SPF calculation in milliseconds
Note, refer vendor documentation for respective valid values
running_config
string
This option is used only with state parsed.
The value of this option should be the output received from the IOS device by executing the command sh running-config | section ^router ospfv3.
The state parsed reads the configuration from running_config option and transforms it into Ansible structured data as per the resource module's argspec and the value is then returned in the parsed key within the result.
state
string
    Choices:
  • merged ←
  • replaced
  • overridden
  • deleted
  • gathered
  • parsed
  • rendered
The state the configuration should be left in
The states rendered, gathered and parsed does not perform any change on the device.
The state rendered will transform the configuration in config option to platform specific CLI commands which will be returned in the rendered key within the result. For state rendered active connection to remote host is not required.
The state gathered will fetch the running configuration from device and transform it into structured data in the format as per the resource module argspec and the value is returned in the gathered key within the result.
The state parsed reads the configuration from running_config option and transforms it into JSON format as per the resource module parameters and the value is returned in the parsed key within the result. The value of running_config option should be the same format as the output of command show running-config | include ip route|ipv6 route executed on device. For state parsed active connection to remote host is not required.

Notes

Note

  • Tested against Cisco IOSv Version 15.2 on VIRL.

Examples

# Using deleted

# Before state:
# -------------
#
# router-ios#sh running-config | section ^router ospfv3
# router ospfv3 1
#  max-metric router-lsa on-startup 110
#  area 10 nssa default-information-originate metric 10
#  !
#  address-family ipv4 unicast vrf blue
#   adjacency stagger 50 50
#   area 25 nssa default-information-originate metric 25 nssa-only
#  exit-address-family
# router ospfv3 200
#  max-metric router-lsa on-startup 100
#  auto-cost reference-bandwidth 4
#  !
#  address-family ipv4 unicast
#   adjacency stagger 200 200
#  exit-address-family

- name: Delete provided OSPF V3 processes
  cisco.ios.ios_ospfv3:
    config:
      processes:
      - process_id: 1
    state: deleted

# Commands Fired:
# ---------------
#
# "commands": [
#        "no router ospfv3 1"
#    ]

# After state:
# -------------
# router-ios#sh running-config | section ^router ospfv3
# router ospfv3 200
#  max-metric router-lsa on-startup 100
#  auto-cost reference-bandwidth 4
#  !
#  address-family ipv4 unicast
#   adjacency stagger 200 200
#  exit-address-family

# Using deleted without any config passed (NOTE: This will delete all OSPFV3 configuration from device)

# Before state:
# -------------
#
# router-ios#sh running-config | section ^router ospfv3
# router ospfv3 1
#  max-metric router-lsa on-startup 110
#  area 10 nssa default-information-originate metric 10
#  !
#  address-family ipv4 unicast vrf blue
#   adjacency stagger 50 50
#   area 25 nssa default-information-originate metric 25 nssa-only
#  exit-address-family
# router ospfv3 200
#  max-metric router-lsa on-startup 100
#  auto-cost reference-bandwidth 4
#  !
#  address-family ipv4 unicast
#   adjacency stagger 200 200
#  exit-address-family

- name: Delete all OSPF processes
  cisco.ios.ios_ospfv3:
    state: deleted

# Commands Fired:
# ---------------
#
# "commands": [
#        "no router ospfv3 200",
#        "no router ospfv3 1"
#    ]

# After state:
# -------------
# router-ios#sh running-config | section ^router ospfv3
# router-ios#

# Using merged

# Before state:
# -------------
#
# router-ios#sh running-config | section ^router ospfv3
# router-ios#

- name: Merge provided OSPFV3 configuration
  cisco.ios.ios_ospfv3:
    config:
      processes:
      - process_id: 1
        max_metric:
          router_lsa: true
          on_startup:
            time: 110
        address_family:
          - afi: ipv4
            unicast: true
            vrf: blue
            adjacency:
              min_adjacency: 50
              max_adjacency: 50
            areas:
              - area_id: 25
                nssa:
                  default_information_originate:
                    metric: 25
                    nssa_only: true
        areas:
          - area_id: "10"
            nssa:
              default_information_originate:
                metric: 10
        timers:
          throttle:
            lsa:
              first_delay: 12
              min_delay: 14
              max_delay: 16
      - process_id: 200
        address_family:
          - afi: ipv4
            unicast: true
            adjacency:
              min_adjacency: 200
              max_adjacency: 200
        max_metric:
          router_lsa: true
          on_startup:
            time: 100
        auto_cost:
          reference_bandwidth: 4
    state: merged

# Commands Fired:
# ---------------
#
#  "commands": [
#         "router ospfv3 1",
#         "max-metric router-lsa on-startup 110",
#         "area 10 nssa default-information-originate metric 10",
#         "address-family ipv4 unicast vrf blue",
#         "adjacency stagger 50 50",
#         "area 25 nssa default-information-originate metric 25 nssa-only",
#         "exit-address-family",
#         "router ospfv3 200",
#         "auto-cost reference-bandwidth 4",
#         "max-metric router-lsa on-startup 100",
#         "address-family ipv4 unicast",
#         "adjacency stagger 200 200",
#         "exit-address-family"
#     ]

# After state:
# -------------
#
# router-ios#sh running-config | section ^router ospfv3
# router ospfv3 1
#  max-metric router-lsa on-startup 110
#  area 10 nssa default-information-originate metric 10
#  !
#  address-family ipv4 unicast vrf blue
#   adjacency stagger 50 50
#   area 25 nssa default-information-originate metric 25 nssa-only
#  exit-address-family
# router ospfv3 200
#  max-metric router-lsa on-startup 100
#  auto-cost reference-bandwidth 4
#  !
#  address-family ipv4 unicast
#   adjacency stagger 200 200
#  exit-address-family

# Using overridden

# Before state:
# -------------
#
# router ospfv3 1
#  max-metric router-lsa on-startup 110
#  area 10 nssa default-information-originate metric 10
#  !
#  address-family ipv4 unicast vrf blue
#   adjacency stagger 50 50
#   area 25 nssa default-information-originate metric 25 nssa-only
#  exit-address-family
# router ospfv3 200
#  max-metric router-lsa on-startup 100
#  auto-cost reference-bandwidth 4
#  !
#  address-family ipv4 unicast
#   adjacency stagger 200 200
#  exit-address-family

- name: Override provided OSPFV3 configuration
  cisco.ios.ios_ospfv3:
    config:
      processes:
        - process_id: 200
          max_metric:
            router_lsa: true
            on_startup:
              time: 200
          address_family:
            - afi: ipv4
              unicast: true
              adjacency:
                min_adjacency: 50
                max_adjacency: 50
              areas:
                - area_id: 200
                  nssa:
                    default_information_originate:
                      metric: 200
                      nssa_only: true
          areas:
            - area_id: "10"
              nssa:
                default_information_originate:
                  metric: 10
    state: overridden

# Commands Fired:
# ---------------
#
# "commands": [
#         "no router ospfv3 1",
#         "router ospfv3 200",
#         "no auto-cost reference-bandwidth 4",
#         "max-metric router-lsa on-startup 200",
#         "area 10 nssa default-information-originate metric 10",
#         "address-family ipv4 unicast",
#         "adjacency stagger 50 50",
#         "area 200 nssa default-information-originate metric 200 nssa-only",
#         "exit-address-family"
#     ]

# After state:
# -------------
#
# router-ios#sh running-config | section ^router ospfv3
# router ospfv3 200
#  max-metric router-lsa on-startup 200
#  area 10 nssa default-information-originate metric 10
#  !
#  address-family ipv4 unicast
#   adjacency stagger 50 50
#   area 200 nssa default-information-originate metric 200 nssa-only
#  exit-address-family

# Using replaced

# Before state:
# -------------
#
# router-ios#sh running-config | section ^router ospfv3
# router ospfv3 1
#  max-metric router-lsa on-startup 110
#  area 10 nssa default-information-originate metric 10
#  !
#  address-family ipv4 unicast vrf blue
#   adjacency stagger 50 50
#   area 25 nssa default-information-originate metric 25 nssa-only
#  exit-address-family
# router ospfv3 200
#  max-metric router-lsa on-startup 100
#  auto-cost reference-bandwidth 4
#  !
#  address-family ipv4 unicast
#   adjacency stagger 200 200
#  exit-address-family

- name: Replaced provided OSPFV3 configuration
  cisco.ios.ios_ospfv3:
    config:
      processes:
        - process_id: 200
          max_metric:
            router_lsa: true
            on_startup:
              time: 200
          address_family:
            - afi: ipv4
              unicast: true
              adjacency:
                min_adjacency: 50
                max_adjacency: 50
              areas:
                - area_id: 200
                  nssa:
                    default_information_originate:
                      metric: 200
                      nssa_only: true
          areas:
            - area_id: "10"
              nssa:
                default_information_originate:
                  metric: 10
    state: replaced

# Commands Fired:
# ---------------
# "commands": [
#         "router ospfv3 200",
#         "no auto-cost reference-bandwidth 4",
#         "max-metric router-lsa on-startup 200",
#         "area 10 nssa default-information-originate metric 10",
#         "address-family ipv4 unicast",
#         "adjacency stagger 50 50",
#         "area 200 nssa default-information-originate metric 200 nssa-only",
#         "exit-address-family"
#     ]

# After state:
# -------------
# router-ios#sh running-config | section ^router ospfv3
# router ospfv3 1
#  max-metric router-lsa on-startup 110
#  area 10 nssa default-information-originate metric 10
#  !
#  address-family ipv4 unicast vrf blue
#   adjacency stagger 50 50
#   area 25 nssa default-information-originate metric 25 nssa-only
#  exit-address-family
# router ospfv3 200
#  max-metric router-lsa on-startup 200
#  area 10 nssa default-information-originate metric 10
#  !
#  address-family ipv4 unicast
#   adjacency stagger 50 50
#   area 200 nssa default-information-originate metric 200 nssa-only
#  exit-address-family

# Using Gathered

# Before state:
# -------------
#
# router-ios#sh running-config | section ^router ospfv3
# router ospfv3 1
#  max-metric router-lsa on-startup 110
#  area 10 nssa default-information-originate metric 10
#  !
#  address-family ipv4 unicast vrf blue
#   adjacency stagger 50 50
#   area 25 nssa default-information-originate metric 25 nssa-only
#  exit-address-family
# router ospfv3 200
#  max-metric router-lsa on-startup 100
#  auto-cost reference-bandwidth 4
#  !
#  address-family ipv4 unicast
#   adjacency stagger 200 200
#  exit-address-family

- name: Gather OSPFV3 provided configurations
  cisco.ios.ios_ospfv3:
    config:
    state: gathered

# Module Execution Result:
# ------------------------
#
# "gathered": {
#         "processes": [
#             {
#                 "address_family": [
#                     {
#                         "adjacency": {
#                             "max_adjacency": 50,
#                             "min_adjacency": 50
#                         },
#                         "afi": "ipv4",
#                         "areas": [
#                             {
#                                 "area_id": "25",
#                                 "nssa": {
#                                     "default_information_originate": {
#                                         "metric": 25,
#                                         "nssa_only": true
#                                     }
#                                 }
#                             }
#                         ],
#                         "unicast": true,
#                         "vrf": "blue"
#                     }
#                 ],
#                 "areas": [
#                     {
#                         "area_id": "10",
#                         "nssa": {
#                             "default_information_originate": {
#                                 "metric": 10
#                             }
#                         }
#                     }
#                 ],
#                 "max_metric": {
#                     "on_startup": {
#                         "time": 110
#                     },
#                     "router_lsa": true
#                 },
#                 "process_id": 1
#             },
#             {
#                 "address_family": [
#                     {
#                         "adjacency": {
#                             "max_adjacency": 200,
#                             "min_adjacency": 200
#                         },
#                         "afi": "ipv4",
#                         "unicast": true
#                     }
#                 ],
#                 "auto_cost": {
#                     "reference_bandwidth": 4
#                 },
#                 "max_metric": {
#                     "on_startup": {
#                         "time": 100
#                     },
#                     "router_lsa": true
#                 },
#                 "process_id": 200
#             }
#         ]
#     }

# After state:
# ------------
#
# router-ios#sh running-config | section ^router ospfv3
# router ospfv3 1
#  max-metric router-lsa on-startup 110
#  area 10 nssa default-information-originate metric 10
#  !
#  address-family ipv4 unicast vrf blue
#   adjacency stagger 50 50
#   area 25 nssa default-information-originate metric 25 nssa-only
#  exit-address-family
# router ospfv3 200
#  max-metric router-lsa on-startup 100
#  auto-cost reference-bandwidth 4
#  !
#  address-family ipv4 unicast
#   adjacency stagger 200 200
#  exit-address-family

# Using Rendered

- name: Render the commands for provided  configuration
  cisco.ios.ios_ospfv3:
    config:
      processes:
      - process_id: 1
        max_metric:
          router_lsa: true
          on_startup:
            time: 110
        address_family:
          - afi: ipv4
            unicast: true
            vrf: blue
            adjacency:
              min_adjacency: 50
              max_adjacency: 50
            areas:
              - area_id: 25
                nssa:
                  default_information_originate:
                    metric: 25
                    nssa_only: true
        areas:
          - area_id: "10"
            nssa:
              default_information_originate:
                metric: 10
        timers:
          throttle:
            lsa:
              first_delay: 12
              min_delay: 14
              max_delay: 16
      - process_id: 200
        address_family:
          - afi: ipv4
            unicast: true
            adjacency:
              min_adjacency: 200
              max_adjacency: 200
        max_metric:
          router_lsa: true
          on_startup:
            time: 100
        auto_cost:
          reference_bandwidth: 4
    state: rendered

# Module Execution Result:
# ------------------------
#
# "rendered": [
#         "router ospfv3 1",
#         "max-metric router-lsa on-startup 110",
#         "area 10 nssa default-information-originate metric 10",
#         "address-family ipv4 unicast vrf blue",
#         "adjacency stagger 50 50",
#         "area 25 nssa default-information-originate metric 25 nssa-only",
#         "exit-address-family",
#         "router ospfv3 200",
#         "auto-cost reference-bandwidth 4",
#         "max-metric router-lsa on-startup 100",
#         "address-family ipv4 unicast",
#         "adjacency stagger 200 200",
#         "exit-address-family"
#     ]

# Using Parsed

# File: parsed.cfg
# ----------------
#
# router ospfv3 1
#  max-metric router-lsa on-startup 110
#  area 10 nssa default-information-originate metric 10
#  !
#  address-family ipv4 unicast vrf blue
#   adjacency stagger 50 50
#   area 25 nssa default-information-originate metric 25 nssa-only
#  exit-address-family
# router ospfv3 200
#  max-metric router-lsa on-startup 100
#  auto-cost reference-bandwidth 4
#  !
#  address-family ipv4 unicast
#   adjacency stagger 200 200
#  exit-address-family

- name: Parse the provided configuration with the exisiting running configuration
  cisco.ios.ios_ospfv3:
    running_config: "{{ lookup('file', 'parsed.cfg') }}"
    state: parsed

# Module Execution Result:
# ------------------------
#
# "parsed": {
#         "processes": [
#             {
#                 "address_family": [
#                     {
#                         "adjacency": {
#                             "max_adjacency": 50,
#                             "min_adjacency": 50
#                         },
#                         "afi": "ipv4",
#                         "areas": [
#                             {
#                                 "area_id": "25",
#                                 "nssa": {
#                                     "default_information_originate": {
#                                         "metric": 25,
#                                         "nssa_only": true
#                                     }
#                                 }
#                             }
#                         ],
#                         "unicast": true,
#                         "vrf": "blue"
#                     }
#                 ],
#                 "areas": [
#                     {
#                         "area_id": "10",
#                         "nssa": {
#                             "default_information_originate": {
#                                 "metric": 10
#                             }
#                         }
#                     }
#                 ],
#                 "max_metric": {
#                     "on_startup": {
#                         "time": 110
#                     },
#                     "router_lsa": true
#                 },
#                 "process_id": 1
#             }
#         ]
#     }

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
after
dictionary
when changed
The resulting configuration model invocation.

Sample:
The configuration returned will always be in the same format of the parameters above.
before
dictionary
always
The configuration prior to the model invocation.

Sample:
The configuration returned will always be in the same format of the parameters above.
commands
list / elements=string
always
The set of commands pushed to the remote device.

Sample:
['router ospfv3 1', 'address-family ipv4 unicast vrf blue', 'adjacency stagger 50 50']


Authors

  • Sumit Jaiswal (@justjais)