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?
+