Abiquo 2.6


Skip to end of metadata
Go to start of metadata

Admin Guide 1. Abiquo. Config Properties

Introduction to Abiquo Properties

Abiquo uses a system based on Java properties that is flexible and easy to configure.

Configuration options are grouped in the file /opt/abiquo/config/abiquo.properties on each server of the Abiquo platform (Abiquo Server, Remote Services, V2V Services). The Abiquo Installer will create configuration files for your installation and example configuration files can be found in the directory /opt/abiquo/config/examples. If you wish to change the configuration options, add the properties you wish to change to your abiquo.properties file and specify the new values. 

The tables below contain all the configuration options that can be modified and their default values as set by Abiquo. The default values for properties are used within the Abiquo platform if you do not set the properties. However, some default configuration options may also be set outside of the Abiquo platform, for example, in the hypervisor. 

After modifying this file, check carefully to ensure you have the correct values and no unnecessary whitespace around the properties. You must restart the abiquo-tomcat service for the changes to take effect.

[root@localhost ~]# service abiquo-tomcat restart

Changes to Properties

New Properties in v2.6.7

These properties are new in Abiquo 2.6.7.

Storage System Manager

  1.  abiquo.storagemanager.nexenta.blocksize

New properties marked with the (star) symbol in the Info column of the properties table.

New Properties in v2.6

These properties are new in Abiquo 2.6. Optional properties are commented out with a hash sign "#" in front of the property. Default values are given after the equals sign "=".

Appliance Manager

  1. #abiquo.appliancemanager.check.repository=600000
  2. #abiquo.appliancemanager.deploy.connection=120000
  3. #abiquo.appliancemanager.deploy.idle=6000000000
  4. #abiquo.appliancemanager.deploy.totalTimeout=8640
  5. #abiquo.appliancemanager.downloads=-1
  6. #abiquo.appliancemanager.fstimeoutms=7000
  7. #abiquo.appliancemanager.repository.ignoredPathPrefix=
  8. #abiquo.appliancemanager.repository.ignoredPathRegex=
  9. #abiquo.appliancemanager.repository.ignoredPathSuffix=
  10. #abiquo.appliancemanager.upload.progressInterval=5000

M Outbound API

  1. abiquo.m.identity=admin
  2. abiquo.m.credential=xabiquo

NetApp Free Space Ratio

  1. abiquo.storagemanager.netapp.aggrfreespaceratio=0.05

Oracle

  1. #abiquo.virtualfactory.oraclevm.repositoryLocation=
  2. #abiquo.virtualfactory.oraclevm.jobTimeoutMs=28800000
  3. #abiquo.virtualfactory.oraclevm.hardPartitioning=false
  4. #abiquo.virtualfactory.oraclevm.hardPartitioningCPURatio=1
  5. #abiquo.virtualfactory.oraclevm.createSparseDisks=true
  6. #abiquo.virtualfactory.oraclevm.ha=false
  7. #abiquo.virtualfactory.oraclevm.defaultVMDomain=HVM

VSM Polling

  1. #abiquo.vsm.pollingfrequency.hyperv_301=5000
  2. #abiquo.vsm.pollingfrequency.kvm=5000
  3. #abiquo.vsm.pollingfrequency.oracle_vm=5000
  4. #abiquo.vsm.pollingfrequency.vmx_04=5000
  5. #abiquo.vsm.pollingfrequency.xenserver=5000

New properties marked with the (star) symbol in the Info column of the properties table.

Changes to Properties in v2.6

Properties that have been changed in this version are:

  1. abiquo.server.api.location - now required by remote services and API
Changed properties are marked with the (warning) symbol in the New column of the properties table.

Changes to KVM Configuration Without Full Virtualization

 You may now need to perform other configuration in addition to setting abiquo.virtualfactory.kvm.fullVirt=false. See KVM Cloud Node Installation

Required Remote Services Property in Abiquo 2.6

