<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
	<id>https://wiki.open-xchange.com/wiki/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Owen.stevens</id>
	<title>Open-Xchange - User contributions [en]</title>
	<link rel="self" type="application/atom+xml" href="https://wiki.open-xchange.com/wiki/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Owen.stevens"/>
	<link rel="alternate" type="text/html" href="https://wiki.open-xchange.com/wiki/index.php?title=Special:Contributions/Owen.stevens"/>
	<updated>2026-11-16T10:41:17Z</updated>
	<subtitle>User contributions</subtitle>
	<generator>MediaWiki 1.39.7</generator>
	<entry>
		<id>https://wiki.open-xchange.com/wiki/index.php?title=Template:OXLoadBalancingClustering_OXConfiguration&amp;diff=24879</id>
		<title>Template:OXLoadBalancingClustering OXConfiguration</title>
		<link rel="alternate" type="text/html" href="https://wiki.open-xchange.com/wiki/index.php?title=Template:OXLoadBalancingClustering_OXConfiguration&amp;diff=24879"/>
		<updated>2019-08-27T15:22:04Z</updated>

		<summary type="html">&lt;p&gt;Owen.stevens: /* Configuring Open-Xchange Server */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;== Configuring Open-Xchange Server ==&lt;br /&gt;
Install all relevant Open-Xchange Server packages to both groupware nodes after adding the Open-Xchange software repository to your package manages configuration. Corresponding installation instructions for your distribution can be found here:&lt;br /&gt;
&lt;br /&gt;
{{#if:{{{release|}}}|&lt;br /&gt;
{{#ifeq:{{{release|}}}|6.22|&lt;br /&gt;
&lt;br /&gt;
* [[Open-Xchange_Installation_Guide_for_Debian_6.0_622|Download and Installation Guide for Debian GNU/Linux 6.0 (Squeeze)]]&lt;br /&gt;
* [[Open-Xchange_Installation_Guide_for_SLES11_622|Download and Installation Guide for SUSE Linux Enterprise Server 11]]&lt;br /&gt;
* [[Open-Xchange_Installation_Guide_for_RHEL6_622|Download and Installation Guide for RedHat Enterprise Linux 6]]&lt;br /&gt;
* [[Open-Xchange Installation Guide for CentOS 6‎‎_622|Download and Installation Guide for CentOS 6]]&lt;br /&gt;
&lt;br /&gt;
|{{#ifeq:{{{release|}}}|appsuite|&lt;br /&gt;
&lt;br /&gt;
* [[AppSuite:Open-Xchange_Installation_Guide_for_Debian_6.0|Download and Installation Guide for Debian GNU/Linux 6.0 (Squeeze)]]&lt;br /&gt;
* [[AppSuite:Open-Xchange_Installation_Guide_for_Debian_7.0|Download and Installation Guide for Debian GNU/Linux 7.0 (Wheezy)]]&lt;br /&gt;
* [[AppSuite:Open-Xchange_Installation_Guide_for_SLES11|Download and Installation Guide for SUSE Linux Enterprise Server 11]]&lt;br /&gt;
* [[AppSuite:Open-Xchange_Installation_Guide_for_RHEL6|Download and Installation Guide for RedHat Enterprise Linux 6]]&lt;br /&gt;
* [[AppSuite:Open-Xchange_Installation_Guide_for_CentOS_6|Download and Installation Guide for CentOS 6]]&lt;br /&gt;
&lt;br /&gt;
}}|}}| {{#!:&lt;br /&gt;
&lt;br /&gt;
* [[Open-Xchange_Installation_Guide_for_Debian_6.0_622|Download and Installation Guide for Debian GNU/Linux 6.0 (Squeeze)]]&lt;br /&gt;
* [[Open-Xchange_Installation_Guide_for_SLES11_622|Download and Installation Guide for SUSE Linux Enterprise Server 11]]&lt;br /&gt;
* [[Open-Xchange_Installation_Guide_for_RHEL6_622|Download and Installation Guide for RedHat Enterprise Linux 6]]&lt;br /&gt;
* [[Open-Xchange Installation Guide for CentOS 6‎‎_622|Download and Installation Guide for CentOS 6]]&lt;br /&gt;
&lt;br /&gt;
}}}}&lt;br /&gt;
&lt;br /&gt;
It&#039;s also possible to install backend and frontend components on each node. The difference is that a backend only on each node demands separate machines which the fronend in front of the backend nodes, while you only need a load balancer in front of the nodes if you install the backend and the frontend on each node.&lt;br /&gt;
&lt;br /&gt;
Create the &#039;&#039;configdb&#039;&#039; database at the MySQL Master. This step does only need to be performed on one of the Open-Xchange Server nodes.&lt;br /&gt;
 $ /opt/open-xchange/sbin/initconfigdb --configdb-user=openexchange --configdb-pass=secret --configdb-host=10.20.30.217&lt;br /&gt;
