Latest Release
Total Page:16
File Type:pdf, Size:1020Kb
RavadaVDI Sep 22, 2021 Administrator Documentation 1 Ravada delivers 3 2 Who is Ravada meant for? 5 3 Ravada VDI documentation 7 3.1 Install Ravada..............................................7 3.2 Install Ravada in Ubuntu.........................................8 3.3 Install Ravada in Debian......................................... 10 3.4 Install Ravada on Fedora......................................... 12 3.5 Install Ravada - Ubuntu Xenial..................................... 15 3.6 Install Ravada from dockers....................................... 15 3.7 Running Ravada in production...................................... 17 3.8 log file.................................................. 19 3.9 Post Install Recomendations....................................... 20 3.10 Development release........................................... 20 3.11 Add KVM storage pool......................................... 24 3.12 Apache.................................................. 25 3.13 How to import a Virtualbox image.................................... 27 3.14 How to create a Virtual Machine..................................... 28 3.15 How to dump a hard drive to Ravada.................................. 29 3.16 How to Install a LDAP Server...................................... 29 3.17 How to add a KVM template....................................... 30 3.18 New ISO image............................................. 31 3.19 How to import a OpenGnsys image................................... 32 3.20 Integrating Ravada and OpenGnsys................................... 34 3.21 Operation................................................. 40 3.22 Swap Partition.............................................. 42 3.23 Troubleshooting frequent problems................................... 43 3.24 Upgrade Ravada............................................. 46 3.25 Windows SPICE Clients......................................... 47 3.26 How to change the controller driver of a Windows VM to VirtIO.................... 48 3.27 Virtual Machine Manual Migration................................... 48 3.28 Kiosk Mode............................................... 50 3.29 How to do a volatile Virtual Machine.................................. 53 3.30 Ravada Cluster.............................................. 53 3.31 How to make a virtual machine disk sparse............................... 58 3.32 Server Hardware............................................. 58 i 3.33 Cluster Hardware............................................. 61 3.34 Ravada CLI................................................ 61 3.35 Use a CAS login service to login into Ravada.............................. 62 3.36 AppAmor troubles............................................ 63 3.37 Adding Custom Messages........................................ 63 3.38 Create a custom login template..................................... 63 3.39 Create a custom footer template..................................... 64 3.40 Disable Spice Password......................................... 65 3.41 Ravada advanced settings........................................ 66 3.42 New documentation........................................... 69 3.43 Configure LDAP Authentication..................................... 70 3.44 Authentication with Active Directory.................................. 72 3.45 Set access restrictions to Virtual Machines............................... 73 3.46 Test Active Directory........................................... 74 3.47 Tuning Ravada.............................................. 75 3.48 Server Monitoring............................................ 75 3.49 Guide button step-by-step........................................ 79 3.50 Local JS and CSS files instead CDN................................... 80 3.51 Exposing a Virtual Machine....................................... 80 3.52 Exposing Ports from a Virtual Machine................................. 81 3.53 Keeping the Base updated........................................ 83 3.54 Spinoff Clone............................................... 85 3.55 Live web Chatwoot............................................ 88 3.56 Best practices to install Linux Guests in Ravada............................. 90 3.57 Install Alpine Linux........................................... 90 3.58 Install Windows 10............................................ 94 3.59 How to extend a Ravada Windows guest’s disk space.......................... 96 3.60 How to extend a Ravada Linux guest’s disk space............................ 99 3.61 How to enable KVM virsh console access................................ 101 3.62 Reduce the image size after cloning a physical PC........................... 102 3.63 Qemu Guest Agent............................................ 104 3.64 Set Hostname............................................... 105 3.65 Development Tools............................................ 106 3.66 Commit Rules.............................................. 107 3.67 Database Changes............................................ 108 3.68 Editor configuration rules........................................ 109 3.69 Local ISO server............................................. 109 3.70 Run Ravada in development mode.................................... 111 3.71 Testing environment........................................... 112 3.72 How to create tests............................................ 113 3.73 Localization and translation....................................... 117 3.74 Ravada Documentation.......................................... 118 3.75 Frontend Libraries............................................ 118 3.76 Hardening Spice security with TLS................................... 119 ii RavadaVDI The chances are you’re here because you’ve been searching for free Virtual Desktop Infrastructure (VDI) documenta- tion. Whether it is a large or a small project, you can start with VDI and see its benefits right away! We assume you do want to start your VDI project as quickly as possible. Therefore, RAVADA VDI is the perfect software for you! Ravada VDI is a free and open-source project that allows users to connect to a virtual desktop. So it is a VDI broker. Administrator Documentation 1 RavadaVDI 2 Administrator Documentation CHAPTER 1 Ravada delivers By following the documentation and editing some configuration files, you’ll be able to deploy a VM within minutes. 3 RavadaVDI 4 Chapter 1. Ravada delivers CHAPTER 2 Who is Ravada meant for? Ravada is meant for sysadmins who have some background in GNU/Linux, and want to deploy a VDI project. Note: Get started with VDI, without reinventing the wheel. We have written some documentation and hosted it on Read the Docs for you. This documentation is on-going, so if there is something you think is missing, don’t hesitate and drop us a line! In the meantime, we are still improving RAVADA VDI and its documentation, so new sections will be popping out from time to time. Our code uses the AGPL license and it is available on GitHub. 5 RavadaVDI 6 Chapter 2. Who is Ravada meant for? CHAPTER 3 Ravada VDI documentation The main documentation for the site is divided into three main sections: • Administrator Documentation • Feature Documentation • Guest VM section Do you feel like giving us a hand? Here you have all the information you need as a developer: • Developer Documentation 3.1 Install Ravada 3.1.1 Requirements 3.1.2OS Ravada works in any Linux distribution but we only support the package for Ubuntu , Debian and Fedora server. You can also install Ravada using Docker. 3.1.3 Hardware It depends on the number and type of virtual machines. For common scenarios server memory, storage and network bandwidth are 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. However, recent virtualization improvements allow you to overcommit the memory. 7 RavadaVDI Disks The faster the disks, the better. Ravada uses incremental files for the disks images, so clones won’t require many space. Read these recommendations if you want to buy a new dedicated server. 3.1.4 Install Ravada Follow the detailed instructions in this section to install on different operating systems: • Ubuntu • Debian • RedHat Fedora Ravada can be installed from package or using docker. • Docker Follow this guide if you are only upgrading Ravada from a previous version already installed. 3.1.5 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. 3.1.6 Run When Ravada is installed, learn how to run and use it. 3.1.7 Help Struggling with the installation procedure ? We tried to make it easy but let us know if you need assistance. There is also a troubleshooting page with common problems that admins may face. 3.2 Install Ravada in Ubuntu 3.2.1 Upgrade Ravada Follow this guide if you are only upgrading Ravada from a previous version already installed. 3.2.2 Ubuntu Note: We only provide support for Ubuntu 18.04 and 20.04. We provide deb Ubuntu packages on the UPC ETSETB repository. Install the ravada package. Choose the one that matches your OS release: 8 Chapter 3. Ravada VDI documentation RavadaVDI • ravada_1.0.5_ubuntu-18.04_all.deb • ravada_1.0.5_ubuntu-20.04_all.deb When you run dpkg now it may show some errors, it is ok, keep reading. $ wget http://infoteleco.upc.edu/img/debian/ravada_1.0.5_ubuntu-20.04_all.deb $ sudo dpkg -i ravada_1.0.5_ubuntu-20.04_all.deb The last command