Abiquo 5.4

Skip to end of metadata
Go to start of metadata


Abiquo VM repository folders must fulfill the requirements below:

  • It must be unique for each Abiquo DC
  • It must be writable by the Abiquo Tomcat processes.
  • An .abiquo_repository flag file must exist in in the root folder and it must be writable by the Abiquo tomcat process.

Abiquo will configure the VM repository during the appliances' bootstrap process. If the Appliance Library does not work out of the box, review the repository requirements.

We strongly recommend the configuration of dedicated NFS or CIFS shares for the VM repository folders

Monitor the available space in the VM repository folder to ensure it does not fill up. If there is not enough space, users will not be able to upload templates.

In order to use cloud-init on Hyper-V, create the hyperv-iso directory in the VM repository folder, which for the default platform will be:


After creating the folder, remember to set the owner to the "tomcat" user.

In private cloud, you must provide an NFS server, which shares the repository folder for each Abiquo datacenter using hypervisors, for storing the Apps library of VM templates (disk images). The Remote Services and hypervisors mount and access the shared folder using NFS or CIFS (SAMBA for Hyper-V).

When you configure the platform, enter the location of the NFS repository, which is the IP address and folder. The platform will automatically configure the NFS server as follows.

  • The install process will configure the platform to mount the repository on the hypervisors
  • In a monolithic installation, the platform will mount the repository on the Abiquo Monolithic server

The firewall requirements are access to NFS on ports TCP/UDP 2049 and TCP/UDP 111 (RPC) for the following servers:

  • Hypervisors using NFS
  • In a distributed installation, Remote Services and V2V Server
  • In a monolithic installation, the Abiquo Server

  • In a distributed installation, the platform will mount the NFS share on the Remote Services server and V2V Services server.


If anything goes wrong with the automatic configuration of the NFS repository, then the NFS repository and the platform may not function correctly. Of the remote services, the Appliance Manager adds VM templates to the repository and manages them, and the Business Process Manager converts VM templates to different disk formats. Hypervisors copy VM templates from the repository to deploy them.

To configure the NFS server, the platform does the following:

  1. Automatically create an empty file named .abiquo_repository in the folder. This file is essential for the proper functioning of the platform. 
  2. Automatically configure the abiquo.properties files on the Remote Services server (or the Monolithic server). For a separate NFS configuration, the abiquo.properties file should look as follows.

    Abiquo properties on the Monolithic and Remote Services appliances
    abiquo.appliancemanager.localRepositoryPath        = /opt/vm_repository/
    abiquo.appliancemanager.repositoryLocation         = <NFS-Server>:/opt/vm_repository
    abiquo.virtualfactory.xenserver.repositoryLocation = <NFS-Server>:/opt/vm_repository
    abiquo.virtualfactory.hyperv.repositoryLocation    = //<CIFS-Server>/vm_repository


  3. Automatically mount the repository folder on the Remote Services and V2V Services servers. The install process should automatically configure the /etc/fstab with the values you enter for the NFS repository.

    # cat /etc/fstab
    <NFS-Server>:/opt/vm_repository /opt/vm_repository  nfs defaults    0 0
  4. Automatically mount the NFS folder on the hypervisors as required based on the repository locations in abiquo.properties.
For more information, see the Troubleshooting section of the wiki, in particular Troubleshooting NFS Server configuration in Abiquo and also  Troubleshooting Configuration Problems  because many configuration problems are related to NFS configuration.


Storage Feature Tables
How to set up Abiquo with a local NFS in a test environment