In our recent article we captured installation steps for Xen Orchestra (XO) on an Ubuntu / Debian server by building the packages from source. XO is software built with a server and clients, such as the web client xo-web, but also a CLI capable client, called xo-cli. There is an alternative installation method which involves deployment with Xen Orchestra Virtual Appliance (XOA). This is the installation that will be performed in this guide.

xoa architecture

XOA is a virtual machine with Xen Orchestra already installed, thus intended to work out-of-the-box. The only dependency is a running Xen/XCP-ng hypervisor host with network and storage configurations. There is a bash script to be executed on the hypervisor shell which will download VM appliance and create a new Virtual Machine from it.

Import XOA on XenServer | XCP-ng Server

Start a new SSH session to your XenServer host and run the commands below.

[18:18 xcp-node-01 ~]# bash -c "$(curl -sS https://xoa.io/deploy)"

If you’re using DHCP server on the default network, agree to proceed with the installation:

Welcome to the XOA auto-deploy script!

Network settings:
IP address? [dhcp]

For Static IP address provide all required IP related information such as netmask, gateway, and DNS server.

With the DHCP option, VM importation should start thereafter:

Your XOA will be started using DHCP

Importing XOA VM...

Booting XOA VM...
Waiting for your XOA to be ready…

Your XOA is ready on https://192.168.20.24/

Default UI credentials: [email protected]/admin
Default console credentials: xoa/xoa

VM UUID: 84f59294-a20c-3658-db12-6ed7152c6e08

If you access Xen cluster you should see VM importation in progress.

Install Xen Orchestra on Xen XCP ng from XOA 01

When done a VM named “XOA” should be visible. You can access the shell with the IP address assigned to the instance.

Install Xen Orchestra on Xen XCP ng from XOA 02

The default logins were printed out during XOA importation

Your XOA is ready on https://192.168.20.24/

Default UI credentials: [email protected]/admin
Default console credentials: xoa/xoa

Use the given username and password to login to XO web console.

Install Xen Orchestra Ubuntu Debian 01

Navigate to “Settings” > “Users“ section to update admin password for better security.

Install Xen Orchestra Ubuntu Debian 02

Select admin user and click “edit” under Password section to update user’s password.

Install Xen Orchestra Ubuntu Debian 03

Shell access to the appliance:

$ ssh [email protected]
Linux xoa 4.19.0-13-amd64 #1 SMP Debian 4.19.160-2 (2020-11-28) x86_64
 __   __             ____           _               _
 \ \ / /            / __ \         | |             | |
  \ V / ___ _ __   | |  | |_ __ ___| |__   ___  ___| |_ _ __ __ _
   > < / _ \ '_ \  | |  | | '__/ __| '_ \ / _ \/ __| __| '__/ _` |
  / . \  __/ | | | | |__| | | | (__| | | |  __/\__ \ |_| | | (_| |
 /_/ \_\___|_| |_|  \____/|_|  \___|_| |_|\___||___/\__|_|  \__,_|

Welcome to XOA Unified Edition, with Pro Support.

* Restart XO: sudo systemctl restart xo-server.service
* Display status: sudo systemctl status xo-server.service
* Display logs: sudo journalctl -u xo-server.service
* Register your XOA: sudo xoa-updater --register
* Update your XOA: sudo xoa-updater --upgrade

OFFICIAL XOA DOCUMENTATION HERE: https://xen-orchestra.com/docs/xoa.html

Support available at https://xen-orchestra.com/#!/member/support

In case of issues, use `xoa check` for a quick health check.

Build number: 21.01.02

Based on Debian GNU/Linux 10 (Stable) 64bits in PVHVM mode

Service xo-server should be in a running state:

$ systemctl status xo-server.service
● xo-server.service - XO Server
   Loaded: loaded (/etc/systemd/system/xo-server.service; enabled; vendor preset: enabled)
   Active: active (running) since Tue 2021-04-20 11:25:13 EDT; 19h ago
 Main PID: 504 (node)
    Tasks: 18 (limit: 2331)
   Memory: 144.9M
   CGroup: /system.slice/xo-server.service
           ├─ 504 node /usr/local/bin/xo-server
           └─2285 /usr/local/bin/node /usr/local/lib/node_modules/xo-server/node_modules/jest-worker/build/workers/processChild.js

Check and update if updates are available. But registration is required for updates.

sudo xoa-updater --register
sudo xoa-updater --upgrade

Add XenServer | XCP-ng Server

Add the Xen|XCP-ng server by going to “Home” > “Add server

Install Xen Orchestra Ubuntu Debian 04

Input the server labelIP AddressUsername and Password used to login.

Install Xen Orchestra Ubuntu Debian 05

Confirm connection is successful. The status should automatically turn to “Enabled

Install Xen Orchestra Ubuntu Debian 06

From the console you can get your Xen Cluster details – Pools, Hosts, VMs and usage capacity.

Install Xen Orchestra Ubuntu Debian 07

Similar articles on Xen Virtualization platform.

Install Xen Orchestra on Ubuntu |Debian to Manage Xen/XCP-ng

Add and Use ISO Library Storage Repository in Xen XCP-ng

Managing XCP-ng Hypervisor with XenCenter | XCP-ng Center

Your support is our everlasting motivation,
that cup of coffee is what keeps us going!


As we continue to grow, we would wish to reach and impact more people who visit and take advantage of the guides we have on our blog. This is a big task for us and we are so far extremely grateful for the kind people who have shown amazing support for our work over the time we have been online.

Thank You for your support as we work to give you the best of guides and articles. Click below to buy us a coffee.

LEAVE A REPLY

Please enter your comment!
Please enter your name here