Building a Dell OS10 Vagrant Libvirt Box

Dell OS10 is supported by the netlab libvirt package command.

Warning

  • Dell provides the OS10 Virtual image as a set of vmdk and gns3a files to be used within GNS3. The following procedure will “convert” the required files for using them with Vagrant.

  • The ‌netlab libvirt package dellos10 command has been tested on Ubuntu and might not work on other Linux distros.

  • On Ubuntu 22.04 LTS, libvirt-qemu user needs read and execute access to the VM disk file. It’s easiest if you create Vagrant boxes in a subdirectory of the /tmp directory.

  • ‌virt-install might report a fatal error on Ubuntu 22.04. Execute export VIRTINSTALL_OSINFO_DISABLE_REQUIRE=1 in your shell and restart the build process.

To prepare for the build:

  • Download OS10 files into /tmp directory

  • Create an empty directory on a Ubuntu machine with libvirt and Vagrant.

  • Convert these vmdk files into qcow2 format with qemu-img utility:

    • OS10-Disk-1.0.0.vmdk

    • OS10-Installer-<VERSION>.vmdk

    • OS10-platform-<PLATFORM>-<VERSION>.vmdk

qemu-img convert -O qcow2 /tmp/OS10-Disk-1.0.0.vmdk OS10-Disk-1.qcow2
qemu-img convert -O qcow2 /tmp/OS10-Installer-10.5.3.4.108.vmdk hdb_OS10-installer.qcow2
qemu-img convert -O qcow2 /tmp/OS10-platform-S5224F-10.5.3.4.108.vmdk hdc_OS10-platform.qcow2

To build a Dell OS10 box based on the above install image:

  • Execute netlab libvirt package dellos10 OS10-Disk-1.qcow2 and follow the instructions

Initial Device Configuration

During the box-building process you’ll have to copy-paste initial device configuration. netlab libvirt config dellos10 command displays the build recipe:

Creating initial configuration for Dell OS10
=============================================

* Wait for the 'login' prompt, and then wait again some more minutes
* Login as 'admin' (password: 'admin')
* Disable zero-touch ('ztd cancel')
* Enter configuration mode ('configure')
* Copy-paste the following configuration

NOTE: the management traffic is isolated in a dedicated management VRF (management).

===============
*** WARNING ***
===============
To disable zero-touch (ZTD) a full reload is required after the first configuration.

=============================================
!
interface mgmt1/1/1
  no ip address dhcp
  no ipv6 address
  exit
!
ip vrf management
  interface management
  exit
!
interface mgmt1/1/1
  no shutdown
  ip address dhcp
  exit
!
service simple-password
username vagrant password vagrant role sysadmin priv-lvl 15
username vagrant sshkey "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA6NF8iallvQVp22WDkTkyrtvp9eWW6A8YVr+kz4TjGYe7gHzIw+niNltGEFHzD8+v1I2YJ6oXevct1YeS0o9HZyN1Q9qgCgzUFtdOKLv6IedplqoPkcmF0aYet2PkEDo3MlTBckFXPITAMzF8dJSIFo9D8HfdOV0IAdx4O7PtixWKn5y2hMNG0zQPyUecp4pzC6kivAIhyfHilFR61RGL+GPXQ2MWZWFYbAGjyiYJnAmCP3NOTd0jMZEnDkbUvxhMmBYSdETk1rRgm+R4LOzFUGaHqHDLKLX+FIPKcF96hrucXzcWyLbIbEgE98OHlnVYCzRdK8jlqm8tehUc9c9WhQ== vagrant insecure public key"
!
end
write memory
!
! reload cycle is required to disable ZTD
!
reload
!
=============================================

* Wait until the reload is completed
* Disconnect from console (ctrl-] usually works).