You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@sling.apache.org by mp...@apache.org on 2016/02/18 15:25:18 UTC
svn commit: r1731078 -
/sling/site/trunk/content/documentation/bundles/content-distribution.mdtext
Author: mpetria
Date: Thu Feb 18 14:25:18 2016
New Revision: 1731078
URL: http://svn.apache.org/viewvc?rev=1731078&view=rev
Log:
SLING-4540: content distribution documentation page - adding configuration samples
Modified:
sling/site/trunk/content/documentation/bundles/content-distribution.mdtext
Modified: sling/site/trunk/content/documentation/bundles/content-distribution.mdtext
URL: http://svn.apache.org/viewvc/sling/site/trunk/content/documentation/bundles/content-distribution.mdtext?rev=1731078&r1=1731077&r2=1731078&view=diff
==============================================================================
--- sling/site/trunk/content/documentation/bundles/content-distribution.mdtext (original)
+++ sling/site/trunk/content/documentation/bundles/content-distribution.mdtext Thu Feb 18 14:25:18 2016
@@ -8,32 +8,61 @@ The Sling Content Distribution (SCD) mod
## Distribution usecases
+Some of the usecases have sample configuration in [Distribution Sample Module](https://github.com/apache/sling/tree/trunk/contrib/extensions/distribution/sample/src/main/resources/SLING-CONTENT/libs/sling/distribution) and are tested in [Distribution ITs Module](https://github.com/apache/sling/tree/trunk/contrib/extensions/distribution/it).
+
### Forward distribution
A forward distribution setup allows one to transfer content from a source instance to a farm of target instances. That is done by pushing the content from source to target.
-#### Setup overview:
+#### Setup overview
+
* one source instance
-** one distribution agent connected to importer endpoints for all target instances.
+ * one distribution agent connected to importer endpoints for all target instances.
* N target instances
-** one distribution importer on each target instance used to import packages into the local instance.
+ * one distribution importer on each target instance used to import packages into the local instance.
+
+#### Sample configuration
+
+* on source instance: one forward agent
+
+ org.apache.sling.distribution.agent.impl.ForwardDistributionAgentFactory-publish.json
+ name="publish"
+ packageImporter.endpoints=["http://localhost:4503/libs/sling/distribution/services/importers/default"]
-#### Sample configuration:
+* on target instance: one local importer
+
+ org.apache.sling.distribution.packaging.impl.importer.LocalDistributionPackageImporterFactory-default
+ name="default"
### Reverse distribution
A reverse distribution setup allows one to transfer content from a farm of source instances to a target instance. That is done by pulling the content from source instances into the target instance.
-#### Setup overview:
+#### Setup overview
* one target instance
-** one distribution agent connected to exporter endpoints for all target instances.
+ * one distribution agent connected to exporter endpoints for all target instances.
* N source instances
-** one distribution (queue) agent on each source instance; changes from the source instances are placed in the queues of these agents.
-** one distribution exporter on each source instance that exports packages from the queue agent.
+ * one distribution (queue) agent on each source instance; changes from the source instances are placed in the queues of these agents.
+ * one distribution exporter on each source instance that exports packages from the queue agent.
-#### Sample configuration:
+#### Sample configuration
+* on target instance: one reverse agent
+ org.apache.sling.distribution.agent.impl.ReverseDistributionAgentFactory-reverse.json
+ name="reverse"
+ packageExporter.endpoints=["http://localhost:4503/libs/sling/distribution/services/exporters/reverse"]
+
+* on source instance: one queue agent and one exporter for that agent
+
+ org.apache.sling.distribution.agent.impl.QueueDistributionAgentFactory-reverse.json
+ name="reverse"
+
+ org.apache.sling.distribution.packaging.impl.exporter.AgentDistributionPackageExporterFactory-reverse
+ name="reverse"
+ agent.target="(name=reverse)"
+
+
### Sync distribution
@@ -41,39 +70,102 @@ A sync distribution setup allows one to
#### Setup overview:
* one coordinator instance
-** one distribution agent connected to exporter/importer endpoints for all farm instances.
+ * one distribution agent connected to exporter/importer endpoints for all farm instances.
* N farm instances
-** one distribution (queue) agent on each farm instance; changes from these instances are placed in the queues of the queue agents.
-** one distribution exporter on each farm instance that exports packages from the queue agent.
-** one distribution importer on each farm instance used to import packages into the local instance.
+ * one distribution (queue) agent on each farm instance; changes from these instances are placed in the queues of the queue agents.
+ * one distribution exporter on each farm instance that exports packages from the queue agent.
+ * one distribution importer on each farm instance used to import packages into the local instance.
+
+#### Sample configuration
+
+* on coordinator instance: one sync agent
+
+ org.apache.sling.distribution.agent.impl.SyncDistributionAgentFactory-sync.json
+ name="sync"
+ packageExporter.endpoints=["http://localhost:4503/libs/sling/distribution/services/exporters/reverse", "http://localhost:4504/libs/sling/distribution/services/exporters/reverse"]
+ packageImporter.endpoints=["http://localhost:4503/libs/sling/distribution/services/importers/default", "http://localhost:4504/libs/sling/distribution/services/importers/default"]
+
+
+* on each farm instance: one local exporter and one local importer
+
+ org.apache.sling.distribution.agent.impl.QueueDistributionAgentFactory-reverse.json
+ name="reverse"
+
+ org.apache.sling.distribution.packaging.impl.exporter.AgentDistributionPackageExporterFactory-reverse
+ name="reverse"
+ agent.target="(name=reverse)"
+
+ org.apache.sling.distribution.packaging.impl.importer.LocalDistributionPackageImporterFactory-default
+ name="reverse"
+ agent.target="(name=reverse)"
-#### Sample configuration:
+
### Multidatacenter sync distribution
A multidatacenter sync distribution setup allows one to synchronize content in a farm of publish instances across datacenters. This a variation of sync distribution but using a coordinator in each datacenter.
-#### Setup overview:
+#### Setup overview
* one coordinator instance in each datacenter
-** one distribution agent for intra-datacenter synchronization. Like a regular sync agent it connects to all farm instances in its datacenter and syncronizes them. In addition to a regular sync agent it keeps the packages also in dedicated queues for the other DCs, so that the coordinators from the other DCs can pull the updates.
-** one distribution exporter for each queue dedicated for the remote DCs. The inter-dc coordinators from the other DCs will connect to these exporter endpoints.
-** one distribution agent for inter-datacenter synchronization; it conntects to the dedicated queues exposed by intra-dc coordinators from the other datacenters.
+ * one distribution agent for intra-datacenter synchronization. Like a regular sync agent it connects to all farm instances in its datacenter and syncronizes them. In addition to a regular sync agent it keeps the packages also in dedicated queues for the other DCs, so that the coordinators from the other DCs can pull the updates.
+ * one distribution exporter for each queue dedicated for the remote DCs. The inter-dc coordinators from the other DCs will connect to these exporter endpoints.
+ * one distribution agent for inter-datacenter synchronization; it conntects to the dedicated queues exposed by intra-dc coordinators from the other datacenters.
* N farm instances in each datacenter
-** one distribution (queue) agent on each farm instance; changes from these instances are placed in the queues of the queue agents.
-** one distribution exporter on each farm instance that exports packages from the queue agent.
-** one distribution importer on each farm instance used to import packages into the local instance.
-
-#### Sample configuration:
+ * one distribution (queue) agent on each farm instance; changes from these instances are placed in the queues of the queue agents.
+ * one distribution exporter on each farm instance that exports packages from the queue agent.
+ * one distribution importer on each farm instance used to import packages into the local instance.
+
+#### Sample configuration
+
+
+* on coordinator instance: one intradcsync agent with two exporters for the other dcs, and one interdcsync agent that connects to remote exporters.
+
+ org.apache.sling.distribution.agent.impl.SyncDistributionAgentFactory-intradcsync
+ name="intradcsync"
+ packageExporter.endpoints=["http://localhost:4503/libs/sling/distribution/services/exporters/reverse", "http://localhost:4504/libs/sling/distribution/services/exporters/reverse"]
+ packageImporter.endpoints=["http://localhost:4503/libs/sling/distribution/services/importers/default", "http://localhost:4504/libs/sling/distribution/services/importers/default"]
+ passiveQueues=["dc2queue", "dc3queue"]
+
+ org.apache.sling.distribution.packaging.impl.exporter.AgentDistributionPackageExporterFactory-dc2queue
+ name="dc2queue"
+ agent.target="(name=intradcsync)"
+ queue="dc2queue"
+
+ org.apache.sling.distribution.packaging.impl.exporter.AgentDistributionPackageExporterFactory-dc3queue
+ name="dc3queue"
+ agent.target="(name=intradcsync)"
+ queue="dc3queue"
+
+ org.apache.sling.distribution.agent.impl.SyncDistributionAgentFactory-interdcsync
+ name="interdcsync"
+ packageExporter.endpoints=["http://localhost:5502/libs/sling/distribution/services/exporters/dc1queue", "http://localhost:6502/libs/sling/distribution/services/exporters/dc1queue"]
+ packageImporter.endpoints=["http://localhost:4503/libs/sling/distribution/services/importers/default", "http://localhost:4504/libs/sling/distribution/services/importers/default"]
+
+
+* on each farm instance: one local exporter and one local importer
+
+ org.apache.sling.distribution.agent.impl.QueueDistributionAgentFactory-reverse.json
+ name="reverse"
+
+ org.apache.sling.distribution.packaging.impl.exporter.AgentDistributionPackageExporterFactory-reverse
+ name="reverse"
+ agent.target="(name=reverse)"
+
+ org.apache.sling.distribution.packaging.impl.importer.LocalDistributionPackageImporterFactory-default
+ name="default"
## Additional options
+### How to trigger distribution over HTTP?
+
### How to configure binary-less distribution?
### How to configure priority paths?
-### How to configure error queues?
\ No newline at end of file
+### How to configure error queues?
+