Xapi Project's XenAPI Management Toolstack

Xen API (or xapi) is a management stack that configures and controls Xen-enabled hosts and resource pools, and co-ordinates resources within the pool. Xapi exposes the Xen API interface for many languages and is a component of the XenServer project. Xen API is written mostly in OCaml 4.07.

Xapi is the main component produced by the Linux Foundation's Xapi Project.

Build and Install

To build xen-api from source, we recommend using opam with the xs-opam repository (farther explanation in its readme).

1. Install opam and git with your package manager.

2. Clone this repo, and work from it's root.

   git clone https://github.com/xapi-project/xen-api && cd xen-api

3. Figure out what version of ocaml-base-compiler to use.

   • Go to this xs-opam file, and look for "OCAML_VERSION_FULL"

   • Run that line, i.e:

     export OCAML_VERSION_FULL="4.10.1"

4. Setup opam, with your Enviornment (i.e switch).

   opam init
   opam switch create xen-api ocaml-base-compiler.$OCAML_VERSION_FULL
   # This basically "jumps you into" the enviornment you just created:
   eval $(opam env --switch=xen-api --set-switch)

5. Get the Recommended Packages.

   # Add the xs-opam library as the main repo to check for versions at:
   opam repo add xs-opam https://github.com/xapi-project/xs-opam.git
   # Remove the default, because how it handles version conflicts is different:
   opam repo remove default
   # (NOT needed with opam>=2.1.0) Have opam now figure out what versions of each package to use:
   opam pin --yes add . --no-action

6. Install all the Packages.

   PACKAGES="xapi-cli-protocol xapi-client xapi-consts xapi-datamodel xapi-types xapi xe xen-api-sdk xen-api-client xen-api-client-lwt xen-api-client-async xapi-rrdd xapi-rrdd-plugin xapi-rrd-transport xapi-rrd-transport-utils rrd-transport rrdd-plugin rrdd-plugins rrddump gzip http-lib pciutil safe-resources sexpr stunnel uuid xapi-compression xml-light2 zstd vhd-tool xs-toolstack"
   
   # NOT needed with opam>=2.1.0) Install all the dependencies (Including OS):
   opam --yes depext --yes -u $PACKAGES # The first '--yes' is to install depext itself
   # Install the Packages finally:
   opam install $PACKAGES --yes --deps-only --with-test -v
   # Update the current switch. (You're already on the correct one, just refresh it).
   eval $(opam env)

7. Build xen-api.

   ./configure
   make
   make test

The binaries should now be in ./_build/install/default/bin!

Contributions

To contribute patches to xen-api, please fork the repository on Github, and then submit a pull request. If for some reason you can't use Github to submit a pull request, then you may send your patch for review to the xen-api@lists.xenproject.org mailing list, with a link to a public git repository for review. We much prefer Github pull requests, however, and submitting a patch to the mailing list will take much more time for review.

Maintainers

Maintainers can be contacted via this mailing list: xen-api@lists.xenproject.org

Licensing

This software is licensed under the GNU LGPLv2 license. Please see the LICENSE file for more information.