The property abiquo.server.api.location is now also required by remote services in distributed installations for template download. In Abiquo 2.6 GA, you must manually add this property to the abiquo.properties file on the distributed remote services server.

Open Sessions on Hyper-V and ESXi

Set abiquo.virtualfactory.openSession=1 as a workaround to problems with concurrent deployments in:
  • Hyper-V

Removed and Deprecated Properties in Abiquo 2.6

Properties that are not supported in this version are:

  1. hypervisors.storagelink.address
  2. hypervisors.storagelink.password
  3. hypervisors.storagelink.user
  4. abiquo.storagemanager.storageMethod: 
    • the platform default storage allocation method is still Progressive, but to change this default, you must set a value for every tier in every datacenter
  5. abiquo.vsm.esx.pollinginterval
    • Replaced by abiquo.vsm.pollingfrequency.vmx_04
  6.  abiquo.vsm.pollingfrequency.xen_3
  7. abiquo.vsm.pollingfrequency.vbox
  8. abiquo.vsm.xen.refresh.mstosleep
  9. abiquo.vsm.xen.refresh.retries
Many of these deprecated or removed properties are related to technology that is no longer supported by Abiquo, including XenServer Storagelink, Xen hypervisor and VirtualBox hypervisor

Configure infrastructure checks

  • abiquo.vi.check.delay property is the delay period after an infrastructure check completes before the next check begins.
  • abiquo.ha.check.delay is the delay between checks of machines that already have HA in progress in order to determine if HA movements are complete
  • See Configure Infrastructure Checks
Configure Abiquo Events Properties

Configure M

If you do not configure M properly, no events will be available in Abiquo. You will probably need to configure the M properties in the abiquo.properties file on the server where M will run. By default, M runs on the Abiquo Server. The required properties are the M user account details and the API location.

In Abiquo 2.6, there is a new module called M. This module listens for events in the Abiquo API. When it receives events, it performs requests to the Abiquo API to retrieve further details about the events. Then it writes the events to the Abiquo database and broadcasts them as the event stream of the Outbound API.

Automatic M User Account Configuration

When you install or upgrade Abiquo 2.6, it is essential to check that the M module is properly configured to ensure that your platform will record events.

  1. Fresh install of 2.6 + customer enters cloud admin password in install screens
    1. Abiquo automatically configures M is automatically configured with the admin password
    2. M user and password are NOT included in properties file
    3. If the customer changes the admin account, they must reconfigure M with user and/or password in the abiquo.properties file as described below
  2. Fresh install of 2.6 + customer does NOT enter cloud admin password in install screens
    1. Abiquo automatically configures M with the default admin account (user admin, password xabiquo)
    2. When the customer changes the admin account, they must configure M with user and/or password in the abiquo.properties file as described below
  3. Upgrade from 2.4.x to 2.6.x
    1. Abiquo automatically configures M with the default cloud admin account (user admin, password xabiquo)
    2. The customer must configure M with user and password in the abiquo.properties file as described below

Configure M Properties

You must configure the abiquo.properties file on the server where M will run. Without this configuration, no events will be available in Abiquo

  1. Abiquo M User
    • M will use this identity and credential to access the Abiquo API and retrieve information about the events
    • It will record the events in the Abiquo database and stream them through the Outbound API
    • When you modify the default cloud admin user, the hidden default values of admin and xabiquo will not function
    • This user must have permission to access all events. See the privileges defined for the Outbound API role in Privileges

  2. Abiquo API Location with Port
    • The API location must be an externally accessible IP and port
    • Use the API port to ensure that an event streaming user with a regular user role can access events
    • The API location IP address cannot be a localhost value (127.0.0.1 or localhost)
    • The Abiquo API location is also used for the Chef integration, so remember this if you have distributed platform components

Example of Manual M Configuration

Abiquo M Configuration
abiquo.m.identity = AbiquoMUser 
abiquo.m.credential = AbiquoMPassword
abiquo.server.api.location = http://my.api.location:80/api

Configure API Load Balancing Properties

