5,705
edits
Changes
Jump to navigation
Jump to search
mLine 10:
Line 10: + Line 45:
Line 46: − + + Line 111:
Line 113: + + + + + + + Line 154:
Line 163: − +
Platform Team/Server Kit/Mace (view source)
Revision as of 05:48, 21 March 2012
, 05:48, 21 March 2012moved Sugar Server Kit/Mace to Platform Team/Server Kit/Mace: Move SSK to HSD
* mace doesn't function like a daemon; it just converts configuration sources to the final configuration on the final server, e.g., as a post procedure after installing packages;
* mace doesn't function like a daemon; it just converts configuration sources to the final configuration on the final server, e.g., as a post procedure after installing packages;
* mace is designed to ease support of intermediate customizing, i.e., the original configuration, provided by an upstream project, might be supplemented (not patched) in the downstream product before deploying it to the final users.
* mace is designed to ease support of intermediate customizing, i.e., the original configuration, provided by an upstream project, might be supplemented (not patched) in the downstream product before deploying it to the final users.
* within the [[Sugar Server Kit]] initiative, mace is intended to support, mostly, only the [[Sugar_Server_Kit/Architecture#Dumb_school_servers|Dumb school servers]] functional model.
== Configuration sources ==
== Configuration sources ==
* {{Code|SRC_ROOT}}, path to the root directory with configuration sources;
* {{Code|SRC_ROOT}}, path to the root directory with configuration sources;
* {{Code|DST_ROOT}}, path to the root directory to place final configuration;
* {{Code|DST_ROOT}}, path to the root directory to place final configuration;
* {{Code|INCLUDE}}, if this variable is set in {{Code|.env}} files, it will be treated as a colon separated list of directories to search for additional configuration sources; if {{Code|INCLUDE}} directories are not absolute, they will be referenced from the [[Sugar_Server_Kit/sugar-server-templates|sugar-server-templates]] root.
* {{Code|INCLUDE}}, if this variable is set in {{Code|.env}} files, it will be treated as a colon separated list of directories to search for additional configuration sources; if {{Code|INCLUDE}} directories are not absolute, they will be referenced from the [[Sugar_Server_Kit/sugar-server-templates|sugar-server-templates]] root;
* {{Code|PWD}}, path to the directory where current source configuration file is located.
=== Keywords ===
=== Keywords ===
mace config
mace config
== Troubleshooting ==
* By default, if mace can't start configuring services with new configuration, it falls back to the old configuration. It might be not very useful in case of investigating new configuration errors. To prevent such behavior use {{Code|-R}} command-line argument and try to start affected service manually (with new configuration):
mace apply -R
/etc/init.d/<SERVICE> start
== Testing routines ==
== Testing routines ==
== Getting involved ==
== Getting involved ==
* [http://bugs.sugarlabs.org/newticket?component=sugar-server-kit Report] on bugs.
* [http://bugs.sugarlabs.org/newticket?component=sugar-server-kit Report bugs].
* Read the [http://api.sugarlabs.org/mace/pages/HACKING.html HACKING] file to know how to contribute with code.
* Read the [http://api.sugarlabs.org/mace/pages/HACKING.html HACKING] file to know how to contribute with code.