&lt;br /&gt;
Setup the Open-Xchange Server configuration. This step needs to be performed on &#039;both&#039; groupware nodes. Note that the &#039;&#039;--jkroute&#039;&#039; parameter must equal the &#039;&#039;route&#039;&#039; parameter at the web servers &#039;&#039;proxy_ajp&#039;&#039; load balancing configuration of the specific server.&lt;br /&gt;
Node 1:&lt;br /&gt;
 $ /opt/open-xchange/sbin/oxinstaller --servername=oxserver --configdb-readhost=10.20.30.219 --configdb-writehost=10.20.30.217 --configdb-user=openexchange --master-pass=secret --configdb-pass=secret --jkroute=OX1 --ajp-bind-port=*&lt;br /&gt;
Node 2:&lt;br /&gt;
 $ /opt/open-xchange/sbin/oxinstaller --servername=oxserver --configdb-readhost=10.20.30.219 --configdb-writehost=10.20.30.217 --configdb-user=openexchange --master-pass=secret --configdb-pass=secret --jkroute=OX2 --ajp-bind-port=*&lt;br /&gt;
&lt;br /&gt;
Startup the Open-Xchange Daemon on one of the nodes. Wait some seconds until it is started completely.&lt;br /&gt;
 $ systemctl start open-xchange&lt;br /&gt;
 &lt;br /&gt;
Now register the Open-Xchange Server at the database. Note that a &#039;&#039;server&#039;&#039; is a whole cluster in this case. This step does only need to be performed on one of the Open-Xchange Server nodes.&lt;br /&gt;
 $ /opt/open-xchange/sbin/registerserver -n oxserver -A oxadminmaster -P secret&lt;br /&gt;
 &lt;br /&gt;
Register the filestorage. This step does only need to be performed on one of the Open-Xchange Server nodes. Note that the NFS export must be mounted to the same path on both groupware nodes.&lt;br /&gt;
 $ /opt/open-xchange/sbin/registerfilestore -A oxadminmaster -P secret -t file:///var/opt/filestore&lt;br /&gt;
&lt;br /&gt;
Now register the MySQL Master database in configdb. This step does only need to be performed on one of the Open-Xchange Server nodes.&lt;br /&gt;
 $ /opt/open-xchange/sbin/registerdatabase -A oxadminmaster -P secret --name oxdatabase --hostname 10.20.30.217 --dbuser openexchange --dbpasswd secret --master true&lt;br /&gt;
 database 4 registered&lt;br /&gt;
&lt;br /&gt;
Check the returned database ID which is 4 in this case. This value is required to register the MySQL Slave database in configdb. This step does only need to be performed on one of the Open-Xchange Server nodes.&lt;br /&gt;
 $ /opt/open-xchange/sbin/registerdatabase -A oxadminmaster -P secret --name oxdatabase_slave --hostname 10.20.30.219 --dbuser openexchange --dbpasswd secret --master false --masterid=4&lt;br /&gt;
&lt;br /&gt;
Now start Open-Xchange Server on both groupware nodes.&lt;br /&gt;
 $ systemctl stop open-xchange&lt;br /&gt;
 $ systemctl start open-xchange&lt;br /&gt;
&lt;br /&gt;
 &lt;br /&gt;
Create a new context and a testuser&lt;br /&gt;
 $ /opt/open-xchange/sbin/createcontext -A oxadminmaster -P secret -c 1 -u oxadmin -d &amp;quot;Context Admin&amp;quot; -g Admin -s User -p secret -L defaultcontext -e oxadmin@example.com -q 1024 --access-combination-name=all&lt;br /&gt;
 $ /opt/open-xchange/sbin/createuser -c 1 -A oxadmin -P secret -u testuser -d &amp;quot;Test User&amp;quot; -g Test -s User -p secret -e testuser@example.com&lt;br /&gt;
