AIM agent

Owned by MS (Unlicensed)
Jan 17, 2023
3 min read

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"

Versions compatibility

Table of AIM versions and compatible versions of Abiquo

Abiquo version

AIM compatible version

Notes

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.3

1.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.4

1.5.3

The 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.6

2.1.4

Compatible 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-RC1

2.2.1



3.0-RC2

2.2.2



3.0.0-GA

2.3.0

Fixes ABICLOUDPREMIUM-7526 - Memory leak detected

3.0.1

2.3.0

Fixes ABICLOUDPREMIUM-7526 - Memory leak detected

3.1

2.3.0

There are no changes to AIM in Abiquo 3.1. The compatible AIM version is AIM 2.3.0

3.2

2.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.2

2.4.3

Fixes issue number 6016: Core count = CPU socket(s) * NUMA cell(s) * Cores x socket(s)

3.4

2.6.1

  • Adds support for 

    • multiple-disk templates

      • metric dimensions

3.4.2

2.6.3

  • renameDisk

3.6

2.8

  • Adds support for shutdown

  • renameDisk

3.8

2.8



4.0

2.9.0

Version 2.9.2 is also compatible

4.0.1

2.9.2



4.0.2

2.9.3

Rename of default metrics





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