KVM (for Kernel-based Virtual Machine) is a full virtualization solution for Linux on x86 hardware containing virtualization extensions (Intel VT or AMD-V).   VoIP Detective supports installation on Linux KVM, using a qcow2 image.  



Virtual Machine requirements:

  • 500GB of disk space (thin provisioning is supported)
  • 16GB of memory
  • VoIP Detective Free requires internet access (it will need to reach *.voipdetective.com).  More information



Preparing the virtual machine and license

  1. Go to www.voipdetective,com and click on "Install VoIP Detective Now" in the upper right corner.
  2. You'll be prompted to create an account.  You will the be forwarded to the licensing page
  3. Generate a license and make note of it.
  4. Download the VoIP Detective - Linux KVM virtual machine
  5. Unzip the file to your local computer.


Deploy the virtual machine with cockpit.

Using a GUI like cockpit will make deploying this virtual machine much easier.  You will need to upload the disk image (voip_detective_disk_image.qcow2) as well as the xml file (voip-detective.xml).  

Assign the virtual machine 16GB of memory, as well as 2 vCPU.



Deploy the virtual machine from the command line:


1. Unzip the .zip file you've downloaded from VoIPDetective.com

2. Upload the file voip_detective_disk_image.qcow2 to your Linux KVM server, placing it in the folder: /var/lib/libvirt/images/ 

3. From the command prompt of your Linux KVM server, issue the following command.

sudo virt-install \
--name VoIP_Detective-KVM5.6 \
--memory 16384 \
--vcpus 2 \
--cpu host-passthrough \
--machine q35 \
--os-variant almalinux9 \
--import \
--disk path=/var/lib/libvirt/images/voip_detective_disk_image.qcow2,format=qcow2 \
--disk device=cdrom,bus=sata \
--network type=direct,source=eno2,source_mode=bridge,model=virtio \
--noautoconsole

Explanation:
--name = name of the VM
--memory and --vcpus = set resources
--disk = path to your .qcow2 file
--import = don't install OS, just use the existing disk

--disk device=cdrom,bus=sata  = create a CD Rom
--network = directly connected to the network. Change as needed.
--noautoconsole = prevents auto-connecting to console

Make sure your .qcow2 file is placed in /var/lib/libvirt/images/, or adjust the path accordingly.


4. Please allow several minutes after the first boot for the VM to start.  It is not unusual for the VM to enter GRUB on the first boot - the VM should reboot and begin operating normally within 10 minutes.



Once the VM has been imported :


5. Find the IP address assigned to the VM, either through LinuxKVM, or by logging into the VM using the username cliadmin.   Default passwords can be found here

6. (OPTIONAL) Assigning a static IP address to VoIP Detective.  Please see this article

7. If you plan on accessing VoIP Detective via a DNS address (instead of an IP address) then set a hostname in the VoIP Detective CLI.  Please see this article.

8. Use your web browser to go to the address of VoIP Detective - you can find the IP of VoIP Detective by using LinuxKVM Copilot, or by logging into the VM command line with the username cliadmin and password of voip.  Full list of default passwords can be found here.

9. Step through the installer in your browser.  This will provide the system with a minimum configuration, and get you up and running.

10. Login to VoIP Detective's web interface as admin - The default username is 'admin' and the default password is 'voip'. Full list of default passwords can be found here.


If you will be using CUCM with VoIP Detective:

  1. Point CDRs from your CUCM to VoIP Detective - Please go here to learn how to configure CDRs in CUCM.
  2. Login to VoIP Detective's web interface as admin - The default username is 'admin' and the default password is 'voip'. Full list of default passwords can be found here.


If you will be using Webex with VoIP Detective:

Use the following guide to finalize configuration of VoIP Detective's Webex Call Reporting : Webex Reporting



*Important Note - VoIP Detective is not designed to be internet facing (accessible directly from the internet).  Please ensure that VoIP Detective is not reachable from the internet, or in your organization's DMZ.



If you have any questions, please click on the "New Support Ticket" button above.