Install Ravada from dockers

Requirements

OS

Install Docker and docker-compose on your local machine.

Note

There are several versions of the Compose file format – 1, 2, 2.x, and 3.x. For now, we use 2.2 keep this in mind https://docs.docker.com/compose/compose-file/

As of now[at the time of writing this doc], we recommend

docker --version
 Docker version 10.7.0, build a872fc2f86
docker-compose --version
 docker-compose version 0.8.0, build d4d1b42b

Hardware

It depends on the number and type of virtual machines. For common scenarios are server memory, storage and network bandwidth the most critical requirements.

Memory

RAM is the main issue. Multiply the number of concurrent workstations by the amount of memory each one requires and that is the total RAM the server must have.

Disks

The faster the disks, the better. Ravada uses incremental files for the disks images, so clones won’t require many space.

Install Ravada from dockers

Follow this steps:

cd ~
mkdir src
git clone https://github.com/UPC/ravada.git
cd ravada/dockerfy
docker-compose pull
docker-compose up -d

Ravada web user

Add a new user for the ravada web. Use rvd_back to create it. It will perform some initialization duties in the database the very first time this script is executed.

Connect to ravada-back docker: (We’ll implement an automatically solution to avoid this case)

~/src/ravada/dockerfy> docker exec -it ravada-back bash
[email protected]:/ravada# PERL5LIB=./lib ./script/rvd_back --add-user admin
admin password: acme
is admin ? : [y/n] y

It’s over! You can connect to: http://localhost:3000

Client

The client must have a spice viewer such as virt-viewer. There is a package for linux and it can also be downloaded for windows.

Run

The Ravada server is now installed, learn how to run and use it.

Dockers troubleshoots

  • Check if all dockers are up
docker-compose ps
  • No such file or directory
    If you see this message remember that the source project must be in your HOME directory inside src directory: ~/src/ravada
[email protected]:/ravada# PERL5LIB=./lib ./script/rvd_back --add-user soporte
bash: ./script/rvd_back: No such file or directory
  • Let’s do a reset:
    We want to return to an initial starting point Remove all dockers and volume associated.
cd ~/src/ravada/dockerfy/utils
./remove_all.sh

Help

Struggling with the installation procedure ? We tried to make it easy but let us know if you need assistance.

Maybe this slides can help you.

There is also a troubleshooting page with common problems that admins may face.