User Tools

Site Tools


doc:howto:nx-libs-betatesting

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
doc:howto:nx-libs-betatesting [2017/01/13 14:57]
stefanbaur [Installation Instructions]
doc:howto:nx-libs-betatesting [2020/01/14 16:46] (current)
stefanbaur [Installation Instructions] Added an error-check for /etc/os-release
Line 10: Line 10:
 From time to time, Arctica will bundle up a release (see e.g. the announcement here: https://sunweavers.net/blog/node/52), but they provide nightly builds as well: https://sunweavers.net/blog/node/20. From time to time, Arctica will bundle up a release (see e.g. the announcement here: https://sunweavers.net/blog/node/52), but they provide nightly builds as well: https://sunweavers.net/blog/node/20.
  
-It is possible to "pimp" X2Go with these newer NX-Libs, though we strongly advise against doing so on a production server.+X2Go bases its NX-Libraries releases on Arctica's release versions, similar to how Debian prefers "stable and well-tested" over "bleeding edge".  
 + 
 +It is possible to "pimp" X2Go with Arctica'NX-Libs, though we strongly advise against doing so on a production server.
  
 Please, try this on a test server, not on your production machine, and always make a backup copy before installing/upgrading. Please, try this on a test server, not on your production machine, and always make a backup copy before installing/upgrading.
Line 19: Line 21:
 ===== Installation Instructions ===== ===== Installation Instructions =====
  
-This should work for Debian Jessie as well as for Ubuntu Server 16.04 - please take note of the distribution-specific differences marked within the text.+This should work for Debian (starting with Jessieas well as for Ubuntu Server (starting with 16.04 LTS).
  
-It has been tested with Ubuntu Server 16.04, with the "regular" (non-nightly) Arctica repository.+It has been tested with Ubuntu Server 16.04 and 18.04, as well as Debian Buster with the "regular" (non-nightly) Arctica repository.
 Everything else is still awaiting tests by volunteers like you. Everything else is still awaiting tests by volunteers like you.
  
 <code> <code>
 +#!/bin/bash
 +# https://wiki.x2go.org/doku.php/doc:howto:nx-libs-betatesting
 +set -e # abort on all errors
 +
 +if ! [ $(id -u) -eq 0 ] ; then
 + echo 'This script must be run as root, or with sudo prefixed to its call.'
 + exit 1
 +fi
 +
 +if [ -f /etc/os-release ] ; then
 + . /etc/os-release
 +else
 + echo '/etc/os-release not found. Unable to detect distribution.'
 + exit 1
 +fi
 +
 +if [ 'debian' != "$ID" ] && [ "ubuntu" != "$ID" ]; then
 + echo 'Unsupported distribution. Only Debian and Ubuntu are supported at the moment.'
 + exit 1
 +fi
 +
 +apt install gnupg -y
 +
 +if [ 'debian' = "$ID" ] ; then
 + # add the X3Go repo key (Debian only)
 + apt-key adv --recv-keys --keyserver keys.gnupg.net E1F958385BFE2B6E
 +fi
 +
 # add the X2Go repo # add the X2Go repo
-add-apt-repository ppa:x2go/ppa # for Ubuntu+if [ 'ubuntu' = "$ID" ] ; then 
 + add-apt-repository ppa:x2go/ppa # for Ubuntu 
 +elif [ 'debian' = "$ID" ] ; then 
 + echo 'deb http://packages.x2go.org/debian '$VERSION_CODENAME' main' >/etc/apt/sources.list.d/x2go.list # for Debian 
 +fi
  
-apt-key adv --recv-keys --keyserver keys.gnupg.net E1F958385BFE2B6E # for Debian +# add the Arctica repo key 
-echo 'deb http://packages.x2go.org/debian jessie main' >>/etc/apt/sources.list.d/x2go.list # for Debian+wget -qO - http://packages.arctica-project.org/archive.key | apt-key add -
  
 # add the Arctica repo # add the Arctica repo
-wget -qO - http://packages.arctica-project.org/archive.key | sudo apt-key add - +echo 'deb http://packages.arctica-project.org/'$ID' '$VERSION_CODENAME' main> /etc/apt/sources.list.d/arctica.list
-echo "deb http://packages.arctica-project.org/ubuntu xenial main" >> /etc/apt/sources.list.d/arctica.list # for Ubuntu +
-echo "deb http://packages.arctica-project.org/debian jessie main" >> /etc/apt/sources.list.d/arctica.list # for Debian+
  
 # OR try the Arctica nightly repo # OR try the Arctica nightly repo
-echo "deb http://packages.arctica-project.org/ubuntu-nightly xenial main" >> /etc/apt/sources.list.d/arctica.list for Ubuntu Nightly +# echo 'deb http://packages.arctica-project.org/'$ID'-nightly '$VERSION_CODENAME' main> /etc/apt/sources.list.d/arctica.list
-echo "deb http://packages.arctica-project.org/debian-nightly jessie main" >> /etc/apt/sources.list.d/arctica.list # for Debian Nightly+
  
 # update the package list before installing anything # update the package list before installing anything
-apt-get update+apt update
  
 # update the base system to the current package versions # update the base system to the current package versions
 # Download everything first, then upgrade, then dist-upgrade # Download everything first, then upgrade, then dist-upgrade
-apt-get dist-upgrade -d -y && \ +apt dist-upgrade -d -y 
-apt-get upgrade -y && \ +apt upgrade -y 
-apt-get dist-upgrade -y+apt dist-upgrade -y
  
 # Install X2Go packages, a minimal MATE Desktop, and Firefox as test application # Install X2Go packages, a minimal MATE Desktop, and Firefox as test application
-apt-get install -y \+apt install -y \
     x2goserver \     x2goserver \
     x2goserver-xsession \     x2goserver-xsession \
Line 58: Line 89:
     mate-notification-daemon \     mate-notification-daemon \
     mate-screensaver \     mate-screensaver \
-    libcanberra-pulse +    libcanberra-pulse
-    firefox +
- +
-apt-get install -y ubuntu-mate-themes # for Ubuntu +
-apt-get install -y mate-themes # for Debian+
  
 +if [ 'ubuntu' = "$ID" ] ; then
 + apt install -y firefox ubuntu-mate-themes # for Ubuntu
 +fi
 +if [ 'debian' = "$ID" ] ; then
 + apt install -y firefox-esr mate-themes # for Debian
 +fi
  
 # add a user # add a user
-useradd -m -s /bin/bash <username> +if ! id -u x2gotestaccount ; then 
-passwd <username> + useradd -m -s /bin/bash x2gotestaccount 
-</code>+ echo 'Please set a password for user "x2gotestaccount".' 
 + passwd x2gotestaccount 
 +fi 
 +echo 'Setup complete.'</code>
  
 On the X2GoServer, edit /etc/x2go/x2goagent.options: On the X2GoServer, edit /etc/x2go/x2goagent.options:
Line 78: Line 114:
 Next, **disable** XINERAMA in your X2GoClient's session profile(s). Next, **disable** XINERAMA in your X2GoClient's session profile(s).
  
-<note important>You should also add the Arctica repo on the client where you wish to use X2GoClient, and run ''apt-get update && apt-get dist-upgrade -d -y && apt-get upgrade -y && apt-get dist-upgrade -y'' on it.+<note important>You should also add the Arctica repo on the client where you wish to use X2GoClient, and run ''apt update && apt dist-upgrade -d -y && apt upgrade -y && apt dist-upgrade -y'' on it.
  
 If you don't/can't do that (e.g. because you're running Windows or macOS on your client), connecting with X2GoClient 4.0.5.2 should still work, though you might not experience all the benefits of the new NX-Libs. If you don't/can't do that (e.g. because you're running Windows or macOS on your client), connecting with X2GoClient 4.0.5.2 should still work, though you might not experience all the benefits of the new NX-Libs.
Line 84: Line 120:
  
  
-<note important>When your first session is up and running check the following on the server:+<note important>When your first session is up and runningcheck the following on the server:
   - ''ps u -C x2goagent'' (identify the pid of your session's x2goagent)   - ''ps u -C x2goagent'' (identify the pid of your session's x2goagent)
   - ''grep -e libX11 -e libNX_X11 /proc/<pid>/maps''   - ''grep -e libX11 -e libNX_X11 /proc/<pid>/maps''
  
 This should only show libraries from the nx installation directory, not from the system.</note> This should only show libraries from the nx installation directory, not from the system.</note>
 +
 ===== Reporting Bugs ===== ===== Reporting Bugs =====
 Please follow the instructions listed at [[wiki:bugs#reporting_bugs|Reporting Bugs]].  Do subscribe to the X2Go-Dev Mailing List beforehand, please (instructions on how to do that are linked within that page). Please follow the instructions listed at [[wiki:bugs#reporting_bugs|Reporting Bugs]].  Do subscribe to the X2Go-Dev Mailing List beforehand, please (instructions on how to do that are linked within that page).
Line 94: Line 131:
  
 Also, when reporting a bug, please indicate which repositories you were using, and the X2Go/NX/Arctica-related package versions you have installed. Also, when reporting a bug, please indicate which repositories you were using, and the X2Go/NX/Arctica-related package versions you have installed.
- 
-===== Credits =====  
-Most of the content of the initial revision of this page stems from an E-Mail by Walid Moghrabi, with some additional remarks by Ulrich Sibiller. 
doc/howto/nx-libs-betatesting.1484319425.txt.gz · Last modified: 2017/01/13 14:57 by stefanbaur