xenadmin/README.md

XenCenter
=========

![Checks](https://github.com/xenserver/xenadmin/actions/workflows/main.yml/badge.svg)
[![Lines of Code](https://tokei.rs/b1/github/xenserver/xenadmin)](https://github.com/xenserver/xenadmin)

This repository contains the source code for XenCenter.

XenCenter is a Windows-based management tool for Citrix Hypervisor environments,
which enables users to manage and monitor server and resource pools,
and to deploy, monitor, manage, and migrate virtual machines.

XenCenter is written mostly in C#.

Contributions
-------------

The preferable way to contribute patches is to 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
xs-devel@lists.xenserver.org mailing list, with a link to a public git repository
for review. Please see the [CONTRIB](CONTRIB) file for some general guidelines
on submitting changes.

License
-------

This code is licensed under the BSD 2-Clause license. Please see the
[LICENSE](LICENSE) file for more information.

How to build XenCenter
----------------------

To build XenCenter, you need

* the source from xenadmin repository
* Visual Studio 2019
* .NET Framework 4.8

and also some libraries which we do not store in the source tree:

* CookComputing.XmlRpcV2.dll
* Newtonsoft.Json.dll
* DiscUtils.dll
* ICSharpCode.SharpZipLib.dll
* log4net.dll

You can find the source code of these libraries (along with some patches) in
[dotnet-packages](https://github.com/xenserver/dotnet-packages) repository.

To run the [NUnit](http://www.nunit.org/) tests you will need the following libraries:

* nunit.framework.dll
* Moq.dll

which can be obtained from <http://www.nuget.org/>.