Merge branch 'gh-pages' of github.com:UPC/ravada into gh-pages

docs/docs/How_Create_Virtual_Machine.rst

@@ -10,20 +10,12 @@ Steps
 
 1. First of all, log into Ravada using the username and password you created in previous steps of installation.
 
-.. image:: https://raw.githubusercontent.com/UPC/ravada/master/Images/Virtual_machine_Create_images/0.png
-
 2. on top right of the page, click on "Admin Tools" and then "Machines".
 
-.. image:: https://raw.githubusercontent.com/UPC/ravada/master/Images/Virtual_machine_Create_images/1.png
-
 3. In the new page, click on "New Machine".
 
-.. image:: https://raw.githubusercontent.com/UPC/ravada/master/Images/Virtual_machine_Create_images/2.png
-
 4. Choose a name for your virtual machine and choose an option for the ISO image. The selected image needs to be installed accordingly. 
 
-.. image:: https://raw.githubusercontent.com/UPC/ravada/master/Images/Virtual_machine_Create_images/3.png
-
 5. Now, you can see a list of available machines and the operations of each.
 
 .. note:: Please note that you can see any upcoming error or problems in section "messages".

docs/docs/INSTALL_Debian.rst

@@ -17,15 +17,15 @@ repository <http://infoteleco.upc.edu/img/debian/>`__.
 
 Install the ravada package. It is called *debian-11* but works fine in *debian-12* also.
 
-- ravada_2.1.7_debian-11_all.deb
+- ravada_2.2.1_debian-11_all.deb
 
 When you run dpkg now it may show some errors, it is ok, keep reading.
 
 .. prompt:: bash $
 
-     wget http://infoteleco.upc.edu/img/debian/ravada_2.1.7_debian-11_all.deb
+     wget http://infoteleco.upc.edu/img/debian/ravada_2.2.1_debian-11_all.deb
      sudo apt update
-     sudo apt install ./ravada_2.1.7_debian-11_all.deb
+     sudo apt install ./ravada_2.2.1_debian-11_all.deb
 
 Debian KVM
 ~~~~~~~~~~

docs/docs/INSTALL_Ubuntu.rst

@@ -18,16 +18,16 @@ repository <http://infoteleco.upc.edu/img/debian/>`__.
 
 Install the ravada package. Choose the one that matches your OS release:
 
-- ravada_2.1.7_ubuntu-18.04_all.deb
-- ravada_2.1.7_ubuntu-20.04_all.deb for Ubuntu 20.04 and Ubuntu 22.04
+- ravada_2.2.1_ubuntu-18.04_all.deb
+- ravada_2.2.1_ubuntu-20.04_all.deb for Ubuntu 20.04 and Ubuntu 22.04
 
 When you run dpkg now it may show some errors, it is ok, keep reading.
 
 .. prompt:: bash $
 
-     wget http://infoteleco.upc.edu/img/debian/ravada_2.1.7_ubuntu-20.04_all.deb
+     wget http://infoteleco.upc.edu/img/debian/ravada_2.2.1_ubuntu-20.04_all.deb
      sudo apt-get update
-     sudo apt install ./ravada_2.1.7_ubuntu-20.04_all.deb
+     sudo apt install ./ravada_2.2.1_ubuntu-20.04_all.deb
 
 The last command will show a warning about missing dependencies. Install
 them running:

docs/docs/macos_spice_client.rst