API load balancing properties

  • API Servers: set ALLload balancing properties on all API servers that are load balanced. The properties must point to the datanode, which contains the common instances of RabbitMQ, Redis, Zookeeper, and MariaDB/MySQL
    1. abiquo.api.zk.serverConnection
    2. abiquo.database.user
    3. abiquo.database.password
    4. abiquo.database.host
    5. abiquo.redis.host
    6. abiquo.redis.port
  • Remote Services Servers: set RabbitMQ properties on all remote services servers in API load balancing datacenters
    1. abiquo.rabbitmq.connectionTimeout
    2. abiquo.rabbitmq.host
    3. abiquo.rabbitmq.password
    4. abiquo.rabbitmq.port

Key to the Abiquo Configuration Properties Table

(star)  – New property 
(warning)  – Changed property
(minus) – Deprecated Property

 – Abiquo Server / API
 – Remote Services
 – V2V Remote Services 
 – Outbound API
 

This table describes the abiquo.properties file of the Abiquo platform servers. For example, if a property is marked with  symbol  in the  column, it can be configured in the abiquo.properties file of the Abiquo Server/API and Abiquo Monolithic Server.

Abiquo Monolithic Server

An Abiquo Monolithic Server is a single-server install of all or most of the Abiquo platform components, so the properties present on the Abiquo Server and the Remote Service machines may not be necessary or may only need to be added once. For example, see the Note on Redis Properties below the table.

Abiquo Configuration Properties Table

Property

Default

Range

Description

Info

api

abiquo.api.networking.allowMultipleNicsVlan

True

 

If false (or any other value), allow only one NIC per VLAN on a VirtualMachine

    

abiquo.api.networking.nicspervm

0

 

Limit of NICs per Virtual Machine. If this is set to 0, there are no limits

    

abiquo.api.zk.serverConnection

  

Location where ZooKeeper is listening in format <IP address>:<port> for example, 10.10.10.10:2181

    

appliancemanager

        

abiquo.appliancemanager.check.repository

600000

 

Datacenter NFS repository refresh interval (milliseconds)

 

  (star)

abiquo.appliancemanager.checkMountedRepository

true

 

Perform the repository check against /etc/mtab. Set to false for local NFS Server installations in testing environment: Monolithic, Cloud in a Box, NFS on V2V Server or NFS on Remote Services

 

   

abiquo.appliancemanager.client.timeoutInMilliseconds

60000

 

Timeout for HTTP connections to the ApplianceManager Server when using the ApplianceManager Client, this property configures read and connection timeout. (milliseconds)

 

   

abiquo.appliancemanager.deploy.connection

120000

 

Timeout for HTTP connections to be stablished when downloading a virtual machine template (milliseconds)

 

  (star)

abiquo.appliancemanager.deploy.idle

600000

 

Timeout for idle HTTP connections when downloading a virtual machine template (milliseconds)

 

  (star)

abiquo.appliancemanager.deploy.totalTimeout

86400000

 

Timeout for HTTP connections when downloading a virtual machine template (milliseconds)

 

  (star)

abiquo.appliancemanager.downloadingPublishInterval

1500

 

Frequency of download progress notification (milliseconds)

 

   

abiquo.appliancemanager.downloads

-1

 

Maximum number of concurrent template downloads (-1 unlimited)

 

  (star)

abiquo.appliancemanager.fstimeoutms

7000

 

Max time to for the appliance manager to perform a complete rescan of the repository filesystem (milliseconds)

 

  (star)

abiquo.appliancemanager.localRepositoryPath

/opt/vm_repository

 

Folder where the abiquo.appliancemanager.repositoryLocation is mounted on the remote services node

 

   

abiquo.appliancemanager.repository.ignoredPathPrefix

  

Path names prefixes to be ignored in the repository refresh (Comma separate value)

 

  (star)

abiquo.appliancemanager.repository.ignoredPathRegex

  

Path names suffixes to be ignored in the repository refresh (java Regular Expression format)

 

  (star)

