Abiquo Documentation Cookies Policy

Our Documentation website uses cookies to improve your experience. Please visit our Cookie Policy page for more information about cookies and how we use them.


Abiquo 5.0

Skip to end of metadata
Go to start of metadata

Veeam versions

The Abiquo integrations supports the following versions of Veeam Backup & Replication. 

Supported versionNotes
9.5 up to update version 3
9.5 update version 4
  • 9.5 update 4 requires a separate plugin with its own license.
  • To use the new plugin:
    1. Obtain and add the new license
    2. In the datacenter, delete the Backup manager
    3. Create a new one, selecting the new plugin


Veeam requirements

The Abiquo Veeam backup plugins supports the following hypervisors:

  • VMware
  • Hyper-V

The Abiquo backup plugin requires Veeam Enterprise Manager, which is an optional component in Veeam installations.

As part of the install process, configure the API ports of the Veeam Enterprise Manager. Enter the HTTP and HTTPS port numbers that the Veeam Backup Restful API service will use. By default, the values are HTTP port 9399 and HTTPS port 9398. 

Create Veeam Resources for Abiquo

The Veeam API cannot be used to create backup and replication jobs. This means that you must create a dummy job for the Abiquo backup plugin to clone for each hypervisor you will be using. A job must contain at least one VM, so you will need a placeholder VM on each hypervisor for use in the dummy job. 

  1. In your hypervisor, deploy a placeholder VM
    • Choose the VM name carefully to show that it is a placeholder VM so that it will not get accidentally deleted
  2. In Veeam create a new job for the hypervisor
    • The default names that the Abiquo backup plugin will detect are "Abiquo Dummy HyperV Job" for HyperV and "Abiquo Dummy VMWare Job" for ESX
  3. Add the placeholder VM
  4. DO NOT set a schedule for the job
  5. Save the job

Do not delete the placeholder VMs and dummy jobs because this could cause problems in the Abiquo backup plugin.

When viewing jobs in Veeam, dummy jobs with placeholder VMs are shown at the top of the list. Jobs created by the Abiquo backup plugin by cloning the dummy jobs are shown below it.

Configure Veeam properties

To configure Veeam backup properties in Abiquo:

  1. Log in to the Abiquo Remote Services server
  2. Go to /opt/abiquo/config folder and edit the veeam.properties file. This is the default file location, and you can change it as required.
  3. The Abiquo backup plugin is designed to manage one Veeam host for each Abiquo datacenter. To associate a datacenter with its Veaam host, set a property pair for the datacenter name and the Veeam host IP or FQDN.
    Set the datacenter name as it appears in the Abiquo UI and get the Veeam host value from the Veeam Enterprise Manager view.
    For example, for two datacenters, called London and Frankfurt, and with the London veeamhost at 10.60.1.82 and the Frankfurt veeamhost at 10.60.1.90, the properties file would look as follows.

    veeam.infrastructure.datacenter.1=London
    veeam.infrastructure.veeamhost.1=10.60.1.82
    veeam.infrastructure.datacenter.2=Frankfurt
    veeam.infrastructure.veeamhost.2=10.60.1.90
  4. To control backup expiration times in Veeam, use properties to set maximum restore points. Remember to remove the hash '#' comment mark at the start of the property line.

    # Set the maximum restore points of a job for each schedule type
    veeam.maxrestorepoints=3
    veeam.maxrestorepoints.schedule.daily=8
    veeam.maxrestorepoints.schedule.monthly=3
    
    
    # Set the maximum restore points for a specific polity, e.g. "mypolicy", with preference over other properties
    #veeam.maxrestorepoints.policycode.mypolicy = 5
  5. Optionally set other properties, according to your environment:

    # JOBS CONFIGURATION
    
    ## Since veeam api does not allow to create new jobs, only clone the
    ## existent jobs. The veeam needs a dummy job (disabled) in each veeam
    ## host in order to clone it to create new jobs.
    ## The following properties define the name of the jobs for each
    ## virtualization type
    #veeam.dummy.vmware.name=Abiquo Dummy VMWare Job
    #veeam.dummy.vmware.repository=Default Backup Repository
    #veeam.dummy.hyperv.name=Abiquo Dummy HyperV Job
    #veeam.dummy.hyperv.repository=Default Backup Repository
    
    # TASK MANAGEMENT
    
    ## Some operations in veeam api causes an asynchronous task that needs
    ## to be tracked to know the result of the operation. All these properties
    ## are defined in milliseconds
    
    ## Time to wait between each task state retrieve operation.
    ## Min and Max exists because each operation increase the next interval
    ## in a half of the last one (nextinterval = currentinterval * 1.50)
    #veeam.request.async.maxinterval=60000
    #veeam.request.async.mininterval=5000
    
    ## Maximum of time spent to retrieve the task result
    #veeam.request.async.totaltimeout=300000
    
    ## Timeout properties for synchronous request to Veeam api
    #veeam.client.connect.timeout=6000
    #veeam.client.read.timeout=10000
    
    ## Cache expire time in milliseconds
    #veeam.cache.expire.duration=1800000

Configure Abiquo properties

To activate the backup plugin and define the location of the properties file:

  1. Log in to the Remote Services server
  2. Edit the abiquo.properties file
  3. Set the abiquo.backup.veaam.config.path property in the following format
abiquo.backup.veeam.config.path=/opt/abiquo/config/veeam.properties

Remember that you will need to restart the Tomcat server for the changes to take effect.