diff --git a/web/support/FAQ.rst b/web/support/FAQ.rst index 9600425cb66bb45695b297278504edccbd2dcead..4e6e1327eab58ead84b7eb87a464db888ca4406b 100644 --- a/web/support/FAQ.rst +++ b/web/support/FAQ.rst @@ -651,128 +651,3 @@ I have registered through the Form-based registration and now I am trying to log ------------------------------------------------------------------------------------------------------------------------------------------------- Please enter `cloudusers` in the domain field. - -How to get a Graphical GUI for your OpenStack VM (tested on Ubuntu 20.04 server) ----------------------------------------------------------------------------- -This FAQ explains how to install a grphical Environment and VNC on an OpenStack instance and how to access -it without exposing VNC service to the Internet. -<<<<<<< HEAD - -Requirements for local machine: - -- a VNC Client (Remmina, TigerVNC, ChickenOfTheVNC...) -- an SSH Client - -The following instructions work straightforward on Linux and MacOS; on Windows some adjustments are required, -it depends on your SSH Client. - -**XFCE4 Desktop Environment** - -1. SSH login to your OpenStack VM -2. install XFCE4: `sudo apt-get install xfce4 xfce4-goodies gnome-icon-theme tigervnc-standalone-server` - (if you need a more complete desktop environment then install also **xubuntu-desktop**) -3. create a .vnc folder in your user home: `mkdir .vnc` -4. create xstartup file in `~/.vnc/` and paste the following content: - :: - #!/bin/bash - xrdb $HOME/.Xresources - startxfce4 & - :: -======= -Requirements for local machine: -- a VNC Client (Remmina, TigerVNC, ChickenOfTheVNC...) -- an SSH Client -The following instructions work straightforward on Linux and MacOS; on Windows some adjustements are required, -it depends on your SSH Client. - -**XFCE4 Desktop Environment** -1. SSH login to your OpenStack VM -2. install XFCE4: `sudo apt-get install xfce4 xfce4-goodies gnome-icon-theme tigervnc-standalone-server` - [if you need a more complete desktop environment then install also **xubuntu-desktop**] -3. create a .vnc folder in your user home: `mkdir .vnc` -4. create xstartup file in `~/.vnc/` and paste the following content: -:: - #!/bin/bash - xrdb $HOME/.Xresources - startxfce4 & :: - ->>>>>>> a8b95fcb81306a46acdf78f5005341aaa1839086 -5. run `vncpasswd` and set VNC password (you can skip the viewer password) -6. run `vncserver -geometry WIDTHxHEIGHT -localhost yes -rfbport PORT`, replace **WIDTH** and **HEIGHT** with - desired values (ex: 1024x768) and PORT (ex: 5901, default port) -7. on your local machine run: `ssh -L LOCAL_PORT:127.0.0.1:PORT USER@VM_IP`; choose a port and replace -<<<<<<< HEAD - **LOCAL_PORT** with a valid port; replace **PORT** with the same port used in previous step. -======= -**LOCAL_PORT** with a valid port; replace **PORT** with the same port used in previous step. ->>>>>>> a8b95fcb81306a46acdf78f5005341aaa1839086 -8. on your local machine run a VNC Client and connect to **127.0.0.1:LOCAL_PORT**, when required insert VNC password (from step 5) - - -**GNOME Desktop Environment** -<<<<<<< HEAD - -======= ->>>>>>> a8b95fcb81306a46acdf78f5005341aaa1839086 -1. SSH login to your OpenStack VM -2. install XFCE4: `sudo apt-get install ubuntu-gnome-desktop gnome-icon-theme tigervnc-standalone-server` -3. create a .vnc folder in your user home: `mkdir .vnc` -4. create xstartup file in `~/.vnc/` and paste the following content: -<<<<<<< HEAD - :: - #!/bin/sh - # Start Gnome 3 Desktop - [ -x /etc/vnc/xstartup ] && exec /etc/vnc/xstartup - [ -r $HOME/.Xresources ] && xrdb $HOME/.Xresources - vncconfig -iconic & - dbus-launch --exit-with-session gnome-session & - :: -======= -:: - #!/bin/sh - # Start Gnome 3 Desktop - [ -x /etc/vnc/xstartup ] && exec /etc/vnc/xstartup - [ -r $HOME/.Xresources ] && xrdb $HOME/.Xresources - vncconfig -iconic & - dbus-launch --exit-with-session gnome-session & - ->>>>>>> a8b95fcb81306a46acdf78f5005341aaa1839086 -5. run `vncpasswd` and set VNC password (you can skip the viewer password) -6. run `vncserver -geometry WIDTHxHEIGHT -localhost yes -rfbport PORT`, replace **WIDTH** and **HEIGHT** with - desired values (ex: 1024x768) and PORT (ex: 5901, default port) -7. on your local machine run: `ssh -L LOCAL_PORT:127.0.0.1:PORT USER@VM_IP`; choose a port and replace -<<<<<<< HEAD - **LOCAL_PORT** with a valid port; replace **PORT** with the same port used in previous step. -8. on your local machine run a VNC Client and connect to **127.0.0.1:LOCAL_PORT**, when required insert VNC password (from step 5) - - -When you do not need anymore VNC you can stop it; on your OpenStack VM: - -1. run `vncserver --list`, you should get a list of active VNC displays - :: - testuser@test-gui:~$ vncserver --list - - TigerVNC server sessions: - - X DISPLAY # RFB PORT # PROCESS ID - :2 5902 36811 - :: -======= -**LOCAL_PORT** with a valid port; replace **PORT** with the same port used in previous step. -8. on your local machine run a VNC Client and connect to **127.0.0.1:LOCAL_PORT**, when required insert VNC password (from step 5) - -When you do not need anymore VNC you can kill it, on your OpenStack VM: -1. run `vncserver --list`, you should get a list of active VNC displays -:: -testuser@test-gui:~$ vncserver --list - -TigerVNC server sessions: - -X DISPLAY # RFB PORT # PROCESS ID -:2 5902 36811 -:: ->>>>>>> a8b95fcb81306a46acdf78f5005341aaa1839086 -2. kill the proper VNC display: `vncserver -kill :DISPLAY`, replace **DISPLAY** with correct value (ex: 2 in our example) -3. logout - -To restart VNC server just login and follow steps from 6. to 8.. \ No newline at end of file