You're reading the development documentation. Release version of the same page is here.

Building an ArubaOS-CX Libvirt Box

Aruba AOS-CX 10 is supported by the netlab libvirt package command. To build it:

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

  • Download the Aruba_AOS-CX_Switch_Simulator (see below) OVA image into that directory, and uncompress it (and the OVA file - which is a tarball)

  • Convert the vmdk image to the qcow2 format (qemu-img convert -f vmdk -O qcow2 arubaoscx-disk-image-genericx86-p4-20221130174651.vmdk arubacx-10.11.qcow2)

  • Execute netlab libvirt package arubacx virtual-disk-file-name and follow the instructions

Warning

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

Aruba AOS-CX download notes

The Aruba AOS-CX 10 Switch Simulator image can be download from the Aruba Support Portal (after user registration), searching for: Aruba_AOS-CX_Switch_Simulator. In example, release 10.11.0001 can be downloaded from here.

Initial Device Configuration

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

Creating initial configuration for ArubaOS-CX
=============================================

* Wait for the 'login' prompt
* Login as 'admin' (no password)
* Set the new 'admin' password as 'admin'
* Copy-paste the following configuration

=============================================

configure
!
user netlab group administrators password plaintext netlab
user netlab authorized-key ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA6NF8iallvQVp22WDkTkyrtvp9eWW6A8YVr+kz4TjGYe7gHzIw+niNltGEFHzD8+v1I2YJ6oXevct1YeS0o9HZyN1Q9qgCgzUFtdOKLv6IedplqoPkcmF0aYet2PkEDo3MlTBckFXPITAMzF8dJSIFo9D8HfdOV0IAdx4O7PtixWKn5y2hMNG0zQPyUecp4pzC6kivAIhyfHilFR61RGL+GPXQ2MWZWFYbAGjyiYJnAmCP3NOTd0jMZEnDkbUvxhMmBYSdETk1rRgm+R4LOzFUGaHqHDLKLX+FIPKcF96hrucXzcWyLbIbEgE98OHlnVYCzRdK8jlqm8tehUc9c9WhQ==
!
ssh server vrf mgmt
https server vrf mgmt
!
interface mgmt
  no shutdown
  ip dhcp
!
ntp vrf mgmt
!
end
!
write memory
!
! reload cycle is required
!
boot system
!

=============================================

* After the reboot, check that the management interface is up (sometimes you may need to apply the config and reboot twice)
* Disconnect from console (ctrl-] usually works).
* Shutdown the VM, if needed

NOTE: It seems it’s not possible to create a user called vagrant on AOS-CX, so the configuration creates a netlab user (with password: netlab).

Ansible Galaxy for Aruba AOS-CX

You need to install the Ansible modules for Aruba AOS-CX with: ansible-galaxy collection install arubanetworks.aoscx.