KVM troubleshooting guide

How to check if AIM is running

# ps aux | grep abiquo-aim
root      1503  0.0  1.9 267388  9684 ?        Ss   Mar06   5:20 /usr/sbin/abiquo-aim --config-file /etc/abiquo-aim.ini -d

No hypervisor responding

The Abiquo platform uses AIM (Abiquo Infrastructure Management) to communicate with the KVM hypervisor. If Abiquo cannot communicate with AIM, Abiquo will give the following error message:

NC-4 There is a machine running at the given IP but no hypervisor is responding

Check your network connectivity and firewalls. See ConfigureFirewallandServices and #Default Ports

Also check that you have configured the basic AIM parameters as described below.

NFS Repository file not found

If you receive the following message when adding the KVM to Abiquo, it may mean that the NFS Repository Server is not mounted.

/opt/vm_repository/.abiquo_repository file not found. Make sure the Abiquo NFS Repository is mounted in /opt/vm_repository

Mount the repository from the NFS Server as described below.

How to mount the Abiquo NFS repository on the KVM host

The NFS repository should be automatically mounted by the install script, but if there are any problems during the install, you can mount it manually.

  1. Edit the FSTAB (# vi /etc/fstab) on the KVM hosts. Add this line with your IP address:

    10.56.121.48:/opt/vm_repository /opt/vm_repository  nfs defaults    0 0
    
  2. Then mount the volume using:

    # mount 10.56.121.48:/opt/vm_repository
    
  3. Check that it is mounted:

    # mount 
    
  4. Check for a line like the following:

    10.81.2.48:/opt/vm_repository on /opt/vm_repository type nfs (rw,addr= 10.56.121.48)
    
  5. Then restart the abiquo-aim service:

    # service abiquo-aim restart 
    
  6. Now try adding the KVM host in Abiquo again.

Default Ports

By default the KVM host:

  • Has Abiquo AIM listening at TCP port 8889 for Abiquo Remote Services communications.
  • Has the Libvirt Daemon listening at TCP port 16509 for Abiquo Remote Services communications.
  • Communicates with the Redis server on TCP port 6379.

See Ports and Communications for detailed information

Loading AIM Configuration File

By default the KVM host:

  • loads the abiquo-aim.ini configuration file (/etc/abiquo-aim.ini).

    [server]
    port = 8889
    
    [rimp]
    repository = /opt/vm_repository
    autoBackup = false
    autoRestore = false

	[stats]
	collectFreqSeconds = 60
	refreshFreqSeconds = 30
	database = /var/lib/abiquo-aim.db

Basic AIM configuration

Do the following steps:

  1. Log in to the KVM server as root
  2. Edit the file /etc/abiquo-aim.ini
  3. Change any required parameters as described in the AIM agent page.
  4. Restart the AIM service

    service abiquo-aim restart
    
  5. You can now try adding the KVM host in Abiquo again.

Logs

Abiquo AIM writes log messages in

  • stderr
  • /var/log/messages

Restart Abiquo AIM

To restart the Abiquo AIM service:

service abiquo-aim restart

Copyright © 2006-2022, Abiquo Holdings SL. All rights reserved