AIM agent

Abiquo Infrastructure Management (AIM) manages a KVM host VMs, disk operations, the local event system and VLANs. AIM must be installed in each node machine running KVM.

Configuration

To configure AIM:

  1. Log in to the hypervisor as root and edit the file: /etc/abiquo-aim.ini
  2. Change the configuration as necessary. 
  3. Restart the AIM service (service abiquo-aim restart)

Services

The services available are:

  • Rimp (repository importer) enables AIM to create virtual machine disks by copying templates from the NFS repository to the hypervisor datastore and create instance clones of virtual machines by copying disks from the datastore to the NFS repository
  • VLAN service manages the creation and deletion of VLAN and Bridge. The network configuration is persisted using CentOS network configuration files under _/etc/sysconfig/network-
    scripts_.
  • Storage service manages the iSCSI storage configuration.
  • Libvirt service provides access to the libvirt API.

Configuration

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

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

Rimp properties

  • repository, repository mount point
  • autoBackup, on undeploy if autoBackup=true, then the disk is backed up rather than deleted from the datastore.
  • autoRestore, on deploy if autoRestore=true, then the disk is restored from a previous backup disk rather than copied from repository.

Command line arguments

    [root@localhost ~]# abiquo-aim --help
    Usage: abiquo-aim options
    -h --help                       Show this help
    -c --config-file=<file>         Alternate configuration file
    -d --daemon                     Run as daemon
    -v --version                    Show AIM server version
    -t --threads                    Maximum threads to handle requests

Defaults

By default the server is listening at 8889 port, starts a thread pool of 4 threads and loads the configuration file named aim.ini

Logs

AIM writes log messages in the stderr and /var/log/messages

VLAN configuration examples

"'ifcfg-abiquo_3' bridge configuration file"
    DEVICE=abiquo_3
    TYPE=Bridge
    BOOTPROTO=none
    ONBOOT=yes
"'ifcfg-abiquo_eth2.3' VLAN configuration file"
    VLAN=yes
    DEVICE=eth2.3
    BOOTPROTO=none
    ONBOOT=yes
    BRIDGE=abiquo_3

Versions compatibility

Table of AIM versions and compatible versions of Abiquo

Abiquo version

AIM compatible version

Notes

1.8

1.3.2

 

1.8.5-HF6

1.4

 

2.0

1.4

 

2.0-HF5

1.4.4

Fixes bug ABICLOUDPREMIUM-4205 - If three VLANs get destroyed at the same time, one of the bridges does not get cleaned up

2.0-HF6 -
2.2 

1.5.1

Improvement ABICLOUDPREMIUM-4276 - Use aim.ini to define the list of valid datastore types. This version is compatible with Abiquo 2.0-HF6 and Abiquo 2.2

2.31.5.2

This version is backwards compatible with Abiquo 2.2 and compatible with Abiquo 2.3. Fixes bugs

  • ABICLOUDPREMIUM-4501 - Sometimes in a concurrent deploy on KVM, one VM is not deployed
  • ABICLOUDPREMIUM-4497 - Cannot delete a VM in KVM if its disk doesn't exist in the datastore.
2.41.5.3The detection of MOVE events is the responsibility of AIM instead of VSM (for KVM hypervisor). Compatible with KVM on CentOS 6.3. Upgrade to CentOS 6.3 from CentOS 5 requires VM migration.
2.62.1.4Compatible with CentOS 6.4. Abiquo recommends direct migration of VMs from CentOS 5 to CentOS 6.4. Upgrade to CentOS 6.4 from CentOS 6.3 requires VM power off.
3.0-RC12.2.1 
3.0-RC22.2.2 
3.0.0-GA2.3.0Fixes ABICLOUDPREMIUM-7526 - Memory leak detected
3.0.12.3.0Fixes ABICLOUDPREMIUM-7526 - Memory leak detected
3.12.3.0There are no changes to AIM in Abiquo 3.1. The compatible AIM version is AIM 2.3.0
3.22.4.2

The following new properties have been added to a new [stats] section to manage statistics for metrics and monitoring:

  • collectFreqSeconds = 60

  • refreshFreqSeconds = 30

  • database = /var/lib/abiquo-aim.db

3.2.22.4.3Fixes issue number 6016: Core count = CPU socket(s) * NUMA cell(s) * Cores x socket(s)
3.42.6.1
  • Adds support for 
    • multiple-disk templates
      • metric dimensions
3.4.22.6.3
  • renameDisk
3.62.8
  • Adds support for shutdown
  • renameDisk
3.82.8 
4.02.9.0Version 2.9.2 is also compatible
4.0.12.9.2 
4.0.22.9.3Rename of default metrics

 


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