evenger 2023.1.11

Create EVE-NG network topology with EVE-NG API and excel file

Evenger

Create EVE-NG network topology with EVE-NG API and excel file.

---

Requirements

Python >= 3.9

For Windows, select the Add Python 3.x to PATH checkbox during installation.

---

Installation

pip install evenger

---

Usage (API)

# import Evenger
from evenger import Evenger

# define Evenger object
evenger_lab = Evenger(
    eveng_server_url='http://172.18.18.18',
    username='admin',
    password='eve',
    lab_path='my_lab_folder/my_lab'
)

# add NEW lab
evenger_lab.add_lab()

# add bridge (network) to topology
evenger_lab.add_network(
    name='Bridge_INTERNAL',
    type='bridge',
    left='200',
    top='200'
)

# add node nokia sros
nokia_sros_cpm_node_dict = {
    'image': 'timoscpm-21.10.R6',
    'name': '7750_test_1',
    'management_address': '10.1.1.102/24',
    'timos_line': 'slot=A chassis=SR-12 card=cpm5',
    'timos_license': 'ftp://172.18.18.18/sros_vSIM_R21_license_file.txt',
    'left': '500',
    'top': '200'
}
evenger_lab.add_node_sros_cpm(**nokia_sros_cpm_node_dict)

# add linux server
centos7_node_dict = {
    'image': 'linux-centos7',
    'name': 'centos7_server',
    'cpu': '1',
    'ram': '1024',
    'left': '700',
    'top': '700'
}
evenger_lab.add_node_linux(**centos7_node_dict)

# add any custom node with eve-ng node json data (e.g. Cisco XRv 9000)
cisco_xrv_json_text='''
{
  "template": "xrv",
  "type": "qemu",
  "count": "1",
  "image": "xrv-k9-6.0.1",
  "name": "xrv_custom_node",
  "icon": "XR.png",
  "uuid": "",
  "cpulimit": "undefined",
  "cpu": "1",
  "ram": "3072",
  "ethernet": "4",
  "qemu_version": "",
  "qemu_arch": "",
  "qemu_nic": "",
  "qemu_options": "-machine type=pc,accel=kvm,usb=off -serial mon:stdio -nographic -no-user-config -nodefaults -rtc base=utc,driftfix=slew -global kvm-pit.lost_tick_policy=discard -no-hpet -realtime mlock=off -no-shutdown -boot order=c",
  "ro_qemu_options": "-machine type=pc,accel=kvm,usb=off -serial mon:stdio -nographic -no-user-config -nodefaults -rtc base=utc,driftfix=slew -global kvm-pit.lost_tick_policy=discard -no-hpet -realtime mlock=off -no-shutdown -boot order=c",
  "config": "0",
  "delay": "0",
  "console": "telnet",
  "left": "200",
  "top": "800",
  "postfix": 0
}
'''
evenger_lab.add_node_custom(custom_json_text=cisco_xrv_json_text)

# add bridge/network (type: bridge)
network_dict = {
    'name': 'Bridge_Internal',
    'type': 'bridge',
    'left': '500',
    'top': '500'
}
evenger_lab.add_network(**network_dict)

# add cloud bridge/network (e.g. type: pnet0)
network_dict_cloud = {
    'name': 'Bridge_Management',
    'type': 'pnet0',
    'left': '500',
    'top': '500'
}
evenger_lab.add_network(**network_dict_cloud)

---

Before create any connection, all bridge and node should be already created. Do not add any node after connection.

---

# connect node to bridge/network
evenger_lab.connect_node_to_bridge(
    node_name='7750_test_1',
    node_port='1/1/1',
    bridge_name='Bridge_Internal'
)

# connect node to node
evenger_lab.connect_node_to_node(
    first_node='7750_test_1',
    first_port='1/1/1',
    second_node='7750_test_2',
    second_port='1/1/2'
)

---

Usage (Node Configuration with Telnet)

• Create config folder in current working directory e.g. my_config_folder.

• Create txt file with eve-ng node name e.g. 7750_test_1.txt in config folder (node must be booted completely and supported eve-ng telnet).

• Add cli configuration to node text file with <_EXPECT: expected-string> which depends on node cli. Below example for Nokia SROS:

  _EXPECT: ogin
  admin
  _EXPECT: assword
  admin
  _EXPECT: #
  configure
      system
          name "7750_test_1_system_name"
      exit
  exit
  logout
  

• After add node configs to config folder (my_config_folder/7750_test_1.txt, my_config_folder/7750_test_2.txt etc.) run below python code:

  # send configuration with telnet for eve-ng telnet supported node
  evenger_lab.config_with_telnet(config_folder=my_config_folder)
  

---

Usage (Create Topology with Excel File)

Check examples/evenger_topology.xlsx excel file in project repo. "_LAB_INFO" sheet must be filled for eve-ng access and other sheets are same as API functions use regarding eve-ng topology.

# create topology with excel file
evenger_lab.excel_topology(
    excel_filename=evenger_topology.xlsx,
    auto_start=auto_start
)

# create topology with excel and telnet configuration
evenger_lab.excel_topology(
    excel_filename=evenger_topology.xlsx,
    auto_start=auto_start,
    config_folder=my_config_folder,
    node_boot_time=150
)