abiquo.appliancemanager.repository.ignoredPathSuffix

  

Path names suffixes to be ignored in the repository refresh (Comma separate value)

 

  (star)

abiquo.appliancemanager.repositoryLocation

<IP-repoLoc>:/opt/vm_repository

 

Local Appliance Library, NFS repository location denoted by nfs-server-address:exportpath

 

   

abiquo.appliancemanager.upload.progressInterval

5000

 

Refresh virtual machine template upload progress (milliseconds)

 

  (star)

auth

        

abiquo.auth.module

abiquo

abiquo, ldap

Whether Abiquo will authenticate only via database or it will also authenticate against LDAP/Active Directory.

    

database

        

abiquo.database.host

<IP-repoLoc>

 

Abiquo database host. Note that a remote database must also be set up with the jdbc drivers in the api.xml file. See how to set up a remote MySQL database server on the Abiquo wiki

    

abiquo.database.password

  

Password of the Abiquo database user

    

abiquo.database.user

root

 

Username of the Abiquo database user. The user must be created in the DBMS with the appropriate privileges on Abiquo databases. See How to set up a remote MySQL database server on the Abiquo wiki

    

datacenter

        

abiquo.datacenter.id

Abiquo

 

Identify the AMQP datacenter queues. The Datacenter ID is used for building routing keys and queue names, so that they are unique for each datacenter. Warning: Do not change this property! This property is required and the value is generated at installation. You can recover the property's value through the API with Get Datacenter

 

  

diskController

        

abiquo.diskController.primary

 

scsi, ide

Default value. Abiquo uses the property only if the disk controller attribute is not set in the virtual machine template. ESXi only: if null, the controller for primary disks on non-persistent VMs is ide and on persistent VMs it is scsi. Values apply to both non-persistent and persistent VMs. This property does not apply to Hard Disks on the VMware datastore, which are always attached to a SCSI controller.

    

abiquo.diskController.secondary

 

scsi, ide

ESXi only: if null, the secondary disk controller will be scsi. If ide, you may only add one persistent data volume. This property does not apply to Hard Disks on the VMware datastore, which are always attached to a SCSI controller.

    

dvs

        

abiquo.dvs.enabled

true

 

Enable DVS. Note that the vCenter login and password can be used when DVS is disabled

 

   

abiquo.dvs.portgroup.loadsharingmechanism

loadbalance_ip

loadbalance_ip, loadbalance_srcid

Network adapter teaming policy in DVS port groups. This property controls the algorithm used for network adapter load balancing when multiple NICs are used in 'teaming mode'.

 

   

abiquo.dvs.portgroup.maxsize

48

 

Number of available ports in each port group

 

   

abiquo.dvs.vcenter.password

change-me

 

Password of the vCenter user account. The underscore character "_" is not allowed in this field. Create a user with the same password in the vCenter in order to use the DVS or vCenter with Abiquo. In vSphere 5.1, you must create this account in an Active Directory domain or using a VMware Single Sign-on system, NOT as a local Windows account on the vCenter. If 'abiquo.dvs.enabled' is set to true, this property is required. The DVS vCenter user and password properties are also used for connecting to vCenter even if DVS is not used, for example, when deleting orphans. So the user and password properties can be used even when abiquo.dvs.enabled is set to 'false'. Set these parameters if vCenter is used, even if DVS is not used

 

   

abiquo.dvs.vcenter.user

change-me

 

Username of the vCenter user account. Create a user account with the same password in the vCenter in order to use the DVS or vCenter with Abiquo. In vSphere 5.1, you must create this account in an Active Directory domain or using a VMware Single Sign-on system, NOT as a local Windows account on the vCenter. If 'abiquo.dvs.enabled' is set to true, the property is required. The DVS vCenter user and password properties are also used for connecting to vCenter even if DVS is not used, for example, when deleting orphans. So the user and password properties can be used even when abiquo.dvs.enabled is set to 'false'. Set these parameters if vCenter is used, even if DVS is not used

 

   

