User Tools

Site Tools


x2gobroker:conf

Differences

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

Link to this comparison view

Next revision
Previous revision
x2gobroker:conf [2013/05/12 20:20]
sunweaver created
x2gobroker:conf [2013/05/12 22:23] (current)
sunweaver
Line 1: Line 1:
-====== X2Go Session Broker Config File: /etc/x2go/x2gobroker.conf ======+====== X2Go Session Broker Config File: x2gobroker.conf ======
  
 The default version of the ''/​etc/​x2go/​x2gobroker.conf''​ configuration file can be viewed [[http://​code.x2go.org/​gitweb?​p=x2gobroker.git;​a=blob;​f=etc/​x2gobroker.conf|here]]. The default version of the ''/​etc/​x2go/​x2gobroker.conf''​ configuration file can be viewed [[http://​code.x2go.org/​gitweb?​p=x2gobroker.git;​a=blob;​f=etc/​x2gobroker.conf|here]].
Line 5: Line 5:
 It basically is used to do all global session broker configuration stuff. The file contains many and long comments, make sure you read everything thoroughly. It basically is used to do all global session broker configuration stuff. The file contains many and long comments, make sure you read everything thoroughly.
  
-The file ''​x2gobroker.conf''​ falls into a [global] section and several per-backend sections ([zeroconf],​ [inifile], etc.).+The file ''​x2gobroker.conf''​ falls into a [global] section and several per-backend sections ([zeroconf],​ [inifile], etc.). The file format is that of an INI file.
  
 ===== The Global Section of x2gobroker.conf ===== ===== The Global Section of x2gobroker.conf =====
Line 22: Line 22:
 ===== The Backend Sections ===== ===== The Backend Sections =====
  
-Available backend sections are: ''​zeroconf'',​ ''​inifile''​.+Available backend sections are: ''​zeroconf'',​ ''​inifile''​. ​All backends have the following options in common:
  
 +  * ''​enable = {true|false}''​
 +  * ''​auth-mech = pam''​ (can be omitted if default-auth-mech is set to the same authentication mechanism)
 +  * ''​user-db = libnss''​ (can be omitted if default-user-db is set to the same user DB backend)
 +  * ''​group-db = libnss''​ (can be omitted if default-group-db is set to the same group DB backend)
 +
 +If you want to use a certain backend with your X2Go Session Broker setup, make sure to enable it in ''​x2gobroker.conf''​. Otherwise, you will receive 404 http reponse (Not Found) for the backends broker URL.
 +
 +Normally, other options are available for each backend, depending on the characteristics of the backend.
 ==== The ZeroConf Backend ==== ==== The ZeroConf Backend ====
  
Line 34: Line 42:
 </​code>​ </​code>​
  
-In ''/​etc/​x2go/​x2gobroker.conf''​ the only option you can tweak is the ''​desktop-shell''​ option.+In ''/​etc/​x2go/​x2gobroker.conf''​ the only option you can tweak is the ''​desktop-shell''​ option. Its default is set to ''​KDE''​.
  
 ==== The IniFile Backend ==== ==== The IniFile Backend ====
  
-The ''​inifile''​ backend is a broker backend that can be text file based +The ''​inifile''​ backend is a broker backend that can be used to configure several X2Go Server provisionings ​text file based. For the session profile setup it uses an extra file, by default it is using... 
 + 
 +<code bash> 
 +$ editor /​etc/​x2go/​broker/​x2gobroker-sessionprofiles.conf 
 +</​code>​ 
 + 
 +If your ''​x2gobroker-sessionprofiles.conf''​ is located elsewhere, use the this ''​inifile''​ backend'​s option (in ''​x2gobroker.conf''​) to select another file path: 
 + 
 +<​code>​ 
 +[inifile] 
 +... 
 +session-profiles = /​etc/​x2go/​broker/​x2gobroker-sessionprofiles.conf 
 +... 
 +</​code>​ 
 + 
 +The [[http://​code.x2go.org/​gitweb?​p=x2gobroker.git;​a=blob;​f=etc/​broker/​x2gobroker-sessionprofiles.conf|default version]] of the ''​x2gobroker-sessionprofiles.conf''​ file ships many examples, but is not usable out-of-the box. An [[x2gobroker:​inifilebackend|extra wiki page]] has been dedicated to that file. 
 + 
x2gobroker/conf.1368390050.txt.gz · Last modified: 2013/05/12 20:20 by sunweaver