diff --git a/docs/docs/How_Create_Virtual_Machine.rst b/docs/docs/How_Create_Virtual_Machine.rst index 298542c1a..f33b6d517 100644 --- a/docs/docs/How_Create_Virtual_Machine.rst +++ b/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". diff --git a/docs/docs/INSTALL_Debian.rst b/docs/docs/INSTALL_Debian.rst index 64a4d7db3..dd7a5e490 100644 --- a/docs/docs/INSTALL_Debian.rst +++ b/docs/docs/INSTALL_Debian.rst @@ -17,15 +17,15 @@ repository `__. 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 ~~~~~~~~~~ diff --git a/docs/docs/INSTALL_Ubuntu.rst b/docs/docs/INSTALL_Ubuntu.rst index f32604ded..1757329c7 100644 --- a/docs/docs/INSTALL_Ubuntu.rst +++ b/docs/docs/INSTALL_Ubuntu.rst @@ -18,16 +18,16 @@ repository `__. 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: diff --git a/docs/docs/images/macos_spice/a b/docs/docs/images/macos_spice/a new file mode 100644 index 000000000..e69de29bb diff --git a/docs/docs/macos_spice_client.rst b/docs/docs/macos_spice_client.rst new file mode 100644 index 000000000..e7c89770c --- /dev/null +++ b/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 `_. + +Follow this steps: + +1. Install a working (and compiled) version of `virt-viewer `_. You may view the homebrew package's upstream source on `GitHub `_. + +:: + + 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 diff --git a/docs/docs/res/ravada_installer.sh b/docs/docs/res/ravada_installer.sh index b71ac2eb0..8952c4212 100644 --- a/docs/docs/res/ravada_installer.sh +++ b/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 diff --git a/docs/docs/update.rst b/docs/docs/update.rst index 2b145974f..8ad973107 100644 --- a/docs/docs/update.rst +++ b/docs/docs/update.rst @@ -18,7 +18,7 @@ ETSETB repository `__. .. 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 diff --git a/docs/docs/update_safe.rst b/docs/docs/update_safe.rst index a4351aad8..9c2834819 100644 --- a/docs/docs/update_safe.rst +++ b/docs/docs/update_safe.rst @@ -47,7 +47,7 @@ ETSETB repository `__. .. 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 diff --git a/docs/index.rst b/docs/index.rst index 049dbdbe1..84633e242 100644 --- a/docs/index.rst +++ b/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 diff --git a/index.html b/index.html index 47aae1cd5..a0a1d5436 100644 --- a/index.html +++ b/index.html @@ -107,7 +107,7 @@
- Ravada 2.1.7 is out! Go to the install page. + Ravada 2.2.1 is out! Go to the install page.
@@ -662,8 +662,8 @@

Around the Web