esxi

        

abiquo.esxi.datastoreRdm

  

When using volumes, a VMFS datastore is required (Raw Device Mapping), if the provided target datastore is not VMFS, then try to use the configured datastore

 

   

ha

        

abiquo.ha.check.delay

300000

 

Delay between checks of all machines with state HA_IN_PROGRESS to determine if HA tasks on all VMs are complete, and if so, then set machine state to DISABLED_BY_HA (milliseconds) (Default value is 5 minutes)

    

abiquo.ha.infcheck.cycles

2

 

Number of failed infratructure checks on a machine before High Availability is triggered and the machine is set to state HA_IN_PROGRESS

    

heartbeat

        

abiquo.heartbeat.autostart

true

 

Automatically start Abiquo heartbeat

    

httpProxy

        

abiquo.httpProxy.host

  

IP Address of HTTP proxy for Appliance Manager/API to Internet communication (download template definition list, template definition, VM disk file)

   

abiquo.httpProxy.password

  

Password of HTTP proxy for Appliance Manager/API to Internet communication (download template definition list, template definition, VM disk file)

   

abiquo.httpProxy.port

  

Port of HTTP proxy for Appliance Manager/API to Internet communication (download template definition list, template definition, VM disk file)

   

abiquo.httpProxy.user

  

User of HTTP proxy for Appliance Manager/API to Internet communication (download template definition list, template definition, VM disk file)

   

ldap

        

abiquo.ldap.authentication.attribute.enterprise

organizationname

 

The attribute in LDAP/Active Directory to look up the Enterprise Name which must be an Enterprise in Abiquo.

    

abiquo.ldap.authentication.autoUserCreation

true

 

Whether Abiquo must create a user in Abiquo based on a successful login to LDAP

    

abiquo.ldap.authentication.custom.userDnPattern

cn=\{0},CN=Users

 

Abiquo will perform an additional custom query against the specified schema in the LDAP/Active Directory. This value is required. The default value does not result in an additional query

    

abiquo.ldap.authentication.server.baseDN

DC=127.0.0.1,DC=local

 

Base Distinguished Name of the LDAP/Active Directory

    

abiquo.ldap.authentication.server.port

389

 

LDAP/Active Directory port. In LDAP mode this property is required, even if the server is listening at the default LDAP/Active Directory port

    

abiquo.ldap.authentication.server.protocol

ldap

ldap, ldaps

Protocol to be used when authenticating to a LDAP/Active Directory.

    

abiquo.ldap.authentication.server.url

127.0.0.1

 

LDAP/Active Directory server URL

    

m

        

abiquo.m.credential

xabiquo

 

Credentials that M should use to perform requests to the Abiquo Server (API)

   

(star)

abiquo.m.identity

admin

 

Identity that M should use to perform requests to the Abiquo Server (API)

   

(star)

managedrack

        

abiquo.managedrack.check.delay

900000

 

Delay between checks of the managed racks. This property is used if there is a maximum number of empty machines configured in a UCS rack. This is the check performed to power on or off machines, according to the power-save configuration of the managed rack (milliseconds)

    

nodecollector

        

abiquo.nodecollector.infcheck

5

 

Time between executions of infrastructure check (minutes)

 

   

abiquo.nodecollector.infcheck.threads

5

 

Infrastructure check concurrent machine checks This number should be tied to the number of cores of the machine running discovery manager service

 

   

abiquo.nodecollector.infcheck.timeout

300

 

Infrastructure check timeout in seconds

 

   

abiquo.nodecollector.timeout

180000

 

Timeout for Server/API connections to Nodecollector (Discovery manager) (milliseconds)

    

rabbitmq

        

abiquo.rabbitmq.connectionTimeout

0

 

Timeout for establishing a connection to RabbitMQ. The default value of 0 means to wait indefinitely until connection established or error (milliseconds)

  

abiquo.rabbitmq.host

127.0.0.1

 

Address where RabbitMQ is located

  

abiquo.rabbitmq.password

