Differences

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

--- wiki:advanced:x2goplugin [2013/03/30 06:23]
tobias
+++ wiki:advanced:x2goplugin [2020/05/28 22:58] (current)
danger89
@@ Line 1: / Line 1: @@
+<note warning>**Obsolete page:** x2goplugin is removed without a replacement</note>
 ====== X2Go Browser Plugin ======
-FIXME FIXME FIXME FIXME
+For setting up the X2Go Browser Plugin, you have to set up a //client system//, a //web server// system and an //X2Go server//. Web server and X2Go Server can be on the same machine. In the passages below, we will refer to these three systems by the names //client//, //web server// and //X2Go Server//.
-Needs correct formating of html page contents.
-FIXME FIXME FIXME FIXME
+{{:wiki:advanced:plugin-screenshot.jpg?direct&200 |}}
+{{:wiki:advanced:plugin-screenshot-2.jpg?direct&215 |}}
-Using the packages x2goplugin on the client and x2goplugin-provider on the server offers X2Go's functionality within various Browsers, such as Firefox, Chrome, Konqueror and Epiphany. This happens by providing a special website via a webserver, for example apache. The X2GoPlugin receives its configuration via this website.
+Using the packages ''x2goplugin'' on the client system and ''x2goplugin-provider'' on the web server offers X2Go Client's functionality within various Browsers, such as Firefox, Chrome, Konqueror and Epiphany.
+This happens by providing a special website on the web server, for example with apache, to the client. The X2Go Plugin on the client then receives its X2Go session profile configuration via this website and then offers a login to the X2Go Server configured in the served session profile.
+===== Prerequirements =====
-**Prerequirements:**
 We assume that the appropriate package mirrors have already been configured. Please see [[doc:installation:x2goserver|X2Go Server Installation]] for further information.
-{{:wiki:advanced:plugin-screenshot.jpg?direct&200 |}}
-{{:wiki:advanced:plugin-screenshot-2.jpg?direct&200 |}}
 ===== Client ======
-==== Installation Debian GNU/Linux ====
+==== Installation Ubuntu and Debian GNU/Linux ====
-<code>
+<code bash>
-apt-get install x2goplugin
-</code>
-==== Installation Ubuntu ====
-<code>
 apt-get install x2goplugin
 </code>
+After restarting the browser, the plugin is ready to use.
 ==== Installation Windows ====
-not yet available.
+The X2Go Browser Plugin for Windows is currently in development and will be released soon. Please help us improve the wiki and write installation instructions.
-==== Installation OSX ====
-Not yet available.
-This finishes installing X2GoPlugin for the client. After restarting the browser it is ready to use.
-====== Server ======
+===== Server =====
-==== Installation Debian GNU/Linux ====
+==== Installation Ubuntu / Debian GNU/Linux ====
-<code>
+<code bash>
 apt-get install apache2 x2goplugin-provider
 </code>
-==== Installation Ubuntu ====
+This installs the necessary files and dependencies. The plugin is instantly usable on the server via ''localhost/x2goplugin.html''. Using it on the server is not the desired scenario, so we need to change the configuration. The file ''x2goplugin.html'' lies at ''/usr/share/x2go/plugin/''.
-<code>
+It is recommended to create a backup of the original file before modifying it.
-apt-get install apache2 x2goplugin-provider
-</code>
-This installs the necessary files and dependencies. The plugin is instantly usable on the server via localhost/x2goplugin.html. Using it on the server is not the desired scenario, so we need to change the configuration. The file x2goplugin.html lies at /usr/share/x2go/plugin/.
+==== Quick Setup ====
-It is recommended to create a backup of the original file before modifying it.
+If you want a quick setup, e.g. for testing, best make backup of ''/usr/share/x2go/plugin/x2goplugin.html''. The a bit more complicated, but robust way is described below.
-<code>
+<code bash>
 cp /usr/share/x2go/plugin/x2goplugin.html /usr/share/x2go/plugin/x2goplugin.html.orig
 </code>
-The file's content can then be modified to reflect your own requirements. At a minimum you should substitute "server=localhost" with your server's public IP / hostname. After that you can access X2Go via your browser:
+The file's content can then be modified to reflect your own requirements. At a minimum you should substitute ''server=localhost'' with your server's public IP / hostname. After that you can access X2Go via your browser:
 [[http://<your-server's-IP-or-hostname>/x2goplugin.html]]
@@ Line 63: / Line 55: @@
 This is the original content of the file:
-''<code>''
+<file html x2goplugin.html>
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <html>
@@ Line 111: / Line 103: @@
   </body>
 </html>
-''</code>''
+</file>
-You can certainly also  move the file x2goplugin.html into /var/www. Then it is recommended to remove the link  x2goplugin.conf within /etc/apache2/conf.d, which is just a link to /etc/x2goplugin-apache.conf.
+==== Setup ====
-<code>
+You can certainly also  move the file x2goplugin.html into ''/var/www''. Then it is recommended to remove the link ''x2goplugin.conf'' within ''/etc/apache2/conf.d'', which is just a link to ''/etc/x2goplugin-apache.conf''.
+<code bash>
 ls -al /etc/apache2/conf.d/x2goplugin.conf
 lrwxrwxrwx 1 root root 33 Mär 22 23:42 /etc/apache2/conf.d/x2goplugin.conf -> ../../x2go/x2goplugin-apache.conf
@@ Line 121: / Line 116: @@
 </code>
-This file contains the alias which defines an alias for the url [[http://<your-server's-IP-or-hostname>/x2goplugin.html]]. (The URL http://<your-server's-IP-or-hostname> still delivers the expected file /var/www/index.html.)
+This file contains the alias which defines an alias for the url [[http://<your-server's-IP-or-hostname>/x2goplugin.html]]. (The URL [[http://<your-server's-IP-or-hostname>]] still delivers the expected file ''/var/www/index.html''.)
-<code>
+<code bash>
 cat /etc/x2go/x2goplugin-apache.conf
 Alias /x2goplugin.html /usr/share/x2go/plugin/x2goplugin.html
 </code>

X2Go - everywhere@home

User Tools

Site Tools

Differences

Page Tools