@@ -0,0 +1,92 @@
+SPICE client setup for MacOS
+============================
+
+Virt-Viewer
+===========
+If you don't have brew installed, visit `Homebrew <https://brew.sh/>`_.
+
+Follow this steps:
+
+1. Install a working (and compiled) version of `virt-viewer <https://www.spice-space.org/osx-client.html>`_. You may view the homebrew package's upstream source on `GitHub <https://github.com/UPC/homebrew-virt-manager>`_.
+
+::
+
+	brew tap UPC/homebrew-virt-manager
+	brew install virt-manager virt-viewer
+
+2. Once that's installed should be able make a call **remote-viewer** with a spice file, for example 405.vv file downloaded from Ravada.
+
+::
+
+	remote-viewer 405.vv
+	
+
+Associate SPICE files with remote viewer
+========================================
+
+We want remote-viewer to automatically start and open the session when we double click the VM entry in Ravada. To do that we need to first create a small helper application.
+
+1. Launch Automator and select Application from the dropdown list, when prompted.
+
+2. Search for shell and drag to the right. The contents:
+
+::
+
+	/usr/local/bin/remote-viewer "$@"
+
+Make sure to select as arguments for passing the input. Save as **~/Applications/ravada-spice-launcher.app**
+
+3. Locate a ravada spice file .vv file or any file with .vv extension, and then hold down the Control key. With the Control key pressed, click on the .vv file, and then right click, open with, look for the .app file you just made, and check the Always Open With checkbox in the bottom of the dialog. This took a couple of tries for it to stick, but eventually remembered.
+
+In Chrome, click on the small arrow on the list of downloads at the bottom, and select "Always open files of this type" and select ravada-spice-launcher app.
+
+If everything is set up correctly you should be able to double-click on the VM and remote-viewer should start up and take care of the rest.
+
+That's all. Enjoy Ravada.
+
+
+There is another way to do it if you have some troubles, install only RemoteViewer.
+
+RemoteViewer
+============
+
+::
+
+	brew install --cask remoteviewer
+
+Usage:
+ remote-viewer console.vv
+
+Binary path in my env is /opt/homebrew/bin/remote-viewer.
+
+Remember to allow this application in Settings -> Privacy & Security
+
+You can see this message: 
+"RemoteViewer.app" was blocked from use because it is not from an identified developer
+Enable the button: Open Anyway
+
+
+
+Problems
+========
+
+1. If you have some trouble, check your remote-viewer path. Maybe it is different from /usr/local/bin. 
+
+::
+ 
+ 	which remote-viewer
+
+Other path can be: /opt/homebrew/bin/remote-viewer
+
+
+2. You have a similar repo installed. 
+
+::  
+
+	Error: Formulae found in multiple taps:
+
+Fix with:
+
+ ::
+ 	
+	brew untap jeffreywildman/virt-manager

docs/docs/res/ravada_installer.sh

@@ -35,8 +35,8 @@ if [[ $OS = *"Ubuntu"* && $VER > '16.04' ]]; then
   echo "Downloading..."
   sudo apt-get install libmojolicious-plugin-renderfile-perl -y &> /dev/null
 
-  wget http://infoteleco.upc.edu/img/debian/ravada_2.1.7_ubuntu-18.04_all.deb
-  sudo dpkg -i ravada_2.1.7_ubuntu-18.04_all.deb &> /dev/null
+  wget http://infoteleco.upc.edu/img/debian/ravada_2.2.1_ubuntu-18.04_all.deb
+  sudo dpkg -i ravada_2.2.1_ubuntu-18.04_all.deb &> /dev/null
   echo "Installing Dependencies..."
   sudo apt-get update -y &> /dev/null
   sudo apt-get -f -y install &> /dev/null
@@ -136,8 +136,8 @@ elif [[ $OS = *"Ubuntu"* ]]; then
   wget http://infoteleco.upc.edu/img/debian/libmojolicious-plugin-renderfile-perl_0.10-1_all.deb &> /dev/null
 	sudo dpkg -i libmojolicious-plugin-renderfile-perl_0.10-1_all.deb &> /dev/null
 
-  wget http://infoteleco.upc.edu/img/debian/ravada_2.1.7_all.deb &> /dev/null
-  sudo dpkg -i ravada_2.1.7_all.deb &> /dev/null
+  wget http://infoteleco.upc.edu/img/debian/ravada_2.2.1_all.deb &> /dev/null
+  sudo dpkg -i ravada_2.2.1_all.deb &> /dev/null
   echo "Installing Dependencies..."
   sudo apt-get update -y &> /dev/null
   sudo apt-get -f -y install &> /dev/null

