This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
wiki:advanced:x2goplugin [2013/03/30 00:30] tobias |
wiki:advanced:x2goplugin [2020/05/28 22:58] (current) danger89 |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | <note warning> | ||
+ | |||
====== X2Go Browser Plugin ====== | ====== X2Go Browser Plugin ====== | ||
- | 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 | + | 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//. |
+ | |||
+ | |||
+ | {{: | ||
+ | {{: | ||
+ | |||
+ | Using the packages | ||
+ | |||
+ | This happens by providing a special website | ||
+ | |||
+ | ===== Prerequirements ===== | ||
- | {{:wiki:advanced: | + | We assume that the appropriate package mirrors have already been configured. Please see [[doc:installation:x2goserver|X2Go Server Installation]] for further information. |
- | **Prerequirements: | ||
- | We assume that the appropriate package mirrors for Debian GNU/Linux or Ubuntu have already been configured. Please see [[doc: | ||
===== Client ====== | ===== Client ====== | ||
- | ==== Installation Debian GNU/Linux ==== | + | ==== Installation |
- | < | + | < |
apt-get install x2goplugin | apt-get install x2goplugin | ||
</ | </ | ||
- | ==== Installation | + | After restarting the browser, the plugin is ready to use. |
- | < | + | |
- | apt-get install x2goplugin | + | ==== Installation |
- | </ | + | |
+ | 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. | ||
- | Damit ist die Installation am Client abgeschlossen, | ||
- | ====== Server ====== | ||
- | ==== Installation Debian GNU/Linux ==== | ||
- | < | ||
- | apt-get install apache2 x2goplugin-provider | ||
- | </ | ||
- | ==== Installation Ubuntu ==== | + | ===== Server ===== |
- | < | + | ==== Installation Ubuntu |
+ | < | ||
apt-get install apache2 x2goplugin-provider | apt-get install apache2 x2goplugin-provider | ||
</ | </ | ||
- | This installs the necessary files and dependencies. The plugin is instantly usable on the server via localhost/ | + | This installs the necessary files and dependencies. The plugin is instantly usable on the server via '' |
It is recommended to create a backup of the original file before modifying it. | It is recommended to create a backup of the original file before modifying it. | ||
- | < | + | ==== Quick Setup ==== |
+ | If you want a quick setup, e.g. for testing, best make backup of ''/ | ||
+ | |||
+ | < | ||
cp / | cp / | ||
</ | </ | ||
- | The file's content can then be modified to reflect your own requirements. At a minimum you should substitute | + | The file's content can then be modified to reflect your own requirements. At a minimum you should substitute |
[[http://< | [[http://< | ||
Line 46: | Line 55: | ||
This is the original content of the file: | This is the original content of the file: | ||
- | '' | + | <file html x2goplugin.html> |
< | < | ||
< | < | ||
Line 94: | Line 103: | ||
</ | </ | ||
</ | </ | ||
- | '' | + | </file> |
- | You can certainly also move the file x2goplugin.html into /var/www. Then it is recommended to remove the link x2goplugin.conf within / | + | ==== Setup ==== |
- | < | + | You can certainly also move the file x2goplugin.html into ''/ |
+ | |||
+ | |||
+ | < | ||
ls -al / | ls -al / | ||
lrwxrwxrwx 1 root root 33 Mär 22 23:42 / | lrwxrwxrwx 1 root root 33 Mär 22 23:42 / | ||
Line 104: | Line 116: | ||
</ | </ | ||
- | This file contains the alias which defines an alias for the url http://< | + | This file contains the alias which defines an alias for the url [[http://< |
+ | <code bash> | ||
cat / | cat / | ||
Alias / | Alias / | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | FIXME FIXME FIXME FIXME | ||
- | |||
- | THE BELOW INFORMATION IS NOT UP-TO-DATE, IT HAS TO BE REWRITTEN!!!! | ||
- | |||
- | FIXME FIXME FIXME FIXME | ||
- | |||
- | [[download: | ||
- | |||
- | x2goplugin is a Firefox plugin. | ||
- | |||
- | //On supported systems//, this plugin acts as a web portal which can be used to access an x2go session via Firefox web browser instead of using one of the x2goclients. | ||
- | |||
- | ===== Installation of x2goplugin ===== | ||
- | |||
- | Please visit the webssite http:// | ||
- | |||
- | Currently the x2goplugin is available for the following systems: | ||
- | * Linux 32 bit | ||
- | * Linux 64 bit | ||
- | * Windows 32 bit | ||
- | |||
- | |||
- | ===== Inserting x2goplugin into a webpage ===== | ||
- | |||
- | This is a short tutorial how to integrate the x2go plugin into a website. | ||
- | |||
- | |||
- | ==== building a minimal website ==== | ||
- | |||
- | You'll need a Website to carry the plugin. Please feel free to use your own Website code. This is just a example which should be used to get started: | ||
- | |||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | </ | ||
- | < | ||
- | <div id=" | ||
- | < | ||
- | </ | ||
- | </ | ||
- | </ | ||
</ | </ | ||
- | You can use either use a < | ||
- | |||
- | ==== inserting the < | ||
- | |||
- | Please paste the following code inside your website between the < | ||
- | |||
- | < | ||
- | <object src=" | ||
- | type=" | ||
- | pluginspage=" | ||
- | pluginurl=" | ||
- | name=" | ||
- | palette=" | ||
- | height=" | ||
- | hspace=" | ||
- | vspace=" | ||
- | width=" | ||
- | x2goconfig=" | ||
- | session=mysessionname | ||
- | server=myserver.org | ||
- | user=myusername | ||
- | sshport=22 | ||
- | command=KDE | ||
- | rootless=false | ||
- | sound=true | ||
- | exportfs=true | ||
- | speed=adsl | ||
- | compression=16m-jpeg | ||
- | quality=9 | ||
- | dpi=120 | ||
- | kbdlayout=de | ||
- | kbdtype=pc105/ | ||
- | showtoolbar=true | ||
- | showstatusbar=true | ||
- | "> | ||
- | < | ||
- | </ | ||
- | </ | ||
- | |||
- | |||
- | You can change the the value " | ||
- | |||
- | The value " | ||
- | |||
- | The value " | ||
- | |||
- | The value " | ||
- | |||
- | You can choose the used Desktop Environment or application by changing the value " | ||
- | * If you specify " | ||
- | * If you specify any application (such as: firefox) which is executable by the user then only that application will appear __without__ the entire remote desktop. | ||
- | |||
- | The value " | ||
- | If you plan to use single applications you can use this feature to use the local running window manager. | ||
- | |||
- | |||
- | If you intend to utilize the automatic update service (recommended), | ||
- | |||
- | |||
- | The value " | ||
- | |||
- | ==== checking if the plugin is already installed (and offering it if not) ==== | ||
- | |||
- | If you are visiting the created website, you'll only get a x2goplugin shown if it was previously installed by the user. If not, only a white space will appear. To check whether the plugin is installed or not, we'll need to add a javascript to the website. This too will offer the user the plugin if it wasn't installed before or inform him about the availability. | ||
- | |||
- | Inside the website' | ||
- | |||
- | You should use the plugin directly from our server to make sure that you'll get the latest version. The download url of the x2goplugin can change, because we want to store it on the Mozilla Add On site in future. Of cause you can also download the script here (http:// | ||
- | |||
- | < | ||
- | < | ||
- | < | ||
- | <script src=" | ||
- | </ | ||
- | </ | ||
- | |||
- | The javascript will need to be started, so you should add the the command " | ||
- | |||
- | < | ||
- | <body onload=" | ||
- | </ | ||
- | |||
- | ==== a complete website example ==== | ||
- | |||
- | Your whole Website should now look something like this (This site makes use of an already existing css file on our server. You can also use the <div id=" | ||
- | |||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | <link rel=" | ||
- | <script src=" | ||
- | </ | ||
- | <body onload=" | ||
- | <div id=" | ||
- | <object src=" | ||
- | type=" | ||
- | pluginspage=" | ||
- | pluginurl=" | ||
- | data=" | ||
- | hidden=" | ||
- | name=" | ||
- | palette=" | ||
- | height=" | ||
- | hspace=" | ||
- | vspace=" | ||
- | width=" | ||
- | < | ||
- | </ | ||
- | </ | ||
- | <div id=" | ||
- | < | ||
- | < | ||
- | plugin you'll be able to start or recover a session running on a x2goserver. | ||
- | The server needs to be preconfigured. | ||
- | To get more information about what x2go is, please visit <a href=" | ||
- | </p> | ||
- | </ | ||
- | </ | ||
- | </ | ||
- | </ |