{"id":25690164,"url":"https://github.com/mweisel/cisco-catalyst-8kv-vagrant-libvirt","last_synced_at":"2026-06-13T04:31:16.504Z","repository":{"id":229240631,"uuid":"344943149","full_name":"mweisel/cisco-catalyst-8kv-vagrant-libvirt","owner":"mweisel","description":"A procedure for creating a Cisco Catalyst 8000V Vagrant box for the libvirt provider.","archived":false,"fork":false,"pushed_at":"2022-08-07T18:32:41.000Z","size":17,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-03-22T23:46:50.445Z","etag":null,"topics":["cisco-ios-xe","libvirt-provider","vagrant-box"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mweisel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2021-03-05T21:52:02.000Z","updated_at":"2024-03-22T23:46:52.964Z","dependencies_parsed_at":"2024-03-22T23:46:52.841Z","dependency_job_id":"b95ec36f-4cf7-4108-bdcc-9aa4e013e51f","html_url":"https://github.com/mweisel/cisco-catalyst-8kv-vagrant-libvirt","commit_stats":null,"previous_names":["mweisel/cisco-catalyst-8kv-vagrant-libvirt"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mweisel%2Fcisco-catalyst-8kv-vagrant-libvirt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mweisel%2Fcisco-catalyst-8kv-vagrant-libvirt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mweisel%2Fcisco-catalyst-8kv-vagrant-libvirt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mweisel%2Fcisco-catalyst-8kv-vagrant-libvirt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mweisel","download_url":"https://codeload.github.com/mweisel/cisco-catalyst-8kv-vagrant-libvirt/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240564597,"owners_count":19821422,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cisco-ios-xe","libvirt-provider","vagrant-box"],"created_at":"2025-02-24T22:16:35.223Z","updated_at":"2026-06-13T04:31:16.486Z","avatar_url":"https://github.com/mweisel.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Vagrant](https://img.shields.io/badge/vagrant%20-%231563FF.svg?\u0026style=for-the-badge\u0026logo=vagrant\u0026logoColor=white) ![netlab](https://img.shields.io/badge/netlab-d26400?style=for-the-badge)\n\n# Cisco Catalyst 8000V Vagrant box\n\nA procedure for creating a Cisco Catalyst 8000V Vagrant box for the [libvirt](https://libvirt.org) provider.\n\n## Prerequisites\n\n- [Cisco Modeling Labs](https://www.cisco.com/site/us/en/learn/training-certifications/training/modeling-labs) subscription\n- [Git](https://git-scm.com)\n- [uv](https://docs.astral.sh/uv)\n- [libvirt](https://libvirt.org) with client tools\n- [QEMU](https://www.qemu.org)\n- [Vagrant](https://developer.hashicorp.com/vagrant) \u003e= 2.4.0\n- [vagrant-libvirt](https://vagrant-libvirt.github.io/vagrant-libvirt)\n- [unzip](https://linux.die.net/man/1/unzip)\n- [Expect](https://en.wikipedia.org/wiki/Expect)\n- [Telnet](https://en.wikipedia.org/wiki/Telnet)\n\n## Steps\n\n0\\. Verify the prerequisite tools are installed.\n\n```\nwhich git uv unzip libvirtd virsh qemu-system-x86_64 expect telnet vagrant\n```\n\n```\nvagrant plugin list\n```\n\n1\\. Point your web browser to the [CML Software Download](https://software.cisco.com/download/home/286193282/type/286326381/release/2.9.0) page.\n\n2\\. Click the **Download** icon for the **Cisco Modeling Labs reference platform ISO file (June 2025)**.\n\n3\\. Save the `refplat-20250616-fcs-iso.zip` file to your **Downloads** folder.\n\n4\\. Open your favorite terminal emulator, and change to the `Downloads` directory.\n\n```\ncd ~/Downloads\n```\n\n5\\. Create the `cml29-refplat` directory.\n\n```\nmkdir -p cml29-refplat\n```\n\n6\\. Uncompress the `refplat-20250616-fcs-iso.zip` file into the `cml29-refplat`directory.\n\n```\nunzip refplat-20250616-fcs-iso.zip -d cml29-refplat\n```\n\n7\\. Change to the `cml29-refplat` directory.\n\n```\ncd cml29-refplat\n```\n\n8\\. Create a mount point directory.\n\n```\nsudo mkdir -p /mnt/iso\n```\n\n9\\. Mount the ISO file.\n\n```\nsudo mount -o loop refplat-20250616-fcs.iso /mnt/iso\n```\n\n10\\. Copy (and rename) the disk image file to the `/var/lib/libvirt/images` directory.\n\n```\nsudo cp /mnt/iso/virl-base-images/cat8000v-17-16-01a/c8000v-universalk9_8G_serial.17.16.01a.qcow2 /var/lib/libvirt/images/cisco-cat8kv.qcow2\n```\n\n11\\. Unmount the ISO file.\n\n```\nsudo umount /mnt/iso\n```\n\n12\\. Modify the file ownership.\n\n\u003e The owner and/or group will differ between Linux distributions.\n\n```\nsudo chown libvirt-qemu:libvirt-qemu /var/lib/libvirt/images/cisco-cat8kv.qcow2\n```\n\n13\\. Set the file as executable.\n\n```\nsudo chmod u+x /var/lib/libvirt/images/cisco-cat8kv.qcow2\n```\n\n14\\. Create the `boxes` directory.\n\n```\nmkdir -p ~/boxes\n```\n\n15\\. Start the `default` network (if not already started).\n\n```\nvirsh -c qemu:///system net-start default\n```\n\n16\\. Clone this GitHub repo and _cd_ into the directory.\n\n```\ngit clone https://github.com/mweisel/cisco-catalyst-8kv-vagrant-libvirt \u0026\u0026 cd cisco-catalyst-8kv-vagrant-libvirt\n```\n\n17\\. Create a Python virtual environment for Ansible.\n\n```\nuv sync\n```\n\n18\\. Run the Ansible playbook.\n\n```\nuv run ansible-playbook main.yml\n```\n\n19\\. Copy (and rename) the Vagrant box artifact to the `boxes` directory.\n\n```\ncp cisco-cat8kv.box ~/boxes/cisco-cat8000v-17.16.01a.box\n```\n\n20\\. Copy the box metadata file to the `boxes` directory.\n\n```\ncp ./files/cisco-cat8000v.json ~/boxes/\n```\n\n21\\. Change the current working directory to `boxes`.\n\n```\ncd ~/boxes\n```\n\n22\\. Substitute the `HOME` placeholder string in the box metadata file.\n\n```\nsed -i \"s|HOME|${HOME}|\" cisco-cat8000v.json\n```\n\n```\nawk '/url/{gsub(/^ */,\"\");print}' cisco-cat8000v.json\n```\n\noutput:\n\n\u003cpre\u003e\n\"url\": \"file://\u003cb\u003e/home/marc\u003c/b\u003e/boxes/cisco-cat8000v-17.16.01a.box\"\n\u003c/pre\u003e\n\n23\\. Add the Vagrant box to the local inventory.\n\n```\nvagrant box add cisco-cat8000v.json\n```\n\n## Debug\n\nTo view the telnet session output for the `expect` task:\n\n```\ntail -f ~/cat8kv-console.explog\n```\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmweisel%2Fcisco-catalyst-8kv-vagrant-libvirt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmweisel%2Fcisco-catalyst-8kv-vagrant-libvirt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmweisel%2Fcisco-catalyst-8kv-vagrant-libvirt/lists"}