A page in your DokuWiki was added or changed. Here are the details:
Date : 2013/05/12 14:18
Browser : Mozilla/5.0 (X11; Linux x86_64; rv:18.0) Gecko/20100101 Firefox/18.0 Iceweasel/18.0.1
IP-Address : 46.115.54.165
Hostname : 46.115.54.165
Old Revision: http://wiki.x2go.org/doku.php/doc:installation:x2gobroker?rev=1368368004
New Revision: http://wiki.x2go.org/doku.php/doc:installation:x2gobroker
Edit Summary:
User : sunweaver
@@ -80,11 +80,12 @@
===== Setting up Config Files =====
==== X2Go Session Broker Config ====
- For a basic configuration with the INI file backend you only need to touch
+ For a basic configuration with the INI file backend and the standalone daemon (recommended for beginners) you only need to touch
* /etc/x2go/x2gobroker.conf
+ * /etc/defaults/x2gobroker-daemon
* /etc/x2go/broker/x2gobroker-sessionprofiles.conf
The X2Go Session Broker uses several more configuration files. Below is a complete list (for
version 0.0.2.x, if not applicable to later versions anymore, please update the below lists):
@@ -96,9 +97,9 @@
[[http://code.x2go.org/gitweb?p=x2gobroker.git;a=blob;f=etc/broker/x2gobroker…]] (don't touch!)
__X2Go Session Broker Daemon:__
- [[http://code.x2go.org/gitweb?p=x2gobroker.git;a=blob;f=debian/x2gobroker-dae…]] (enviroment variables, used to set defaults in Python X2Go Session Broker with impact on the daemon only),
+ **[[http://code.x2go.org/gitweb?p=x2gobroker.git;a=blob;f=debian/x2gobroker-daemon.default|/etc/default/x2gobroker-daemon]]** (enviroment variables, used to set defaults in Python X2Go Session Broker with impact on the daemon only),
[[http://code.x2go.org/gitweb?p=x2gobroker.git;a=blob;f=logrotate/x2gobroker-…]] (rotate broker logfiles)
__X2Go Session Broker WSGI:__
[[http://code.x2go.org/gitweb?p=x2gobroker.git;a=blob;f=etc/x2gobroker-wsgi-a…]] (global implementation, enabled by default)
--
This mail was generated by DokuWiki at
http://wiki.x2go.org/
A page in your DokuWiki was added or changed. Here are the details:
Date : 2013/05/12 13:52
Browser : Mozilla/5.0 (X11; Linux x86_64; rv:18.0) Gecko/20100101 Firefox/18.0 Iceweasel/18.0.1
IP-Address : 46.115.54.165
Hostname : 46.115.54.165
Old Revision: http://wiki.x2go.org/doku.php/doc:installation:x2gobroker?rev=1368365991
New Revision: http://wiki.x2go.org/doku.php/doc:installation:x2gobroker
Edit Summary: [X2Go Session Broker Config]
User : sunweaver
@@ -88,28 +88,28 @@
The X2Go Session Broker uses several more configuration files. Below is a complete list (for version 0.0.2.x, if not applicable to later versions anymore, please update the below lists):
__X2Go Session Broker's Core:__
- /etc/default/python-x2gobroker (enviroment variables, used to set defaults in Python X2Go Session Broker with impact on the daemon __and__ the authentication service),
- **/etc/x2go/x2gobroker.conf** (main configuration file),
-
/etc/x2go/broker/x2gobroker-sessionprofiles.conf (configuration file for the INI file backend),
- /etc/pam.d/x2gobroker (PAM configuration for X2Go Session Broker Authservice),
- /etc/x2go/broker/x2gobroker-loggers.conf (don't touch!)
+ [[http://code.x2go.org/gitweb?p=x2gobroker.git;a=tree;f=debian/python-x2gobro…]] (enviroment variables, used to set defaults in Python X2Go Session Broker with impact on the daemon __and__ the authentication service),
+ **[[http://code.x2go.org/gitweb?p=x2gobroker.git;a=tree;f=etc/x2gobroker.conf|/etc/x2go/x2gobroker.conf]]** (main configuration file),
+ **[[http://code.x2go.org/gitweb?p=x2gobroker.git;a=tree;f=etc/x2go/broker/x2gobroker-sessionprofiles.conf|/etc/x2go/broker/x2gobroker-sessionprofiles.conf]]** (configuration file for the INI file backend),
+ [[http://code.x2go.org/gitweb?p=x2gobroker.git;a=tree;f=pam/x2gobroker|/etc/p…]] (PAM configuration for X2Go Session Broker Authservice),
+
[[http://code.x2go.org/gitweb?p=x2gobroker.git;a=tree;f=etc/x2go/broker/x2gob…]] (don't touch!)
__X2Go Session Broker Daemon:__
- /etc/default/x2gobroker-daemon (enviroment variables, used to set defaults in Python X2Go Session Broker with impact on the daemon only),
- /etc/logrotate.d/x2gobroker-daemon (rotate broker logfiles)
+ [[http://code.x2go.org/gitweb?p=x2gobroker.git;a=tree;f=debian/x2gobroker-dae…]] (enviroment variables, used to set defaults in Python X2Go Session Broker with impact on the daemon only),
+ [[http://code.x2go.org/gitweb?p=x2gobroker.git;a=tree;f=logrotate/x2gobroker-…]] (rotate broker logfiles)
__X2Go Session Broker WSGI:__
- /etc/x2go/x2gobroker-wsgi.apache.vhost (VirtualHost example for the WSGI implementation of X2Go Session Broker)
- /etc/x2go/x2gobroker-wsgi.apache.conf (global implementation, enabled by
default)
- /etc/logrotate.d/x2gobroker-wsgi (rotate WSGI logfile)
+ [[http://code.x2go.org/gitweb?p=x2gobroker.git;a=tree;f=etc/x2gobroker-wsgi-a…]] (global implementation, enabled by default)
+ [[http://code.x2go.org/gitweb?p=x2gobroker.git;a=tree;f=etc/x2gobroker-wsgi.a…]] (VirtualHost example for the WSGI implementation of X2Go Session Broker)
+ [[http://code.x2go.org/gitweb?p=x2gobroker.git;a=tree;f=logrotate/x2gobroker-…]] (rotate WSGI logfile)
__X2Go Session Broker Authentication Service:__
- /etc/default/x2gobroker-authservice (enviroment variables, used to set defaults in Python X2Go Session Broker with impact on the authentication service only),
- /etc/x2go/broker/x2gobroker-authservice-logger.conf (don't touch)
- /etc/logrotate.d/x2gobroker-authservice (rotate the authentication service's logfile)
+
[[http://code.x2go.org/gitweb?p=x2gobroker.git;a=tree;f=debian/x2gobroker-aut…]] (enviroment variables, used to set defaults in Python X2Go Session Broker with impact on the authentication service only),
+ [[http://code.x2go.org/gitweb?p=x2gobroker.git;a=tree;f=etc/x2go/broker/x2gob…]] (don't touch)
+ [[http://code.x2go.org/gitweb?p=x2gobroker.git;a=tree;f=logrotate/x2gobroker-…]] (rotate the authentication service's logfile)
===== Testing Your X2Go Session Broker Setup =====
--
This mail was generated by DokuWiki at
http://wiki.x2go.org/
A page in your DokuWiki was added or changed. Here are the details:
Date : 2013/05/12 13:39
Browser : Mozilla/5.0 (X11; Linux x86_64; rv:18.0) Gecko/20100101 Firefox/18.0 Iceweasel/18.0.1
IP-Address : 46.115.54.165
Hostname : 46.115.54.165
Old Revision: http://wiki.x2go.org/doku.php/doc:installation:x2gobroker?rev=1368365727
New Revision: http://wiki.x2go.org/doku.php/doc:installation:x2gobroker
Edit Summary: [X2Go Session Broker Config]
User : sunweaver
@@ -80,12 +80,16 @@
===== Setting up Config Files =====
==== X2Go Session Broker Config ====
- The X2Go Session Broker uses several configuration files:
+ For a basic configuration with the INI file backend you only need to touch
- __X2Go Session Broker's Core:__
+ * /etc/x2go/x2gobroker.conf
+ * /etc/x2go/broker/x2gobroker-sessionprofiles.conf
+ The X2Go Session Broker uses several more configuration files. Below is a complete list (for version 0.0.2.x, if not applicable to later versions
anymore, please update the below lists):
+
+ __X2Go Session Broker's Core:__
/etc/default/python-x2gobroker (enviroment variables, used to set defaults in Python X2Go Session Broker with impact on the daemon __and__ the authentication service),
**/etc/x2go/x2gobroker.conf** (main configuration file),
/etc/x2go/broker/x2gobroker-sessionprofiles.conf (configuration file for the INI file backend),
/etc/pam.d/x2gobroker (PAM configuration for X2Go Session Broker Authservice),
@@ -105,12 +109,8 @@
/etc/default/x2gobroker-authservice (enviroment variables, used to set defaults in Python X2Go Session Broker with impact on the authentication service only),
/etc/x2go/broker/x2gobroker-authservice-logger.conf (don't touch)
/etc/logrotate.d/x2gobroker-authservice (rotate the authentication service's logfile)
- For a basic configuration with the INI file backend you only need to touch
-
- * /etc/x2go/x2gobroker.conf
- * /etc/x2go/broker/x2gobroker-sessionprofiles.conf
===== Testing Your X2Go Session Broker Setup =====
--
This mail was generated by DokuWiki at
http://wiki.x2go.org/
A page in your DokuWiki was added or changed. Here are the details:
Date : 2013/05/12 13:35
Browser : Mozilla/5.0 (X11; Linux x86_64; rv:18.0) Gecko/20100101 Firefox/18.0 Iceweasel/18.0.1
IP-Address : 46.115.54.165
Hostname : 46.115.54.165
Old Revision: http://wiki.x2go.org/doku.php/doc:installation:x2gobroker?rev=1368365222
New Revision: http://wiki.x2go.org/doku.php/doc:installation:x2gobroker
Edit Summary:
User : sunweaver
@@ -84,31 +84,33 @@
The X2Go Session Broker uses several configuration files:
__X2Go Session Broker's Core:__
- <code>
- /etc/default/python-x2gobroker
- /etc/x2go/x2gobroker.conf
- /etc/x2go/broker/x2gobroker-sessionprofiles.conf
- /etc/pam.d/x2gobroker
- /etc/x2go/broker/x2gobroker-loggers.conf
- </code>
+ /etc/default/python-x2gobroker (enviroment variables, used to set defaults in Python X2Go Session Broker with impact on the daemon __and__ the authentication service),
+ **/etc/x2go/x2gobroker.conf** (main configuration
file),
+ /etc/x2go/broker/x2gobroker-sessionprofiles.conf (configuration file for the INI file backend),
+ /etc/pam.d/x2gobroker (PAM configuration for X2Go Session Broker Authservice),
+ /etc/x2go/broker/x2gobroker-loggers.conf (don't touch!)
+
__X2Go Session Broker Daemon:__
- /etc/default/x2gobroker-daemon
- /etc/logrotate.d/x2gobroker-daemon
+ /etc/default/x2gobroker-daemon (enviroment variables, used to set defaults in Python X2Go Session Broker with impact on the daemon only),
+ /etc/logrotate.d/x2gobroker-daemon (rotate broker logfiles)
__X2Go Session Broker WSGI:__
- /etc/x2go/x2gobroker-wsgi.apache.vhost
- /etc/x2go/x2gobroker-wsgi.apache.conf
- /etc/logrotate.d/x2gobroker-wsgi
+ /etc/x2go/x2gobroker-wsgi.apache.vhost (VirtualHost example for the WSGI implementation of X2Go Session Broker)
+ /etc/x2go/x2gobroker-wsgi.apache.conf (global implementation, enabled by default)
+ /etc/logrotate.d/x2gobroker-wsgi (rotate WSGI logfile)
- __X2Go Session Broker WSGI:__
-
/etc/default/x2gobroker-authservice
- /etc/x2go/broker/x2gobroker-authservice-logger.conf
- /etc/logrotate.d/x2gobroker-authservice
+ __X2Go Session Broker Authentication Service:__
+ /etc/default/x2gobroker-authservice (enviroment variables, used to set defaults in Python X2Go Session Broker with impact on the authentication service only),
+ /etc/x2go/broker/x2gobroker-authservice-logger.conf (don't touch)
+ /etc/logrotate.d/x2gobroker-authservice (rotate the authentication service's logfile)
+ For a basic configuration with the INI file backend you only need to touch
+ * /etc/x2go/x2gobroker.conf
+ * /etc/x2go/broker/x2gobroker-sessionprofiles.conf
===== Testing Your X2Go Session Broker Setup =====
--
This mail was generated by DokuWiki at
http://wiki.x2go.org/
A page in your DokuWiki was added or changed. Here are the details:
Date : 2013/05/12 13:27
Browser : Mozilla/5.0 (X11; Linux x86_64; rv:18.0) Gecko/20100101 Firefox/18.0 Iceweasel/18.0.1
IP-Address : 46.115.54.165
Hostname : 46.115.54.165
Old Revision: http://wiki.x2go.org/doku.php/doc:installation:x2gobroker?rev=1368364373
New Revision: http://wiki.x2go.org/doku.php/doc:installation:x2gobroker
Edit Summary:
User : sunweaver
@@ -75,8 +75,40 @@
With other PAM setups (e.g. ''pam_ldap.so'') root privileges are not required and it is ok to not install ''x2gobroker-authservice''.
Furthermore, X2Go Session Broker can extended by other (non-PAM) authentication methods. The currently available authentication mechanisms in X2Go Session Broker are listed [[http://code.x2go.org/gitweb?p=x2gobroker.git;a=tree;f=x2gobroker/authmechs|…]]
+
+ ===== Setting up Config Files =====
+
+ ==== X2Go Session Broker Config ====
+
+ The X2Go Session Broker uses
several configuration files:
+
+ __X2Go Session Broker's Core:__
+
+ <code>
+ /etc/default/python-x2gobroker
+ /etc/x2go/x2gobroker.conf
+ /etc/x2go/broker/x2gobroker-sessionprofiles.conf
+ /etc/pam.d/x2gobroker
+ /etc/x2go/broker/x2gobroker-loggers.conf
+ </code>
+
+ __X2Go Session Broker Daemon:__
+ /etc/default/x2gobroker-daemon
+ /etc/logrotate.d/x2gobroker-daemon
+
+ __X2Go Session Broker WSGI:__
+ /etc/x2go/x2gobroker-wsgi.apache.vhost
+ /etc/x2go/x2gobroker-wsgi.apache.conf
+ /etc/logrotate.d/x2gobroker-wsgi
+
+ __X2Go Session Broker WSGI:__
+ /etc/default/x2gobroker-authservice
+ /etc/x2go/broker/x2gobroker-authservice-logger.conf
+ /etc/logrotate.d/x2gobroker-authservice
+
+
===== Testing Your X2Go Session Broker Setup =====
--
This mail was generated by DokuWiki at
http://wiki.x2go.org/
A page in your DokuWiki was added or changed. Here are the details:
Date : 2013/05/12 13:12
Browser : Mozilla/5.0 (X11; Linux x86_64; rv:18.0) Gecko/20100101 Firefox/18.0 Iceweasel/18.0.1
IP-Address : 46.115.54.165
Hostname : 46.115.54.165
Old Revision: http://wiki.x2go.org/doku.php/doc:installation:x2gobroker?rev=1368362674
New Revision: http://wiki.x2go.org/doku.php/doc:installation:x2gobroker
Edit Summary:
User : sunweaver
@@ -56,8 +56,27 @@
==== Currently available WebUI frontends ====
* The '''plain''' WebUI frontend: usable with X2Go Client
* The '''uccs''' WebUI frontend: usable with Unity Greeter (experimental)
+
+
+ ===== X2Go Session Broker Authentication Service =====
+
+ Package name: '''x2gobroker-authservice'''
+
+ On Debian based systems:
+
+ <code bash>
+ $ sudo apt-get install x2gobroker-authservice
+ </code>
+
+ The X2Go Session Broker Authentication Service normally gets installed on the machine that also has
''x2gobroker-daemon'' or ''x2gobroker-wsgi'' installed. The broker code itself runs as system user ''x2gobroker'' whereas the authentication service has to run as root. By security design, the functionality of the broker that requires root privileges has been separated from the rest of the broker.
+
+ The X2Go Session Broker Authentication Service requires root privileges for a few PAM based authentication backends. The default installation authenticates against PAM, on default Linux systems, PAM authentication (''pam_unix.so'') requires root privileges by the authentication process.
+
+ With other PAM setups (e.g. ''pam_ldap.so'') root privileges are not required and it is ok to not install ''x2gobroker-authservice''.
+
+ Furthermore, X2Go Session Broker can extended by other (non-PAM) authentication methods. The currently available authentication mechanisms in X2Go Session Broker are listed [[http://code.x2go.org/gitweb?p=x2gobroker.git;a=tree;f=x2gobroker/authmechs|…]]
===== Testing Your X2Go Session Broker Setup =====
@@ -92,14 +111,5 @@
* ''<frontend>'' can be either of [[http://code.x2go.org/gitweb?p=x2gobroker.git;a=blob_plain;f=x2gobroker/web|… available broker WebUI frontends]] (except the files base.py and extras.py all files here are broker WebUI frontends)
* ''<backend>'' can be either of [[http://code.x2go.org/gitweb?p=x2gobroker.git;a=blob_plain;f=x2gobroker/web|… available broker WebUI frontends]]
**Example:** ''http://localhost:8080/plain/zeroconf''
-
-
-
-
-
-
-
-
-
--
This mail was generated by DokuWiki at
http://wiki.x2go.org/
A page in your DokuWiki was added or changed. Here are the details:
Date : 2013/05/12 12:44
Browser : Mozilla/5.0 (X11; Linux x86_64; rv:18.0) Gecko/20100101 Firefox/18.0 Iceweasel/18.0.1
IP-Address : 46.115.54.165
Hostname : 46.115.54.165
Old Revision: http://wiki.x2go.org/doku.php/doc:installation:x2gobroker?rev=1363304973
New Revision: http://wiki.x2go.org/doku.php/doc:installation:x2gobroker
Edit Summary:
User : sunweaver
@@ -1,4 +1,105 @@
====== Installing X2Go Session Broker ======
- FIXME
+ The X2Go Session Broker falls into two components.
+
+ * X2Go Session Broker Daemon/WSGI
+ * X2Go Session Broker Authentication Service
+ * X2Go Session Broker Agent
+
+ X2Go Session Broker can either be installed as a standalone Daemon, or it can be integrated into Apache2 (or other httpd) using '''mod_wsgi'''.
+
+ ===== X2Go Session Broker Daemon =====
+
+ Package name: '''x2gobroker-daemon'''
+
+ On Debian based systems:
+
+ <code bash>
+ $ sudo
apt-get install x2gobroker-daemon
+ </code>
+
+ The standalone daemon setup works out of the box, but can only bind to IP ports greater than 1024. However, for security, the X2Go Session Broker standalone daemon only binds to the IPv4 localhost device.
+
+ Check ''/etc/defaults/x2gobroker-daemon'' for modifying the daemon's bind address.
+
+ ===== X2Go Session Broker WSGI =====
+
+ Package name: '''x2gobroker-wsgi'''
+
+ On Debian based systems:
+
+ <code bash>
+ $ sudo apt-get install x2gobroker-wsgi
+ </code>
+
+ For production deployments, the WSGI based setup is probably preferrable. With Apache2+WSGI you can provide VirtualHost setups with many different broker configurations on the same machine. You can also use the Apache2-way of setting up SSL support.
+
+ With the Apache2+WSGI setup you can integrate the X2Go Session Broker functionality into a complex X2Go Broker site (e.g. with a session configuration WebUI).
+
+ In the source code of X2Go Session Broker we
provide two example configurations for Apache2+X2GoBroker:
+
+ * [[http://code.x2go.org/gitweb?p=x2gobroker.git;a=blob_plain;f=etc/x2gobroker-… Session Broker WSGI support added globally]]
+ * [[http://code.x2go.org/gitweb?p=x2gobroker.git;a=blob_plain;f=etc/x2gobroker-… Session Broker WSGI support as VirtualHost]]
+
+
+ ===== X2Go Session Broker: Backends and Frontends =====
+
+ The concept of X2Go Session Broker as provided in [[http://code.x2go.org/gitweb?p=x2gobroker.git|X2Go Git]] is highly modular. The X2Go Session Broker Daemon can be easily extended with //broker backends// and //WebUI frontends//.
+
+ ==== Currently available broker backends ====
+
+ * ZeroConf backend (name: zeroconf), set up by default, allows one to test the broker and see that client <-> broker configuration basically works
+ * INI File backend (name: inifile), text file (INI format) based configuration of the X2Go Session Broker backend
+
+ Other
broker backends (written in Python) can be added easily if needed. Contact the X2Go developers for further information on custom broker backend development.
+
+ ==== Currently available WebUI frontends ====
+
+ * The '''plain''' WebUI frontend: usable with X2Go Client
+ * The '''uccs''' WebUI frontend: usable with Unity Greeter (experimental)
+
+
+ ===== Testing Your X2Go Session Broker Setup =====
+
+ ==== Enabling Debug Mode ====
+
+ If you want to check the broker funtionality with your web browser, please make sure you have enabled the debug mode of the broker. Make sure that before launching the '''x2gobroker''' executable the environment variable ''X2GOBROKER_DEBUG'' is set to 1.
+
+ On Debian based systems, this can be done in ''/etc/defaults/x2gobroker-daemon'' or the Apache2-WSGI configuration of X2Go Session Broker in ''/etc/x2go/x2gobroker-wsgi.apache.*''. Make sure to restart the corresponding service (x2gobroker-daemon resp. apache2) after you have changed
either of those config files:
+
+ For ''x2gobroker-daemon''...
+
+ <code bash>
+ $ invoke-rc.d x2gobroker-daemon restart
+ </code>
+
+ For Apache2/WSGI/X2Go Session Broker setup...
+
+ <code bash>
+ $ invoke-rc.d apache2 restart
+ </code>
+
+ ==== Testing X2Go Session Broker with a Browser ====
+
+ The different backends and frontends can be accessed with this URL pattern:
+
+ <code>
+ http(s)://<broker-base-url>/<frontend>/<backend>
+ </code>
+
+ Where...
+ * ''<broker-base-url>'' is <hostname>:<port>/<broker-base-path>
+ * ''<frontend>'' can be either of [[http://code.x2go.org/gitweb?p=x2gobroker.git;a=blob_plain;f=x2gobroker/web|… available broker WebUI frontends]] (except the files base.py and extras.py all files here are broker WebUI frontends)
+ * ''<backend>'' can be either of [[http://code.x2go.org/gitweb?p=x2gobroker.git;a=blob_plain;f=x2gobroker/web|… available broker WebUI frontends]]
+
+ **Example:** ''http://localhost:8080/plain/zeroconf''
+
+
+
+
+
+
+
+
+
--
This mail was generated by DokuWiki at
http://wiki.x2go.org/