Install Ravada from dockers¶
Install Docker and docker-compose on your local machine.
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
It depends on the number and type of virtual machines. For common scenarios are server memory, storage and network bandwidth the most critical requirements.
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.
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 cd 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 root@6c3089f22e77:/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
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.
The Ravada server is now installed, learn how to run and use it.
Check if all dockers are up
- 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
If you run docker-compose with sudo you may have problems with the code inside the docker. It is preferable to exec `docker-compose with your user.
root@6f8d2946c40c:/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
This type of credential error: docker.credentials.errors.InitializationError: docker-credential-secretservice not installed or not available in PATH  Failed to execute script docker-compose
This package fix it, golang-docker-credential-helpers, you must install in your computer.
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.