Skip to content

xapi-project/xen-api

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
September 29, 2017 18:08
September 12, 2023 14:24
September 9, 2015 09:10
November 23, 2016 11:23
October 24, 2022 16:42
October 24, 2022 16:42
October 24, 2022 16:42

Xapi Project's XenAPI Management Toolstack

Build

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.