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.

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

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

If you are using an old XenServer version, you may encounter SSL connection issues. This can bypassed by using the unsecure connection instead:

Ezoic

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

### Using wget ###
[18:18 xcp-node-01 ~]# bash -c "$(wget -qO- http://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.

Ezoic

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: admin@admin.net/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.

Ezoic
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: admin@admin.net/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.

Ezoic

Install Xen Orchestra Ubuntu Debian 03

Shell access to the appliance:

$ ssh xoa@192.168.20.24
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:

Ezoic
$ 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.

Ezoic
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.

Ezoic
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.

Ezoic