&lt;br /&gt;
=== Test Session load balancing ===&lt;br /&gt;
Apache is configured to use a 50:50 balancing between both Open-Xchange Servers. Now that they are up and running its time to check if this balancing works. This can be done by simply watching the Open-Xchange Server log files while a user logs in.&lt;br /&gt;
Execute &#039;&#039;tail&#039;&#039; to the &#039;&#039;open-xchange.log.0&#039;&#039; file on both servers. Then login with the testuser, one of the servers log file should show something like&lt;br /&gt;
 $ tail -fn200 /var/log/open-xchange/open-xchange.log.0&lt;br /&gt;
 [...]&lt;br /&gt;
 INFO: Session created. ID: 31060fc80b9e44d38148ef4d5d19963d, Context: 1, User: 3&lt;br /&gt;
&lt;br /&gt;
Then logout and login again. This time, the session should be created on the other server. On the client side, the JSESSIONID cookie at the browser shows evidence on which server the user has logged in by the trailing &amp;quot;.OX-&amp;quot; identifier. This identifier is set by Open-Xchange Server based on its AJP_JVM_ROUTE attribute.&lt;/div&gt;</summary>
		<author><name>Owen.stevens</name></author>
	</entry>
	<entry>
		<id>https://wiki.open-xchange.com/wiki/index.php?title=ConfigCascade&amp;diff=24619</id>
		<title>ConfigCascade</title>
		<link rel="alternate" type="text/html" href="https://wiki.open-xchange.com/wiki/index.php?title=ConfigCascade&amp;diff=24619"/>
		<updated>2019-04-03T14:52:50Z</updated>

		<summary type="html">&lt;p&gt;Owen.stevens: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= Introduction to the config cascade =&lt;br /&gt;