docs/docs/update.rst

@@ -18,7 +18,7 @@ ETSETB repository <http://infoteleco.upc.edu/img/debian/>`__.
 
 .. prompt:: bash
 
-    wget http://infoteleco.upc.edu/img/debian/ravada_2.1.7_ubuntu-20.04_all.deb
+    wget http://infoteleco.upc.edu/img/debian/ravada_2.2.1_ubuntu-20.04_all.deb
 
 
 Step 2
@@ -28,7 +28,7 @@ Install the *deb* package.
 
 .. prompt:: bash
 
-    sudo apt install ./ravada_2.1.7_ubuntu-20.04_all.deb
+    sudo apt install ./ravada_2.2.1_ubuntu-20.04_all.deb
 
 
 On some upgrades may be required to install some dependencies. You will see

docs/docs/update_safe.rst

@@ -47,7 +47,7 @@ ETSETB repository <http://infoteleco.upc.edu/img/debian/>`__.
 
 .. prompt:: bash
 
-    wget http://infoteleco.upc.edu/img/debian/ravada_2.1.7_ubuntu-20.04_all.deb
+    wget http://infoteleco.upc.edu/img/debian/ravada_2.2.1_ubuntu-20.04_all.deb
 
 
 Step 4.2: Install
@@ -57,7 +57,7 @@ Install the *deb* package.
 
 .. prompt:: bash
 
-    sudo apt install ./ravada_2.1.7_ubuntu-20.04_all.deb
+    sudo apt install ./ravada_2.2.1_ubuntu-20.04_all.deb
 
 
 On some upgrades may be required to install some dependencies. You will see

docs/index.rst

@@ -85,6 +85,7 @@ Do you feel like giving us a hand? Here you have all the information you need as
    docs/update_rollback
    docs/windows_clients
    docs/mac_clients
+   docs/macos_spice_client
    docs/change_windows_driver_to_virtio
    docs/Backup
    docs/migrate_manual

index.html

@@ -107,7 +107,7 @@
     <!-- /.container-fluid -->
 </nav>
         <div class="tease">
-            Ravada 2.1.7 is out!  Go to the <a target="_blank" href="http://ravada.readthedocs.io/en/latest/docs/INSTALL.html">install</a> page.
+            Ravada 2.2.1 is out!  Go to the <a target="_blank" href="http://ravada.readthedocs.io/en/latest/docs/INSTALL.html">install</a> page.
         </div>
         <!-- Header -->
 <header>
@@ -662,8 +662,8 @@ <h3>Around the Web</h3>
             <div class="footer-col col-md-6">
               <h3>About Ravada</h3>
               <p>Ravada is a free to use, open source  VDI project.</p>
-                <a href="https://github.com/UPC/ravada/blob/release/2.1.7/CHANGELOG.md"><img
-                src="https://img.shields.io/badge/Version-ravada--2.1.7-green.svg"></a>
+                <a href="https://github.com/UPC/ravada/blob/release/2.2.1/CHANGELOG.md"><img
+                src="https://img.shields.io/badge/Version-ravada--2.2.1-green.svg"></a>
                 <a href='http://ravada.readthedocs.io/en/latest/?badge=latest'><img src='https://readthedocs.org/projects/ravada/badge/?version=latest' alt='Documentation Status' /></a>  
                 <a href="https://hosted.weblate.org/engage/ravada/"><img src="https://hosted.weblate.org/widgets/ravada/-/svg-badge.svg" alt="Translation status" /></a>
                 <a href="https://github.com/UPC/ravada/blob/master/LICENSE"><img src="https://img.shields.io/badge/License-AGPL%20v3-blue.svg"></a>