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 [2018/04/02 09:52]
ionic Add deprecation warning. 		doc:howto:nx-libs-betatesting [2020/01/14 16:46]
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 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. 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 running, check 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.txt · Last modified: 2020/01/14 16:46 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