&lt;br /&gt;
The config cascade is a configuration system that allows administrators to selectively override configuration parameters on context and user level. This means a configuration option can vary between groups of contexts, specific contexts or users.&lt;br /&gt;
&lt;br /&gt;
== Who should read this document? ==&lt;br /&gt;
&lt;br /&gt;
If you are tasked with designing and maintaining the configuration of an OX server or cluster, information contained in this document will acquaint you with options in OX configuration design. &lt;br /&gt;
&lt;br /&gt;
== Core Concepts - Configuration Scope ==&lt;br /&gt;
&lt;br /&gt;
The config cascade differentiates between 4 scopes of configuration: &#039;&#039;&#039;Server&#039;&#039;&#039;, &#039;&#039;&#039;ContextSet&#039;&#039;&#039;, &#039;&#039;&#039;Context&#039;&#039;&#039; and &#039;&#039;&#039;User&#039;&#039;&#039;, with the latter always overriding the configuration of the one before it. To determine the active value of a certain parameter, the config cascade looks whether the parameter is defined in a certain scope before falling back to the next scope to the left to determine if a value is defined there. This means, that a value in the &#039;&#039;&#039;User&#039;&#039;&#039; scope can override the more general value from the &#039;&#039;&#039;Context&#039;&#039;&#039; scope, which in turn overrides the value of a context set configuration, which itself overrides a server wide configuration.&lt;br /&gt;
&lt;br /&gt;
== Core Concepts - Context Taxonomy ==&lt;br /&gt;
&lt;br /&gt;
When deciding on configuration options it usually makes sense to group contexts according to a certain criterion. Typical uses would be to group contexts by offering (&#039;&#039;&#039;webmail&#039;&#039;&#039;, &#039;&#039;&#039;groupware_standard&#039;&#039;&#039;, &#039;&#039;&#039;groupware_plus&#039;&#039;&#039;), or country (&#039;&#039;&#039;de&#039;&#039;&#039;, &#039;&#039;&#039;fr&#039;&#039;&#039;, &#039;&#039;&#039;es&#039;&#039;&#039;) or brand (&#039;&#039;&#039;coolhosting&#039;&#039;&#039;, &#039;&#039;&#039;supremehosting&#039;&#039;&#039;) or if they are part of a &amp;quot;friendly users&amp;quot; group you sometimes give access to features to deem whether they are appropriate for rollout (&#039;&#039;&#039;beta&#039;&#039;&#039;). You can then specify configuration options that only take effect if a context is part of one of these groups. For example, the default hostname varies by both country and brand, with the french coolhosting domain name being &amp;quot;coolhosting.fr&amp;quot;, while the spanish one is &amp;quot;coolhosting.es&amp;quot;, or, for the second brand &amp;quot;supremehosting.fr&amp;quot; or &amp;quot;supremehosting.es&amp;quot; respectively. How can you go about classifying a context?&lt;br /&gt;
&lt;br /&gt;
Using the command line tools you can specifiy the taxonomy/types parameter:&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;createcontext ... -i 12 --taxonomy/types=webmail,coolhosting,de&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
which would tag context 12 with the types webmail, coolhosting and de. This is also available in &amp;quot;&#039;&#039;&#039;changecontext&#039;&#039;&#039;&amp;quot;. In RMI the equivalent is to call &#039;&#039;&#039;Context#setUserAttribute(&amp;quot;taxonomy&amp;quot;, &amp;quot;types&amp;quot;, &amp;quot;webmail,coolhosting,de&amp;quot;)&#039;&#039;&#039;. We will later see how configuration options can be specified for these types of contexts. &lt;br /&gt;
&lt;br /&gt;
== Specifying Configuration - Server Scope ==&lt;br /&gt;
&lt;br /&gt;
The most general scope is the &#039;&#039;&#039;Server&#039;&#039;&#039; scope. Every value that can be overridden along the config cascade &#039;&#039;&#039;MUST&#039;&#039;&#039; also be defined with a default value in the Server scope. This is done using the usual configuration methods of the server: .properties files in the config directory (usually /opt/openexchange/etc, or /opt/openexchange/etc/groupware in versions up to 6.20.7). Let&#039;s consider the properties &amp;quot;&#039;&#039;&#039;com.openexchange.messaging.twitter&#039;&#039;&#039;&amp;quot;, which governs whether twitter messaging should be available in a given installation. Since we consider this to be a premium feature, we&#039;ll disable this on the server level:&lt;br /&gt;
&lt;br /&gt;
  &#039;&#039;&#039;twittermessaging.properties:&#039;&#039;&#039;&lt;br /&gt;
  com.openexchange.messaging.twitter=false&lt;br /&gt;
&lt;br /&gt;
Later we will see how to enable it for certain groups of contexts.&lt;br /&gt;
&lt;br /&gt;
== Specifying Configuration - Context Set Scope ==&lt;br /&gt;
&lt;br /&gt;
As we saw, you can classify contexts into groups. These groups will now be used to specify certain configuration options. Let&#039;s consider this setup:&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
  Context 12: webmail,de,beta&lt;br /&gt;
  Context 13: groupware_plus,es&lt;br /&gt;
  Context 14: groupware_plus,fr,beta&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Let&#039;s say, we want to roll out the twitter functionality to those contexts, that have the groupware_plus product and are part of our &amp;quot;friendly users&amp;quot;. For this, you can specify a configuration that overrides the server setting like this:&lt;br /&gt;
&lt;br /&gt;
Create a file called &#039;&#039;&#039;/opt/openexchange/etc/contextSets/messaging.yml&#039;&#039;&#039; and add the following block:&lt;br /&gt;
&lt;br /&gt;
   experimental_gw_plus:&lt;br /&gt;
       withTags: groupware_plus &amp;amp; beta&lt;br /&gt;
       com.openexchange.messaging.twitter: true&lt;br /&gt;
&lt;br /&gt;
Let&#039;s go through this line by line. The first line introduces a configuration block that will be used for certain contexts. The name doesn&#039;t matter, only insofar as that it may only be used once per file. Choose a good mnemonic here, so a future you or someone else can guess at what is going on in this configuration block. &lt;br /&gt;
&lt;br /&gt;
The second line specifies the criterion to use to find out whether a context belongs in this group of contexts. In this case, a context having both the groupware_plus and beta tags will be considered to be a part of this group. In the withTags expression you can use boolean logic (with &amp;amp; for and, | for or and brackets to group the expressions). It&#039;s best to not go overboard with this, though. If the boolean expressions here become too complex it&#039;s usually an indication that you could use another classification for the contexts. Which tags does a context have? Firstly, and most obviously, those specified as its taxonomy/types list. But that is not the whole story. The /users/ module access permissions are also transformed into tags and applied to the context (at runtime). So if a user has access to the tasks module and the infostore module, the context will be considered to be tagged with ucTask and ucInfostore as well. And last keyword which can be used as a tag is the context name. This is sometimes enough to determine if a context is part of a certain offering, but more explicit tagging of contexts according to the offering keeps things readable. Lastly the configuration parameter &amp;quot;com.openexchange.config.cascade.types&amp;quot; (which is itself config cascade enabled) adds its value to the tag list, so, for example:&lt;br /&gt;
&lt;br /&gt;
   friendly_users:&lt;br /&gt;
       withTags: groupware_plus &amp;amp; beta&lt;br /&gt;
       com.openexchange.config.cascade.types: friendly_and_paying&lt;br /&gt;
&lt;br /&gt;
Would add the friendly_and_paying tag to all contexts already classified as groupware_plus and beta. Also since this value can also be specified on user level, you could classify users irrespective of their contexts, should the need arise. &lt;br /&gt;
&lt;br /&gt;
The third line then specifies the setting to override. You can specify all properties to override in this block, so if we wanted to enable both twitter and rss messaging for these contexts, we&#039;d use the following configuration:&lt;br /&gt;
&lt;br /&gt;
   experimental_gw_plus:&lt;br /&gt;
       withTags: groupware_plus &amp;amp; beta&lt;br /&gt;
       com.openexchange.messaging.twitter: true&lt;br /&gt;
       com.openexchange.messaging.rss: true&lt;br /&gt;
&lt;br /&gt;
Most configuration use cases can probably be handled with the context sets system. Only if a configuration is truly unique for just one context or user should the other options be pursued.&lt;br /&gt;
&lt;br /&gt;
== Specifying Configuration - Context Scope and User Scope ==&lt;br /&gt;
&lt;br /&gt;
Configuration options can be overridden on user and context level, using a dynamic property. For example:&lt;br /&gt;
&lt;br /&gt;
 $ createcontext [...] --config/com.openexchange.messaging.twitter=true&lt;br /&gt;
 $ changecontext [...] --config/com.openexchange.messaging.twitter=true&lt;br /&gt;
 &lt;br /&gt;
 $ createuser [...] --config/com.openexchange.messaging.twitter=true&lt;br /&gt;
 $ changeuser [...] --config/com.openexchange.messaging.twitter=true&lt;br /&gt;
&lt;br /&gt;
Depending on the number of users and contexts in your system, this could pose a problem further down the road when you need to update this value for a large number of users.&lt;br /&gt;
&lt;br /&gt;
To remove such a setting again the following syntax can be used:&lt;br /&gt;
&lt;br /&gt;
 $ changecontext [...] --remove-config/com.openexchange.messaging.twitter&lt;br /&gt;
 $ changeuser [...] --remove-config/com.openexchange.messaging.twitter&lt;br /&gt;
&lt;br /&gt;
== UI Properties ==&lt;br /&gt;
&lt;br /&gt;
A common use case for the OX configuration system is to allow fine-tuning of the UI by providing configuration data on the backend. All properties defined in properties files below &amp;lt;tt&amp;gt;/opt/open-xchange/etc/groupware/settings&amp;lt;/tt&amp;gt; are transported to the UI and are config cascade enabled. So every customization you can specify for the UI using these settings, can also be selectively overridden with the config cascade.&lt;br /&gt;
&lt;br /&gt;
Since the config cascade only overrides existing settings, whether a property is a UI property or a server property is automatically determined by the directory in which the corresponding &amp;lt;tt&amp;gt;.properties&amp;lt;/tt&amp;gt; file is found. For example if &amp;lt;tt&amp;gt;/opt/open-xchange/etc/settings/appsuite.properties&amp;lt;/tt&amp;gt; contains the setting&lt;br /&gt;
&lt;br /&gt;
 io.ox/core//theme=default&lt;br /&gt;
&lt;br /&gt;
Then you can overwrite it for any context (or user, context set, etc.):&lt;br /&gt;
&lt;br /&gt;
 $ changecontext [...] --config/io.ox/core//theme=org.example.theme&lt;br /&gt;
&lt;br /&gt;
The values are first parsed using [http://json.org/ JSON] syntax. If that fails, they are interpreted as plain strings.&lt;br /&gt;
&lt;br /&gt;
== Further Reading ==&lt;br /&gt;
&lt;br /&gt;
[[ConfigCascadeCookbook]] - Collects typical configuration scenarios and how to handle them using the config cascade.&lt;/div&gt;</summary>
		<author><name>Owen.stevens</name></author>
	</entry>
	<entry>
		<id>https://wiki.open-xchange.com/wiki/index.php?title=ConfigCascade&amp;diff=24618</id>
		<title>ConfigCascade</title>
		<link rel="alternate" type="text/html" href="https://wiki.open-xchange.com/wiki/index.php?title=ConfigCascade&amp;diff=24618"/>
		<updated>2019-04-03T14:29:41Z</updated>

		<summary type="html">&lt;p&gt;Owen.stevens: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;= Introduction to the config cascade =&lt;br /&gt;
&lt;br /&gt;
The config cascade is a configuration system that allows administrators to selectively override configuration parameters on context and user level. This means a configuration option can vary between groups of contexts, specific contexts or users.&lt;br /&gt;
&lt;br /&gt;
== Who should read this document? ==&lt;br /&gt;
&lt;br /&gt;
If you are tasked with designing and maintaining the configuration of an OX server or cluster, information contained in this document will acquaint you with options in OX configuration design. &lt;br /&gt;
&lt;br /&gt;
== Core Concepts - Configuration Scope ==&lt;br /&gt;
&lt;br /&gt;
The config cascade differentiates between 4 scopes of configuration: &#039;&#039;&#039;Server&#039;&#039;&#039;, &#039;&#039;&#039;ContextSet&#039;&#039;&#039;, &#039;&#039;&#039;Context&#039;&#039;&#039; and &#039;&#039;&#039;User&#039;&#039;&#039;, with the latter always overriding the configuration of the one before it. To determine the active value of a certain parameter, the config cascade looks whether the parameter is defined in a certain scope before falling back to the next scope to the left to determine if a value is defined there. This means, that a value in the &#039;&#039;&#039;User&#039;&#039;&#039; scope can override the more general value from the &#039;&#039;&#039;Context&#039;&#039;&#039; scope, which in turn overrides the value of a context set configuration, which itself overrides a server wide configuration.&lt;br /&gt;
&lt;br /&gt;
== Core Concepts - Context Taxonomy ==&lt;br /&gt;
&lt;br /&gt;
When deciding on configuration options it usually makes sense to group contexts according to a certain criterion. Typical uses would be to group contexts by offering (&#039;&#039;&#039;webmail&#039;&#039;&#039;, &#039;&#039;&#039;groupware_standard&#039;&#039;&#039;, &#039;&#039;&#039;groupware_plus&#039;&#039;&#039;), or country (&#039;&#039;&#039;de&#039;&#039;&#039;, &#039;&#039;&#039;fr&#039;&#039;&#039;, &#039;&#039;&#039;es&#039;&#039;&#039;) or brand (&#039;&#039;&#039;coolhosting&#039;&#039;&#039;, &#039;&#039;&#039;supremehosting&#039;&#039;&#039;) or if they are part of a &amp;quot;friendly users&amp;quot; group you sometimes give access to features to deem whether they are appropriate for rollout (&#039;&#039;&#039;beta&#039;&#039;&#039;). You can then specify configuration options that only take effect if a context is part of one of these groups. For example, the default hostname varies by both country and brand, with the french coolhosting domain name being &amp;quot;coolhosting.fr&amp;quot;, while the spanish one is &amp;quot;coolhosting.es&amp;quot;, or, for the second brand &amp;quot;supremehosting.fr&amp;quot; or &amp;quot;supremehosting.es&amp;quot; respectively. How can you go about classifying a context?&lt;br /&gt;
&lt;br /&gt;
Using the command line tools you can specifiy the taxonomy/types parameter:&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;createcontext ... -i 12 --taxonomy/types=webmail,coolhosting,de&#039;&#039;&#039;&lt;br /&gt;
&lt;br /&gt;
which would tag context 12 with the types webmail, coolhosting and de. This is also available in &amp;quot;&#039;&#039;&#039;changecontext&#039;&#039;&#039;&amp;quot;. In RMI the equivalent is to call &#039;&#039;&#039;Context#setUserAttribute(&amp;quot;taxonomy&amp;quot;, &amp;quot;types&amp;quot;, &amp;quot;webmail,coolhosting,de&amp;quot;)&#039;&#039;&#039;. We will later see how configuration options can be specified for these types of contexts. &lt;br /&gt;
&lt;br /&gt;
== Specifying Configuration - Server Scope ==&lt;br /&gt;
&lt;br /&gt;
The most general scope is the &#039;&#039;&#039;Server&#039;&#039;&#039; scope. Every value that can be overridden along the config cascade &#039;&#039;&#039;MUST&#039;&#039;&#039; also be defined with a default value in the Server scope. This is done using the usual configuration methods of the server: .properties files in the config directory (usually /opt/openexchange/etc, or /opt/openexchange/etc/groupware in versions up to 6.20.7). Let&#039;s consider the properties &amp;quot;&#039;&#039;&#039;com.openexchange.messaging.twitter&#039;&#039;&#039;&amp;quot;, which governs whether twitter messaging should be available in a given installation. Since we consider this to be a premium feature, we&#039;ll disable this on the server level:&lt;br /&gt;
&lt;br /&gt;
  &#039;&#039;&#039;twittermessaging.properties:&#039;&#039;&#039;&lt;br /&gt;
  com.openexchange.messaging.twitter=false&lt;br /&gt;
&lt;br /&gt;
Later we will see how to enable it for certain groups of contexts.&lt;br /&gt;
&lt;br /&gt;
== Specifying Configuration - Context Set Scope ==&lt;br /&gt;
&lt;br /&gt;
As we saw, you can classify contexts into groups. These groups will now be used to specify certain configuration options. Let&#039;s consider this setup:&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
  Context 12: webmail,de,beta&lt;br /&gt;
  Context 13: groupware_plus,es&lt;br /&gt;
  Context 14: groupware_plus,fr,beta&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Let&#039;s say, we want to roll out the twitter functionality to those contexts, that have the groupware_plus product and are part of our &amp;quot;friendly users&amp;quot;. For this, you can specify a configuration that overrides the server setting like this:&lt;br /&gt;
&lt;br /&gt;
Create a file called &#039;&#039;&#039;/opt/openexchange/etc/contextSets/messaging.yml&#039;&#039;&#039; and add the following block:&lt;br /&gt;
&lt;br /&gt;
   experimental_gw_plus:&lt;br /&gt;
       withTags: groupware_plus &amp;amp; beta&lt;br /&gt;
       com.openexchange.messaging.twitter: true&lt;br /&gt;
&lt;br /&gt;
Let&#039;s go through this line by line. The first line introduces a configuration block that will be used for certain contexts. The name doesn&#039;t matter, only insofar as that it may only be used once per file. Choose a good mnemonic here, so a future you or someone else can guess at what is going on in this configuration block. &lt;br /&gt;
&lt;br /&gt;
The second line specifies the criterion to use to find out whether a context belongs in this group of contexts. In this case, a context having both the groupware_plus and beta tags will be considered to be a part of this group. In the withTags expression you can use boolean logic (with &amp;amp; for and, | for or and brackets to group the expressions). It&#039;s best to not go overboard with this, though. If the boolean expressions here become too complex it&#039;s usually an indication that you could use another classification for the contexts. Which tags does a context have? Firstly, and most obviously, those specified as its taxonomy/types list. But that is not the whole story. The /users/ module access permissions are also transformed into tags and applied to the context (at runtime). So if a user has access to the tasks module and the infostore module, the context will be considered to be tagged with ucTask and ucInfostore as well. And last keyword which can be used as a tag is the context name. This is sometimes enough to determine if a context is part of a certain offering, but more explicit tagging of contexts according to the offering keeps things readable. Lastly the configuration parameter &amp;quot;com.openexchange.config.cascade.types&amp;quot; (which is itself config cascade enabled) adds its value to the tag list, so, for example:&lt;br /&gt;
&lt;br /&gt;
   friendly_users:&lt;br /&gt;
       withTags: groupware_plus &amp;amp; beta&lt;br /&gt;
       com.openexchange.config.cascade.types: friendly_and_paying&lt;br /&gt;
&lt;br /&gt;
Would add the friendly_and_paying tag to all contexts already classified as groupware_plus and beta. Also since this value can also be specified on user level, you could classify users irrespective of their contexts, should the need arise. &lt;br /&gt;
&lt;br /&gt;
The third line then specifies the setting to override. You can specify all properties to override in this block, so if we wanted to enable both twitter and rss messaging for these contexts, we&#039;d use the following configuration:&lt;br /&gt;
&lt;br /&gt;
   experimental_gw_plus:&lt;br /&gt;
       withTags: groupware_plus &amp;amp; beta&lt;br /&gt;
       com.openexchange.messaging.twitter: true&lt;br /&gt;
       com.openexchange.messaging.rss: true&lt;br /&gt;
&lt;br /&gt;
Most configuration use cases can probably be handled with the context sets system. Only if a configuration is truly unique for just one context or user should the other options be pursued.&lt;br /&gt;
&lt;br /&gt;
== Specifying Configuration - Context Scope and User Scope ==&lt;br /&gt;
&lt;br /&gt;
Configuration options can be overridden on user and context level, using a dynamic property. For example:&lt;br /&gt;
&lt;br /&gt;
 $ createcontext [...] --config/com.openexchange.messaging.twitter=true&lt;br /&gt;
 $ changecontext [...] --config/com.openexchange.messaging.twitter=true&lt;br /&gt;
 &lt;br /&gt;
 $ createuser [...] --config/com.openexchange.messaging.twitter=true&lt;br /&gt;
 $ changeuser [...] --config/com.openexchange.messaging.twitter=true&lt;br /&gt;
&lt;br /&gt;
Depending on the number of users and contexts in your system, this could pose a problem further down the road when you need to update this value for a large number of users.&lt;br /&gt;
&lt;br /&gt;
To remove such a setting again the following syntax can be used:&lt;br /&gt;
&lt;br /&gt;
 $ changecontext [...] --remove-config/com.openexchange.messaging.twitter&lt;br /&gt;
 $ changeuser [...] --remove-config/com.openexchange.messaging.twitter&lt;br /&gt;
&lt;br /&gt;
== UI Properties ==&lt;br /&gt;
&lt;br /&gt;
A common use case for the OX configuration system is to allow fine-tuning of the UI by providing configuration data on the backend. All properties defined in properties files below &amp;lt;tt&amp;gt;/opt/open-xchange/etc/groupware/settings&amp;lt;/tt&amp;gt; are transported to the UI and are config cascade enabled. So every customization you can specify for the UI using these settings, can also be selectively overridden with the config cascade.&lt;br /&gt;
&lt;br /&gt;
Since the config cascade only overrides existing settings, whether a property is a UI property or a server property is automatically determined by the directory in which the corresponding &amp;lt;tt&amp;gt;.properties&amp;lt;/tt&amp;gt; file is found. For example if &amp;lt;tt&amp;gt;/opt/open-xchange/etc/settings/appsuite.properties&amp;lt;/tt&amp;gt; contains the setting&lt;br /&gt;
&lt;br /&gt;
 io.ox/core//theme=default&lt;br /&gt;
&lt;br /&gt;
Then you can overwrite it for any context (or user, context set, etc.):&lt;br /&gt;
&lt;br /&gt;
 $ changecontext [...] --config/io.ox/core//theme=org.example.theme&lt;br /&gt;
&lt;br /&gt;
The values are first parsed using [http://json.org/ JSON] syntax. If that fails, they are interpreted as plain strings.&lt;br /&gt;
&lt;br /&gt;
== Further Reading ==&lt;br /&gt;
&lt;br /&gt;
[[ConfigCascadeCookbook]] - Collects typical configuration scenarios and how to handle them using the config cascade.&lt;br /&gt;
&lt;br /&gt;
[https://confluence.open-xchange.com/display/PROJ/Configuring+App+Suite Configuring App Suite]&lt;/div&gt;</summary>
		<author><name>Owen.stevens</name></author>
	</entry>
</feed>