Skip to content

Install process

Nicolás Kovac edited this page Aug 8, 2019 · 9 revisions

Installation

As of version 2.0.0 of oVirt Desktop Client, the installation process is much simpler, because Python3 allows using native PyQt5-sip and PyQt libraries. In previous versions this had to be built manually.

Below you'll find the installation steps. You can also find a Troubleshooting guide. If you find a different problem please feel free to report it.

On Debian/Ubuntu environments, make sure to install these packages:

python3 python3-dev python3-virtualenv python-virtualenv qt5-default libcurl4-openssl-dev libxml2 libxml2-dev libxslt1-dev libssl-dev virt-viewer

On RHEL environments, make sure to install these packages:

python36 python36-devel python36-virtualenv python36-pip gcc gcc-c++ qt5-qtbase qt5-qtbase-devel libcurl-devel libxml2 libxml2-devel libxslt-devel openssl-devel virt-viewer

Important for RHEL based environments: Please note that in further steps, commands may vary in RHEL based environments. For example, it's likely your virtualenv command will be virtualenv-3.6, and your pip command will be pip-3.6. Please find the correct command in your case.

Now just clone, install a virtualenv with Python3 as the Python executable and install the requirements for the project.

git clone https://github.com/nkovacne/ovirt-desktop-client.git
virtualenv -p python3 --always-copy venv
. venv/bin/activate
pip install --upgrade pip
cd ovirt-desktop-client
pip install -r requirements.txt

Upgrading from version 1.x to 2.x

In previous versions, SIP and PyQt packages needed to be built manually. Furthermore, it was based on Python 2, whereas version >= 2.0.0 is Python 3 based. To upgrade, the fastest way is to pull the 2.0.0 version, destroy the virtualenv and recreate it. Just follow these commands to upgrade.

deactivate (in case you're working in the virtualenv)
rm -rf venv
virtualenv -p python3 --always-copy venv
. venv/bin/activate
pip install --upgrade pip
cd ovirt-desktop-client
git pull
pip install -r requirements.txt

Check the settings.conf.example file just to check if you have all parameters up to date, and add those missing in your settings.conf file.

Clone this wiki locally