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 [2018/04/02 09:52]
ionic Add deprecation warning.
doc:howto:nx-libs-betatesting [2020/01/14 16:46] (current)
stefanbaur [Installation Instructions] Added an error-check for /etc/os-release
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'​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. 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 
 + 
 +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 
-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 91:
     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 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 88: 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 98: 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.1522662739.txt.gz · Last modified: 2018/04/02 09:52 by ionic