guest

 

RabbitMQ password

  

abiquo.rabbitmq.port

5672

 

Port where RabbitMQ is located

  

abiquo.rabbitmq.requestedHeartbeat

0

 

The initially requested heartbeat interval, in seconds. The default value of 0 means no heartbeat

  

abiquo.rabbitmq.username

guest

 

RabbitMQ username

  

abiquo.rabbitmq.virtualHost

/

 

Virtual host where RabbitMQ runs

  

redis

        

abiquo.redis.host

127.0.0.1

 

Address where Redis is located. By default Redis is installed on the Abiquo Server in addition to the Remote Services machine. In a monolithic install, the Redis host and port properties should point to the monolithic server. When configuring API load balancing, only the Abiquo Server Redis property should point to the central datanode

   

abiquo.redis.port

6379

 

Port where Redis is located. By default Redis is installed on the Abiquo Server in addition to the Remote Services machine. In a monolithic install, the Redis host and port properties should point to the monolithic server. When configuring API load balancing, only the Abiquo Server Redis property should point to the central datanode

   

repository

        

abiquo.repository.timeoutSeconds

10

 

Time to wait for checking if the .abiquo_repository file mark is present in the NFS repository filesystem (helps in finding a slow NFS repository) (seconds)

 

   

server

        

abiquo.server.api.location

http://127.0.0.1/api

 

Address where the API is running. Used in Chef (API) and Appliance Manager (RS). Must be the public IP of the Abiquo API (or at least an address reachable from the deployed virtual machines). For example: http://80.169.25.32/api/

  (warning)

abiquo.server.blockduplicatedsessions

false

 

If not supplied, it is set to false. When false, no action is taken if multiple users are logged in with the same user account. The user who logged in most recently will have true control of the session and actions by other users may cause problems. When true, the most recent user has control of the session and other users are warned and logged out

    

abiquo.server.mail.password

none

 

Password for connecting to the mail server

    

abiquo.server.mail.server

10.60.1.4

 

Address where the mail server is located

    

abiquo.server.mail.user

none@none.es

 

System user with privileges for connecting to the mail server

    

abiquo.server.remoteSpace.default

http://abiquo-repository.abiquo.com/ovfindex.xml

 

Default remote repository space (OVF package sources) attached to all appliance libraries

    

abiquo.server.sessionTimeout

30

 

Time the server waits before marking a client session as expired (minutes)

    

abiquo.server.timeout

600000000

 

Time the server waits for long requests (milliseconds) (Default value is 7 days)

    

storage

        

abiquo.storage.check.delay

900000

 

Delay between checks of the storage infrastructure (milliseconds)

    

storagemanager

        

abiquo.storagemanager.netapp.aggrfreespaceratio

0.05

0 - 1

Recommended free space on NetApp aggregates.

   (star)

abiquo.storagemanager.netapp.debug

false

 

Records requests to ONTAP and responses in the Abiquo logs

    

abiquo.storagemanager.netapp.initiatorGroupName

abiGroup

 

Optional initial initiator group will be created

    

abiquo.storagemanager.netapp.volumelunration

1.3

1.3 - 1.9

Optional ratio to allow a LUN of a provided size to fill on its container volume (volSize = lunSize * volumelunratio).

    
 abiquo.storagemanager.nexenta.blocksize88 - 128

Specifies the block size in KB for the volumes created in Nexenta storage devices. Abiquo does not validate this property. Abiquo supports values from 8 to 128 KB inclusive but Nexenta requires the value to be a power of 2.

   (star) New in 2.6.7

tasks

        

abiquo.tasks.history.size

20

 

Maximum length of task history in Redis for API/Server by owner

    

abiquo.tasks.trimmer.delay

86400000

 

Delay between executions of the trimmer of task history in Redis for API/Server (milliseconds)

    

vcenter

        

abiquo.vcenter.port.connection

443

 

Port for connection to vCenter

 

   

vi (virtual infrastructure)

        

abiquo.vi.check.delay

900000

 

Delay between executions of the virtual infrastructure check (milliseconds)

    

virtualfactory

        

abiquo.virtualfactory.hyperv.repositoryLocation

//<IP-repoLoc>/vm_repository

 

The CIFS address //IP/resource/ where Windows can locate the virtual disk repository

 

   

abiquo.virtualfactory.kvm.fullVirt

true

true, false

If set to false libvirt machines will be created in KVM using PC emulation (software emulation, slower). Emulation only works with x86 64-bit based hosts, including virtual machines, such as cloud in a box. For cloud in a box, set to false.

 

   

abiquo.virtualfactory.networking.bridgePrefix

abiquo

 

Prefix to name used to identify the VLAN bridge in the KVM, XEN, VBOX hypevisor nodes

 

   

abiquo.virtualfactory.openSession

2

 

Maximum number of simultaneous operations on a single hypervisor

 

   

abiquo.virtualfactory.oraclevm.createSparseDisks

true

true, false

Create additional hard disks on the datastore as sparse. The default value is ‘true’.

 

  (star)

abiquo.virtualfactory.oraclevm.defaultVMDomain

HVM

HVM, PVM, PVHVM

Create all Oracle VMs with this domain type. Options are (Hardware Virtualized [HVM], Paravirtualized [PVM], Hardware Virtualized with Paravirtualized drivers [PVHVM]). The default is HVM.

 

  (star)

abiquo.virtualfactory.oraclevm.ha

false

true, false

This setting controls whether VMs created by Abiquo are configured within Oracle VM for ‘High Availability’. The default value is ‘false’ (no HA support). If set to ‘true’, then Abiquo will deploy a VM for HA if the Oracle VM Server hosting the VM is part of a Clustered Server Pool. Note that when a VM is re-configured, Abiquo will NOT update the HA status of the VM. Please note that some manual configuration of Oracle VM may be required for HA to be performed successfully - please review Oracle VM details in the Abiquo wiki for more details.

 

  (star)

abiquo.virtualfactory.oraclevm.hardPartitioning

false

true, false

Enable Oracle VM Hard Partitioning support (CPU pinning). The default value is ‘false’.

 

  (star)

abiquo.virtualfactory.oraclevm.hardPartitioningCPURatio

1

1 - 64

Expected ratio of virtual CPUs to Physical CPU cores (integer). For best performance, set to 1. To reduce physical CPUs per VM and thus licensing costs, set to a higher value. For example, A value of 1 means a 4xCPU VM will be pinned to 4 physical CPUs whereas a value of 4 means a 4xCPU VM will be pinned to one physical CPU.

 

  (star)

abiquo.virtualfactory.oraclevm.jobStatusCheckDelayMs

1000

100 - 60000

Polling period for the job status check to monitor the status of asynchronous hypervisor jobs (milliseconds). Defaults to 1 second, with a valid range of 0.1 second to 1 minute.

 

  (star)

abiquo.virtualfactory.oraclevm.jobTimeoutMs

28800000

60000 - 604800000

The maximum length of time the Oracle VM Hypervisor Plugin will wait for an individual API-based job to complete (milliseconds). The default is 8 hours, but the valid range is 1 minute to 1 week.

 

  (star)

abiquo.virtualfactory.oraclevm.repositoryLocation

  

NFS Repository location denoted by nfs-server-address:exportpath used by Oracle VM. Defaults to the value of ‘abiquo.appliancemanager.repositoryLocation’ if not explicitly specified in the abiquo.properties file.

 

  (star)

abiquo.virtualfactory.storagelink.address

https://<IP-repoLoc>:21605

 

Address of storagelink for XenServer storage

 

  (minus)

abiquo.virtualfactory.storagelink.password

storagelink

 

Password of storagelink for XenServer storage

 

  (minus)

abiquo.virtualfactory.storagelink.user

admin

 

User of storagelink for XenServer storage

 

  (minus)

abiquo.virtualfactory.xenserver.repositoryLocation

