Difference between revisions of "Deployment Platform/Client Configuration"
(Created page with "== Summary == This page describes the {{Code|sweets.conf}} configuration file, the common way to configure Sugar clients within the Sweets Distribution, thus, [[Deploymen...") |
|||
| (5 intermediate revisions by the same user not shown) | |||
| Line 7: | Line 7: | ||
The configuration occurs based on several sources (sorted by applied order): | The configuration occurs based on several sources (sorted by applied order): | ||
| + | * {{Code|/etc/sweets.d}}<br>directory with system-wide configuration files, | ||
* {{Code|/etc/sweets.conf}}<br>system-wide configuration file, | * {{Code|/etc/sweets.conf}}<br>system-wide configuration file, | ||
* {{Code|~/.config/sweets/config}}<br>user-wide configuration file, | * {{Code|~/.config/sweets/config}}<br>user-wide configuration file, | ||
| Line 16: | Line 17: | ||
This is a list of configuration sections in {{Code|sweets.conf}} files. Each section belongs to particular application and might be optional in the final system. | This is a list of configuration sections in {{Code|sweets.conf}} files. Each section belongs to particular application and might be optional in the final system. | ||
| + | |||
| + | <div id="main"><big>'''[main]'''</big></div> | ||
| + | |||
| + | General purpose section. | ||
| + | |||
| + | * {{Code|debug}}<br>Logging verbosity level: | ||
| + | :: {{Code|0}}, log only errors and warning, | ||
| + | :: {{Code|1}}, additionally log info messages, | ||
| + | :: {{Code|2}}, additionally log debug messages, | ||
| + | :: {{Code|3}}, additionally log trace messages. | ||
<div id="client"><big>'''[client]'''</big></div> | <div id="client"><big>'''[client]'''</big></div> | ||
Configure [[Platform_Team/Sugar_Network/Implementation#sugar-network-client|sugar-network-client]], a [[Sugar Network]] client application from {{Code|sugar-network}} package. To get the full list of available configure options, call the {{Code|sugar-network-client config}} command. | Configure [[Platform_Team/Sugar_Network/Implementation#sugar-network-client|sugar-network-client]], a [[Sugar Network]] client application from {{Code|sugar-network}} package. To get the full list of available configure options, call the {{Code|sugar-network-client config}} command. | ||
| + | |||
| + | <div id="stabilities"><big>'''[stabilities]'''</big></div> | ||
| + | |||
| + | One more [[Sugar Network]] related section. By default, only stable Sugar Activity implementations will be fetched from the Sugar Network. To customize stability selection, add exceptions to the this section. Each option should conform the format {{Code|CONTEXT <nowiki>=</nowiki> [[Sugar_Network/Recipe_Specification#Software_stability_levels|STABILITIES]]}}. | ||
| + | |||
| + | For example: | ||
| + | |||
| + | [stabilities] | ||
| + | org.somosazucar.ServidorVNC = stable,testing | ||
<div id="shell"><big>'''[shell]'''</big></div> | <div id="shell"><big>'''[shell]'''</big></div> | ||
| Line 25: | Line 45: | ||
Configure Sugar Shell extra functionality implemented by version packaged in Sweets Distribution. There are the following settings: | Configure Sugar Shell extra functionality implemented by version packaged in Sweets Distribution. There are the following settings: | ||
| − | * {{Code|plugins}}<br>Space separated list of [[Deployment_Platform/ | + | * {{Code|plugins}}<br>Space separated list of [[Deployment_Platform/Shell_Plugins|Shell plugins]] to enable. |
<div id="blacklist"><big>'''[blacklist]'''</big></div> | <div id="blacklist"><big>'''[blacklist]'''</big></div> | ||
| − | [[Deployment_Platform/ | + | [[Deployment_Platform/Blacklist_Shell_Components|Blacklist]] Sugar Shell components. |
<div id="sugar-plugin"><big>'''[sugar-plugin-*]'''</big></div> | <div id="sugar-plugin"><big>'''[sugar-plugin-*]'''</big></div> | ||
| − | Configure particular [[Deployment_Platform/ | + | Configure particular [[Deployment_Platform/Shell_Plugins|Shell plugin]]. |
| + | |||
| + | <div id="sugar-plugin"><big>'''[packagekit-presolve]'''</big></div> | ||
| + | |||
| + | Configure PackageKit [[Deployment_Platform/Package_Management_on_XO|presolve]] backend. | ||
Latest revision as of 15:58, 13 October 2013
Summary
This page describes the sweets.conf configuration file, the common way to configure Sugar clients within the Sweets Distribution, thus, Deployment Platform. Configuration does not intersect with Sugar Shell settings, stored in GConf, and contains parameters related only to new functionality introduced by Sweets Distribution.
Configuration files
The configuration occurs based on several sources (sorted by applied order):
/etc/sweets.d
directory with system-wide configuration files,/etc/sweets.conf
system-wide configuration file,~/.config/sweets/config
user-wide configuration file,~/.sugar/PROFILE/sweets.conf
configuration related to particular Sugar profile.
Configuration files should be formatted as regular INI files.
Configuration sections
This is a list of configuration sections in sweets.conf files. Each section belongs to particular application and might be optional in the final system.
General purpose section.
debug
Logging verbosity level:
0, log only errors and warning,1, additionally log info messages,2, additionally log debug messages,3, additionally log trace messages.
Configure sugar-network-client, a Sugar Network client application from sugar-network package. To get the full list of available configure options, call the sugar-network-client config command.
One more Sugar Network related section. By default, only stable Sugar Activity implementations will be fetched from the Sugar Network. To customize stability selection, add exceptions to the this section. Each option should conform the format CONTEXT = STABILITIES.
For example:
[stabilities] org.somosazucar.ServidorVNC = stable,testing
Configure Sugar Shell extra functionality implemented by version packaged in Sweets Distribution. There are the following settings:
plugins
Space separated list of Shell plugins to enable.
Blacklist Sugar Shell components.
Configure particular Shell plugin.
Configure PackageKit presolve backend.