XCP-ng is entirely managed by its API, called "XAPI". XAPI project is hosted inside the Linux Foundation (opens new window) and the documentation is available on its dedicated website (opens new window).

XAPI is requested by multiple clients, like Xen Orchestra or xe CLI. See our management section for more details.

TIP

Should I build applications on top of XAPI? In fact, because it's made with very specific calls (close to Xen logic), it's better to build a solution on top of a more global API, the one provided by Xen Orchestra (opens new window). It will act as a central point for all your pools and you won't have to handle all the Xen specifics.

# Architecture

XAPI is using a database (Read/write on the master, replicated to slaves in read only). It's an XML file located at /var/lib/xcp/state.db. All the metadata and settings of your pool, hosts, VMs and so on are stored there.

See our dedicated documentation on XAPI for deeper technical details.

# Restarting the API

Sometimes, you might want to restart the toolstack (API and storage stack). You can do it with the following command from the host console (or directly with Xen Orchestra):

xe-toolstack-restart

TIP

Restarting XAPI won't affect any running VMs. However, all backup/export tasks will be removed.

# Modifications

WARNING

Those changes aren't officially supported, and will be also wiped after an ISO upgrade.

# 24h task timeout

Edit the /etc/xapi.conf file, and uncomment/change pending_task_timeout from:

# pending_task_timeout = 86400 # 1 day in seconds

To:

pending_task_timeout = 172800

TIP

In this example, 172800 seconds means two days.

After changing the configuration, don't forget to restart the toolstack with xe-toolstack-restart.