<IP-repoLoc>:/opt/vm_repository

 

The Storage Area network datastore location where the virtual disks are stored (usually the same as abiquo.appliancemanager.repositoryLocation)

 

   

vncport

        

abiquo.vncport.max

65534

 

Last port of the VNC range to be used when allocating virtual machines. Note that VMware only recommends ports 5900 to 5964

    

abiquo.vncport.min

5900

 

First port of the VNC range to be used when allocating virtual machines

    

vsm

        

abiquo.vsm.pollingfrequency.hyperv_301

5000

 

The delay between VSM polling of virtual machines in milliseconds on HYPER-V plugin

 

  (star)

abiquo.vsm.pollingfrequency.kvm

5000

 

The delay between VSM polling of virtual machines in milliseconds on KVM plugin

 

  (star)

abiquo.vsm.pollingfrequency.oracle_vm

5000

 

The delay between VSM polling of virtual machines in milliseconds on ORACLE VM plugin

 

  (star)

abiquo.vsm.pollingfrequency.vbox

5000

 

The delay between VSM polling of virtual machines in milliseconds on Virtual Box plugin

 

  (minus)

abiquo.vsm.pollingfrequency.vmx_04

5000

 

The delay between VSM polling of virtual machines in milliseconds on ESX plugin

 

  (star)

abiquo.vsm.pollingfrequency.xen_3

5000

 

The delay between VSM polling of virtual machines in milliseconds on XEN plugin

 

  (minus)

abiquo.vsm.pollingfrequency.xenserver

5000

 

The delay between VSM polling of virtual machines in milliseconds on XEN SERVER plugin

 

  (star)

abiquo.vsm.xen.refresh.mstosleep

1000

 

Delay between executions of the refresh operation for Xen hypervisor

 

  (minus)

abiquo.vsm.xen.refresh.retries

5

 

Maximum number of retries of refresh operation on Xen hypervisor

 

  (minus)

client

        

client.SERVER_ADDRESS

<IP-repoLoc>

 

Used by the Flex UI to test connectivity to the backend API stub

    

client.USE_SECURE_CHANNEL_LOGIN

0

0, 1

Configures the AMF secure channel (0 for regular, 1 for secure).

    

com.abiquo

        

com.abiquo.virtualfactory.esxi.timeoutConnectionMs

10000

 

Time to wait to establish the connection to ESX (milliseconds)

 

   

com.abiquo.virtualfactory.esxi.timeoutReadMs

30000

 

Time to wait to read from the connection to ESX (milliseconds)

 

   

com.abiquo.virtualfactory.vbox.timeoutConnectionMs

10000

 

Time to wait to establish the connection to VirtualBox (milliseconds)

 

  (minus)

com.abiquo.virtualfactory.vbox.timeoutReadMs

30000

 

Time to wait to read from the connection to VirtualBox (milliseconds)

 

  (minus)

vnc

        

RemoteDisplay.vnc.keyMap

  

ESX and ESXi only: When using a virtual machine as a VNC server, specify the language to use for the keyboard when VNC clients connect. If this property does not exist, the hypervisor will use the first value in the client-config.xml.jsp in webapps/client-premium/config and the default in this case is the US101 keyboard map (US English). This property is now the default setting to complement the Virtual Machine configuration popup. See Configuring Remote Access to Virtual Machines

 

   


Note on Redis Properties

By default Redis is installed on the Abiquo Server in addition to the Remote Services machine. The default abiquo.redis.host configuration is as follows.

Distributed Install

Abiquo Server

abiquo.redis.host = 127.0.0.1

Abiquo Remote Services

abiquo.redis.host = 127.0.0.1

When configuring API load balancing, only the Abiquo Server Redis property should point to the central datanode.

Monolithic Install

Abiquo Server ________

abiquo.redis.host = 127.0.0.1

The abiquo.redis.port should also be set on the Abiquo Server and the Remote Services machine. In a monolithic install, the Redis host and port properties should appear only once.