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
Last revision Both sides next revision
doc:howto:nx-libs-betatesting [2018/04/02 09:52]
ionic Add deprecation warning.
doc:howto:nx-libs-betatesting [2020/01/14 16:44]
stefanbaur [What is Arctica and what do they have to do with X2Go and NX-Libs?]
Line 2: Line 2:
  
 ===== 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? =====
- 
-<note warning>The information on this page is outdated. X2Go now uses nx-libs as released by Arctica Project.</note> 
  
 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. 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.
Line 12: 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 21: 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>
-# add the X3Go repo key (Debian only) +#!/bin/bash 
-apt-key adv --recv-keys --keyserver keys.gnupg.net E1F958385BFE2B6E # for Debian+# 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 
 + 
 +. /etc/os-release 
 + 
 +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 
-echo 'deb http://packages.x2go.org/debian jessie main' >>/etc/apt/sources.list.d/x2go.list # for Debian+ 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
  
 # add the Arctica repo key # add the Arctica repo key
-wget -qO - http://packages.arctica-project.org/archive.key | sudo apt-key add -+wget -qO - http://packages.arctica-project.org/archive.key | apt-key add -
  
 # add the Arctica repo # add the Arctica repo
-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/'$ID' '$VERSION_CODENAME' main> /etc/apt/sources.list.d/arctica.list
-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 65: Line 86:
     libcanberra-pulse     libcanberra-pulse
  
-apt-get install -y firefox ubuntu-mate-themes # for Ubuntu +if [ 'ubuntu' = "$ID" ] ; then 
-apt-get install -y firefox-esr mate-themes # for Debian + 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 82: Line 109:
 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 88: Line 115:
  
  
-<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 98: Line 126:
  
 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.txt · Last modified: 2020/01/14 16:46 by stefanbaur