How to add Cisco SDWAN images to eve-ng

Adding Cisco SDWAN images to Eve-ng lets you create a flexible lab environment for network testing and learning. Eve-ng is a popular tool for network professionals to practice and test different network setups. By adding Cisco SD-WAN Viptela images, you can simulate a real SD-WAN environment, perfect for study, certification practice, and testing before actual deployment.

Steps to Add Cisco SD-WAN ISE to Eve-ng

  1. Download Cisco SDWAN images.
  2. Create an image directory in Eve-ng.
  3. Upload the Cisco SDWAN images to Eve-ng.
  4. Fix the permissions.
  5. Add Cisco SD-WAN SDWAN nodes in Eve-ng via GUI.

1. Download Cisco SDWAN Images.

Images used and supported for this post.

EVE Image NameDownloaded FilenameVersionvCPUsvRAMInterfaces
vtbond-19.2.3viptela-edge-19.2.3-genericx86-64.qcow219.2.3110242
vtedge-19.2.3viptela-edge-19.2.3-genericx86-64.qcow219.2.3110245-8
vtsmart-19.2.3viptela-smart-19.2.3-genericx86-64.qcow219.2.3220482
vtmgmt-19.2.3viptela-vmanage-19.2.3-genericx86-64.qcow219.2.34163842

If you do not have access to the Cisco Website you can download the image from below alternate link.

Download

2. Create an Image directory in EVE-NG

To create image directories for Cisco SD-WAN Viptela in EVE-NG, SSH into EVE-NG and log in as root. Use the following commands to create the necessary directories:

1. Create an image directory for Cisco Viptela vBond

mkdir /opt/unetlab/addons/qemu/vtbond-19.2.3

2. create an image directory for Cisco Viptela vEdge

mkdir /opt/unetlab/addons/qemu/vtedge-19.2.3

3. create an image directory for Cisco Viptela vSmart

mkdir /opt/unetlab/addons/qemu/vtsmart-19.2.3

4. create image directory for Cisco Viptela vManage

mkdir /opt/unetlab/addons/qemu/vtmgmt-19.2.3

3. Upload the Cisco SDWAN images to Eve-ng.

Uploading Cisco Viptela images to EVE-NG is a crucial step for setting up a robust SD-WAN lab environment. This guide walks you through the process of connecting to your EVE-NG server using FileZilla or WinSCP, navigating to the appropriate directories, and uploading the necessary image files. By following these steps, you can ensure your Viptela images are correctly installed and ready for network emulation and testing.

Upload the downloaded image to the EVE using, for example, FileZilla or WinSCP.

To upload Cisco Viptela images to EVE-NG, follow these steps:

  1. Open FileZilla: Launch FileZilla on your computer.
  2. Connect to the EVE-NG Server:
    • In FileZilla, enter the EVE-NG server’s IP address in the “Host” field.
    • Enter your EVE-NG server’s username (typically root) and password.
    • Click “Quickconnect” to establish the connection.
  3. Navigate to the Image Directory:
    • In the “Remote site” section of FileZilla, navigate to the directory path /opt/unetlab/addons/qemu/.
    • This directory contains the subdirectories where the images will be uploaded.
  4. Open the Viptela Image Directory:
    • Within the /opt/unetlab/addons/qemu/ directory, locate and open the directory corresponding to the Viptela image you are uploading (e.g., vtbond-19.2.3, vtedge-19.2.3, vtsmart-19.2.3, or vtmgmt-19.2.3).
  5. Upload the Images:
    • In the “Local site” section of FileZilla, navigate to the location on your computer where the downloaded Viptela images are stored.
    • Select the relevant image file (e.g., viptela-edge-19.2.3-genericx86-64.qcow2).
    • Drag and drop the selected image file(s) from the “Local site” to the appropriate directory in the “Remote site” (e.g., vtedge-19.2.3).
  6. Repeat for Other Images:
    • Repeat the upload process for each Viptela image file, ensuring each one is placed in its corresponding directory (e.g., vBond images go into /opt/unetlab/addons/qemu/vtbond-19.2.3).

4. Fixing the permission

After uploading the Cisco SDWAN images to EVE-NG, it is essential to fix the file permissions to ensure the images function correctly within the environment. This step involves running a specific command on the EVE-NG server to set the appropriate permissions for the uploaded files.

  1. SSH into EVE-NG Server:
    • Use an SSH client (such as PuTTY) to connect to your EVE-NG server.
    • Log in as the root user.
  2. Run the Fix Permissions Command:
    • Execute the following command to fix the permissions for the uploaded images:

      /opt/unetlab/wrappers/unl_wrapper -a fixpermissions
  3. Verify the Permissions:
    • Ensure the command runs successfully without errors.

5. Adding Cisco SD-WAN Viptela Nodes in EVE-NG via GUI

Adding Cisco SD-WAN Viptela nodes in EVE-NG allows you to create and manage a virtual SD-WAN environment for testing and learning purposes. This guide outlines the steps to add and configure Viptela nodes such as vBond, vEdge, vSmart, and vManage within the EVE-NG graphical user interface (GUI). By following these steps, you can easily set up a comprehensive SD-WAN lab environment for network emulation and practice.

To add Cisco SD-WAN Viptela nodes in EVE-NG using the GUI, follow these steps:
  1. Open EVE-NG Web Interface:
    • Launch your web browser and navigate to the EVE-NG web interface.
    • Log in with your EVE-NG credentials.
  2. Create a New Lab:
    • Click on “Lab” from the top menu and select “New Lab.”
    • Fill in the lab details (name, description, etc.) and click “Save.”
  3. Add a Node:
    • Click on the “Add an Object” button (plus icon) on the toolbar.
    • Select “Node” from the dropdown menu.
  4. Select Cisco SD-WAN Viptela Node:
    • In the “Add a new node” window, scroll through the list of available node types and select the appropriate Cisco Viptela node type (e.g., vBond, vEdge, vSmart, or vManage).
  5. Configure Node Settings:
    • In the configuration window, set the node name, select the desired image version from the dropdown, and adjust other parameters like RAM and CPU if needed.
    • Click “Save” to add the node to the lab.
  6. Start Nodes:
    • Once all nodes are added and connected, click on the “Start” button (play icon) on the toolbar to power on the nodes.

Leave a Comment