Differences

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

--- doc:howto:nx-libs-betatesting [2017/01/04 15:49]
stefanbaur created
+++ doc:howto:nx-libs-betatesting [2020/01/14 16:46] (current)
stefanbaur [Installation Instructions] Added an error-check for /etc/os-release
@@ Line 1: / Line 1: @@
 ====== How to Betatest a newer NX-Libs version from Arctica ======
-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.
+===== What is Arctica and what do they have to do with X2Go and NX-Libs? =====
-It has been tested with Ubuntu Server 16.04, with the "regular" (non-nightly) Arctica repository.
+The [[https://arctica-project.org/|Arctica Project]] is a fork/spin-off of X2Go, and overlapping with X2Go in several goals as well as the names of the volunteers involved.
-Everything else is still avaiting tests by volunteers like you.
+Currently, one of the most important sub-projects within the Arctica project is the task of updating the NX-Libraries (the code that NoMachines was forced to release under GPL, on which FreeNX, NeatX, X2Go etc. all depend).
+Some X2Go volunteers are joining in on that effort as well, also, there are sponsors involved, namely [[http://theqvd.com/|Qindel/TheQVD]], who work on improving the NX-Libs themselves as well as paying others to do so.
+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.
+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's 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.
+That said, we are heavily interested in finding betatesters, so these new NX-Libs may become part of X2Go proper in the future.
+If you're able and willing to test, then please read on.
+===== Installation Instructions =====
+This should work for Debian (starting with Jessie) as well as for Ubuntu Server (starting with 16.04 LTS).
+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.
 <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-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
-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
-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
-apt-get update
+apt update
 # update the base system to the current package versions
 # 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
-apt-get install -y \
+apt install -y \
     x2goserver \
     x2goserver-xsession \
@@ Line 40: / Line 89: @@
     mate-notification-daemon \
     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
-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:
@@ Line 60: / Line 114: @@
 Next, **disable** XINERAMA in your X2GoClient's session profile(s).
-Note that 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.
+</note>
+<note important>When your first session is up and running, check the following on the server:
+  - ''ps u -C x2goagent'' (identify the pid of your session's x2goagent)
+  - ''grep -e libX11 -e libNX_X11 /proc/<pid>/maps''
+This should only show libraries from the nx installation directory, not from the system.</note>
-For more information regarding the Arctica Nightly Builds, please refer to the following blog entry:
+===== Reporting Bugs =====
-https://sunweavers.net/blog/node/20
+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).
+It may well be possible that your bug report gets forwarded to Arctica, so you might want to subscribe to their mailing list(s) as well.
-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.
+Also, when reporting a bug, please indicate which repositories you were using, and the X2Go/NX/Arctica-related package versions you have installed.

X2Go - everywhere@home

User Tools

Site Tools

Differences

Page Tools