Differences

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

--- doc:howto:nx-libs-betatesting [2017/01/04 16:11]
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.
-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'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.
@@ Line 19: / Line 21: @@
 ===== 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 Jessie) as 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.
 <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 58: / 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 78: / Line 114: @@
 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.
 </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>
 ===== Reporting Bugs =====
-Please follow the instructions listed at [[wiki: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).
 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.
+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.

X2Go - everywhere@home

User Tools

Site Tools

Differences

Page Tools