Sample Linux Role for OpenSwitch OPX

This sample role facilitates the configuration of Quality Of Service(QOS) parameters using CPS API in OPX. The ansible-role-opx-qos role requires an SSH connection for connectivity to a Dell EMC OPX device.

Installation

ansible-galaxy install open-switch.opx-qos

Role Variables

• Role is abstracted using the ansible_net_os_name variable that needs the value "openswitch".
• Any role variable with a corresponding state variable set to absent negates the configuration of that variable
• Setting an empty value for any variable negates the corresponding configuration
• Variables and values are case-sensitive

ansible-role-opx-qos keys

NOTE: Asterisk (*) denotes the default value if none is specified.

Dependencies

The ansible-role-opx-qos role is built on modules included in the core Ansible code. These modules were added in Ansible version 2.4.0.

Example playbook

This example uses the open-switch.ansible-role-opx-qos role to setup QOS using CPS Generic module. It creates a hosts file with the switch details and corresponding variables. The hosts file should define the ansible_net_os_name variable "openswitch".

It writes a simple playbook that only references the ansible-role-opx-qos role. By including the role, you automatically get access to all of the tasks to configure QoS features.

Sample hosts file

leaf1 ansible_host= <ip_address> ansible_net_os_name="openswitch" ansible_ssh_user=<login> ansible_ssh_pass=<pwd>

Sample host_vars/leaf1

opx_qos:
  - operation: create
    qos_wred_attr_data:
      green-enable: 1
      green-min-threshold: 10
      green-max-threshold: 20
      green-drop-probability: 1
      yellow-enable: 1
      yellow-min-threshold: 10
      yellow-max-threshold: 20
      yellow-drop-probability: 3
      weight: 8
      ecn-enable: 1
      npu-id-list: [0]
    qos_scheduler:
      name: strict priority
      algorithm: 1
      weight: 2
      meter-type: 1
      min-rate: 256
      min-burst: 300
      max-rate: 1000
      max-burst: 1200
    qos_dscp_map_id:
      switch-id: 0
      name: dscp_map
    qos_dscp_map_entry:
      base-qos/dscp-to-tc-color-map/entry/tc: 0
      base-qos/dscp-to-tc-color-map/entry/color: 1
      base-qos/dscp-to-tc-color-map/entry/dscp: 40
    qos_tc_map_id:
      switch-id: 0
      name: dscp_map
    qos_tc_map_entry:
      base-qos/tc-color-to-dscp-map/entry/tc: 0
      base-qos/tc-color-to-dscp-map/entry/color: 1
      base-qos/tc-color-to-dscp-map/entry/dscp: 40
    qos_policer_meter:
      type: 1
      peak-rate: 10
      mode: 4
  - operation: set
    qos_queue_set_data:
      port-id: 17
      queue-number: 4
      type: 2
      buffer-profile-id: 4
    qos_queue_unset_data:
      port-id: 17
      queue-number: 4
      type: 2
      buffer-profile-id: 0
      wred-id: 0
    qos_ing_port:
      port-id: 16
    qos_egr_port:
      port-id: 17
  - operation: delete
    qos_wred_attr_data:

 

Simple playbook to setup system - leaf.yaml

- hosts: leaf1
  roles:
     - { role: open-switch.ansible-role-opx-qos, when: ansible_net_os_name is defined and ansible_net_os_name == "openswitch" }

Run

ansible-playbook -i hosts leaf.yaml

(c) 2018 Dell EMC