Deploying the IP Fabric Virtual Machine (VM)

All virtual appliance images are available at  https://releases.ipfabric.io/ipfabric/#current. Access is restricted to registered customers only. Please contact our sales representative if you are interested in a trial of IP Fabric.

Deploying on VMware OVA Virtual Machine

1. Deploy OVA to your vSphere environment as described at Deploy an OVF or OVA Template.
2. Edit VM settings and adjust according to your network size as described in the operational requirements section.
   1. Change CPU count.
   2. Change memory size.
   3. Add a new empty virtual disk or resize the main system disk
3. Power on VM and complete Boot Wizard.

Deploying on Hyper-V Virtual Machine

The QCOW2 disk image file can be converted to different formats. Using this method we will create a VHDX usable on Microsoft Hyper-V and manually create a new VM.

1. Download ipfabric-*.qcow2 from the official source.
2. Convert QCOW2 image to VHDX (Be sure to change the filenames in the command examples below.)
   • Windows instructions:
     1. Download qemu-img-windows
     2. Unzip qemu-img-windows
     3. Run qemu-img.exe convert ipfabric-<*>.qcow2 -O vhdx -o subformat=dynamic ipfabric-<*>.vhdx
   • Linux instructions:
     1. Install qemu-utils sudo apt install qemu-utils
     2. Convert file: qemu-img convert -f qcow2 -o subformat=dynamic -O vhdx ipfabric-<*>.qcow2 ipfabric-<*>.vhdx

3. Create New Hyper-V Virtual Machine and Specify Name and Location

   

4. Specify Generation as Generation 1

   

5. Assign Memory (check requirements in operational requirements section)

   

6. Configure Networking

   

7. Connect the Virtual Hard Disk

   

8. Verify the Summary and Finish

   

9. Wait for the VM to be created

10. Edit the VM CPU settings (check requirements in operational requirements section)

    

    

11. Optionally increase Hard Disk Size based on operational requirements section 1. Extend the system disk or add a new empty virtual disk if necessary.

12. Close the VM Settings window

13. Start the VM.

Deploying a Virtual Machine to Nutanix

1. Download the ipfabric-*-.OVA file from official source.

2. Extract the previously downloaded OVA file using 7-zip or any similar software. The structure of extracted files should look like below

   

3. Import .vmdk files to Nutanix hypervisor and follow Nutanix' official documentation – Nutanix import OVA and Quick tip how to deploy a VM from OVF to AHV.

4. Edit VM hardware settings and adjust according to the network environment size (check requirements in operational requirements section).

   1. Change CPU count
   2. Change memory size
   3. Extend the system disk or add a new empty virtual disk if necessary.

5. Start the VM and check if the system starts without any interrupts.

Deploying a Virtual Machine on KVM

We have currently the limitation that drives need to be /dev/sdx. Usually Linux hypervisors are using the virtio-blk driver which is represented as /dev/vdx in the guest system. To overcome this limitation use the virtio-scsi as drive controller.

1. Download qcow2 system disk to your KVM hypervisor.

2. Resize the qcow2 data-disk that corresponds to your network needs if necessary. Use the following command:

   qemu-img resize ipfabric-disk1.qcow2 100G # (up to 1000G for 20 000 devices)
   

3. Deploy the VM to your hypervisor with the virt-install utility by issuing the following command (chose CPU and RAM size according to the size of your network):

   virt-install --name=IP_Fabric --disk path=<path to the disk>.qcow2 --graphics spice --vcpu=4 --ram=16384 --network bridge=virbr0 --import
   

4. This command deploys a new virtual machine with IP_Fabric name, system qcow2 disk, 4 CPU cores, 16GB of RAM and will connect VM to the internet through the virtbr0 interface (if your machine has a different bridge interface name or you want to connect it straight through the device network card to the internet you need to change the --network parameter).

5. This command also starts up the VM.

6. Additionally, you can create and add a new empty virtual disk if needed.

Complete (first-time) Boot Wizard

The First Boot Wizard starts when IP Fabric is run for the first time and configures system options. The wizard can also be re-run later from the service interface to modify basic system parameters.

1. Assign hostname.
2. Assign domain name.
3. Choose IP address acquisition method.
4. If a static method is used, configure IP address, netmask, default GW, and DNS servers.
5. Configure NTP servers or just click OK to continue if not using NTP.
6. Select time zone.
7. Configure Internet Proxy if used.
8. Set shell user password of osadmin user. The password is used to access the IP Fabric administrative interface and system shell (not for the GUI access, the GUI is accessible with the admin username by default, for more information, please, read: Access User Interface and Install License and also for encrypting system backups.
9. Optionally define organization parameters for the local SSL certificate.
10. After rebooting, the console login screen will display the assigned IP address of the system and provide a link to access the user interface.