X2Go - everywhere@home

User Tools

Site Tools

Trace:
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/04 16:01]
stefanbaur 		doc:howto:nx-libs-betatesting [2020/01/14 16:46] (current)
stefanbaur [Installation Instructions] Added an error-check for /etc/os-release
Line 3: Line 3:
 ===== What is Arctica and what do they have to do with X2Go and NX-Libs? ===== ===== What is Arctica and what do they have to do with X2Go and NX-Libs? =====
  
-Arctica is a fork/spin-off of X2Go, and overlapping with X2Go in several goals as well as volunteers.+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.
  
-Currently, one of the main 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). +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 Qindel/TheQVD, who both work on improving the NX-Libs themselves as well as paying others to do so.+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. 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 ===== ===== 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 avaiting 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 51: 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 71: 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.
 </note> </note>
  
-</note> + 
-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.+<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|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.
doc/howto/nx-libs-betatesting.1483545691.txt.gz · Last modified: 2017/01/04 16:01 by stefanbaur

Page Tools

Imprint & Legal Disclaimer - Data Protection & Privacy Statement
Except where otherwise noted, content on this wiki is licensed under the following license: GNU Free Documentation License 1.3
GNU Free Documentation License 1.3 Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki