User Tools

Site Tools


wiki:components:x2goclient

Differences

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

Link to this comparison view

wiki:components:x2goclient [2012/12/06 14:05]
arw [Keyboard Shortcuts]
— (current)
Line 1: Line 1:
-====== X2Go Client - Download/​Installation & Usage ====== 
  
-===== Download ===== 
- 
-==== GNU/Linux ==== 
- 
-=== GNU/Linux package based distribution === 
- 
-Please make sure that you have added the X2Go repository appropriate for your system to your package management system. The required steps are described here:  
- 
-  * [[wiki:​x2go-repository-debian|Debian GNU/Linux]] 
-  * [[wiki:​x2go-repository-ubuntu|Ubuntu GNU/Linux]] 
-  * [[wiki:​x2go-repository-redhat|Redhat GNU/Linux]] 
- 
-=== GNU/Linux with installation from source tarball === 
- 
-The sources of this X2Go component are available as source tarball under this URL:  
- 
-http://​code.x2go.org/​releases/​source/​x2goclient 
- 
-==== MS Windows ==== 
- 
-Windows binaries can be retrieved from: 
- 
-http://​code.x2go.org/​releases/​binary-win32/​x2goclient 
- 
- 
-==== MacOS X ==== 
- 
-MacOS X binaries can be retrieved from: 
- 
-http://​code.x2go.org/​releases/​binary-macosx/​x2goclient 
- 
- 
-===== Installation ===== 
- 
-==== GNU/Linux ==== 
- 
-=== Debian / Ubuntu === 
- 
-The ''​x2goclient''​ package will install x2goclient on your GNU/Linux system and will make sure, that every needed package will be installed as dependency. 
- 
-<​code>​ 
-$ aptitude install x2goclient 
-</​code>​ 
- 
-You can now start X2goClient by typing ''​x2goclient''​ at the command-line or you'll find it inside the "​Internet"​ section of your menu inside your graphical desktop environment. 
- 
-=== Fedora === 
- 
-<note warning>​This is not a supported installation. Do **NOT** expect any support from the developers of x2go, Fedora or Mandriva.</​note>​ 
- 
-There are currently no Fedora packages for X2Go, but there are packages for Mandriva. For this installation all packages were downloaded from http://​www.pbone.net. 
- 
-  - Start a terminal, go to a suitable folder, e g Download. 
-  - Download packages for Mandriva (versions/​file names may have changed):<​code bash>​wget ftp://​ftp.pbone.net/​mirror/​ftp.mandrivauser.de/​rpm/​GPL/​2010.1/​i586/​release/​x2goclient-3.01-3mud2010.1.i586.rpm 
-wget ftp://​ftp.pbone.net/​mirror/​ftp.mandrivauser.de/​rpm/​GPL/​2010.1/​i586/​release/​x2goclient-cli-3.0.1-3mud2010.1.noarch.rpm 
-wget ftp://​ftp.pbone.net/​mirror/​carroll.cac.psu.edu/​pub/​linux/​distributions/​mandrakelinux/​devel/​cooker/​i586/​media/​contrib/​release/​nxproxy-3.3.0-3mdv2010.1.i586.rpm 
-wget ftp://​ftp.pbone.net/​mirror/​carroll.cac.psu.edu/​pub/​linux/​distributions/​mandrakelinux/​devel/​cooker/​i586/​media/​contrib/​release/​libxcomp3-3.3.0-3mdv2010.1.i586.rpm 
-wget ftp://​ftp.pbone.net/​mirror/​carroll.cac.psu.edu/​pub/​linux/​distributions/​mandrakelinux/​devel/​cooker/​i586/​media/​main/​release/​libjpeg8-1.1.1-1-mdv2011.0.i586.rpm</​code>​ 
-  - Install most of the packages with yum (automatically solves dependencies):<​code bash>​sudo yum install nxproxy-3.3.0-3mdv2010.1.i586.rpm libxcomp3-3.3.0-3mdv2010.1.i586.rpm libjpeg8-1.1.1-1-mdv2011.0.i586.rpm perl perl-Proc-Simple perl-Term-ReadPassword qt qt-x11</​code>​ 
-  - Install packages with unmet dependecies ("​perl-base"​ in Mandriva, Fedora calls it "​perl"​):<​code bash>​sudo rpm -ivh --nodeps x2goclient-3.01-3mud2010.1.i586.rpm x2goclient-cli-3.0.1-3mud2010.1.noarch.rpm</​code>​ 
- 
-=== Maemo === 
- 
-FIXME 
- 
-==== MS Windows ==== 
- 
-Download latest [[http://​code.x2go.org/​releases/​binary-win32/​x2goclient/​|x2goclient for Windows]] and install. Administrator rights required. 
- 
-:!: Versions prior to 3.99.0.2 may have problems connecting to x2goserver if an antivirus product is installed on the client (even if it is disabled/​inactive). If you cannot use 3.99.0.2 or later, try using [[http://​code.x2go.org/​releases/​binary-win32/​x2goclient/​pre-git/​x2goclient-3.01-13-setup.exe|version 3.01-13]]. 
- 
-:!: The Windows installer is based on Nullsoft and thus can be called with "/​S"​ (case-sensitive) to perform a silent installation. 
-==== MacOS X ==== 
- 
-FIXME 
- 
-===== Usage ===== 
- 
-The ''​x2goclient''​ application is the client part of X2go. It should be installed on a client computer to access an X2go server running on another machine. 
- 
-<​note>​Formerly,​ localhost access between client and server, that is X2go client==server,​ was not supported, but it seems that this arrangement works quite nice nowadays (since commit 63556d2 2012-02-01, me believes). This is very useful feature for testing and keeping desktop always alive for remote //and// local access.</​note>​ 
- 
-The ''​x2goclient''​ application provides you the possibility to access the remote running desktop, exchange files with it and redirect sound from the session on the server to your local client. ''​x2goclient''​ can be started via the Desktop Environment'​s application menu (section: Internet) or by using the command line in a shell (simply type ''​x2goclient''​ there and hit enter). 
- 
-Quite a few options are available from command line, some of them cannot be configured from within the GUI. For further information on command line options, please check the man page of x2goclient: [[http://​code.x2go.org/​doc/​x2goclient/​man/​man1/​x2goclient.1.html|man x2goclient]]. 
- 
-==== Manual Page ==== 
- 
-''​x2goclient''​ has a UniX manual page: http://​code.x2go.org/​doc/​x2goclient/​man/​man1/​x2goclient.1.html 
- 
-==== Graphical interface ==== 
- 
-After the installation of ''​x2goclient''​ an application link can be found in the menu of your Desktop Environment. On GNU/Linux systems it will be integrated into the ''​Internet''​ menu section. 
- 
-==== Getting started (my first Session Profile) ==== 
- 
-When you launch the ''​x2goclient''​ for the first time, it will start the ''​new session''​ dialogue automatically. On the first tab, fill out the ''​Session Name'',​ type the IP of the host in the ''​Host''​ and add your username to the ''​Login''​ field. If you use a non-standard ssh port on your host, change that as well, in the ''​SSH Port''​ field. 
- 
-Moving down to the ''​Session Type''​ field, select your desktop environment. If your environment is not on the list, use the "​Custom Desktop"​ option, and specify the command that starts the desktop or VM.  
- 
-Lastly, if you are using something other than a US keyboard, go to the ''​Settings''​ tab, and specify the keyboard layout there. Click Ok and start your session by selecting it on the main window. 
- 
-==== Configure Client Settings ==== 
- 
-FIXME 
- 
-<note tip>​Session may not start properly when the server side is GNOME 3. You'll need to select '​Custom desktop'​ in preferences and write an appropriate command. If you first start a local session and look for '​gnome-session'​ in process list (ps ax | grep gnome), you'll get a hint. For example: 
- 
-''​gnome-session --session=gnome-fallback''​ 
- 
-or  
- 
-''​gnome-session --session=gnome-2d''​ 
- 
- 
-YMMV</​note>​ 
- 
-==== Configure Print Settings ==== 
- 
-FIXME 
- 
-==== Keyboard Shortcuts ==== 
- 
-X2Go follows the general keyboard shortcuts of the NX client. In particular: 
- 
-  * Ctrl + Alt + T: terminate session / disconnect 
-  * Ctrl + Alt + F: toggle fullscreen/​windowed 
-  * Ctrl + Alt + M: minimize or maximize fullscreen window 
-  * Ctrl + Alt + arrow keys: move viewport (when remote screen is bigger than client window) 
- 
-Some of these keyboard shortcuts overlap with default shortcuts of e.g. GNOME. See [[nxagent keyboard shortcuts]] for a method to change the X2Go shortcuts.