{"id":4000,"date":"2017-06-07T11:35:37","date_gmt":"2017-06-07T06:05:37","guid":{"rendered":"\/?p=4000"},"modified":"2020-08-17T11:46:30","modified_gmt":"2020-08-17T06:16:30","slug":"aem-dispatcher-setup-linux","status":"publish","type":"post","link":"https:\/\/www.argildx.us\/technology\/aem-dispatcher-setup-linux\/","title":{"rendered":"AEM Dispatcher Setup for Linux"},"content":{"rendered":"<p>Installing dispatcher for AEM in Apache Web-server in Linux may get little tricky, as documentation provided by Adobe on <a title=\"Installation of Dispatcher\" href=\"https:\/\/docs.adobe.com\/content\/help\/en\/experience-manager-dispatcher\/using\/getting-started\/dispatcher-install.html\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Installation of Dispatcher<\/a> in Linux is not sufficient, and if we take it in analogy and try doing same way we do in Windows, then we face some issues locating the appropriate files.<\/p>\n<h5><strong>Prerequisites for Dispatcher Setup<\/strong><\/h5>\n<ul>\n<li>Apache 2.2 web-server \u2013 In Ubuntu 12.0 and higher, Apache 2.2 web-server is pre-installed, but in case it is not there, you can find the installation instructions <a title=\"here\" href=\"https:\/\/www.digitalocean.com\/community\/tutorials\/how-to-install-the-apache-web-server-on-ubuntu-18-04-quickstart\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">here<\/a>.<\/li>\n<li>Dispatcher Module \u2013 Appropriate dispatcher module can be downloaded from <a title=\"Adobe Package Share\" href=\"https:\/\/www.adobeaemcloud.com\/content\/companies\/public\/adobe\/dispatcher\/dispatcher.html\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">Adobe Package Share<\/a>.<\/li>\n<\/ul>\n<h5><strong>Installation Instructions<\/strong><\/h5>\n<ol>\n<li>Considering Apache web-server is already setup in system, go ahead and extract dispatcher module using following command:\n<pre class=\"lang:default decode:true\"> tar -xvzf &lt;dispatcher..xxxx..yyyy.tar.gz&gt;<\/pre>\n<\/li>\n<li>Once you have extracted the files, now you have to move the appropriate files to their respective apt path.<\/li>\n<li>Move \u201cdispatcher-apache2.x-4.1.x.so\u201d to \u201c\/usr\/lib\/apache2\/modules\u201d. There you will find all the modules already being loaded by apache 2 webserver.<\/li>\n<li>Adobe recommends to give a soft name to your dispatcher module, but you don\u2019t need it as once setup is done, you will be hardly using it again.<\/li>\n<li>Now go ahead and create a folder conf under \u201c\/etc\/apache2\/\u201d, and move \u201cdispatcher.any\u201d file under this folder. Make sure that you don\u2019t move your dispatcher.any file to \u2018conf.d\u2019 folder which is already present.<\/li>\n<li>Now is the time to edit and map module file that you added and map the dispatcher.any file. Go ahead and edit apache2.conf file present under \u201cetc\/apache2\/\u201d.<\/li>\n<li>Scroll to the end, put some nice comments about you adding some new configs, and add following:\n<pre class=\"lang:default decode:true\">LoadModule dispatcher_module \/usr\/lib\/apache2\/modules\/dispatcher-apache2.2-4.1.5.so\r\n\r\n&lt;IfModule disp_apache2.c&gt;\r\n# location of the configuration file. eg: 'conf\/dispatcher.any'\r\nDispatcherConfig conf\/dispatcher.any\r\n\r\n# location of the dispatcher log file. eg: 'logs\/dispatcher.log'\r\nDispatcherLog \/var\/log\/apache2\/dispatcher.log\r\n\r\n# log level for the dispatcher log\r\n# 0 Errors\r\n# 1 Warnings\r\n# 2 Infos\r\n# 3 Debug\r\nDispatcherLogLevel 3\r\n\r\n# if turned to 1, the dispatcher looks like a normal module\r\nDispatcherNoServerHeader 0\r\n\r\n# if turned to 1, request to \/ are not handled by the dispatcher\r\n# use the mod_alias then for the correct mapping\r\nDispatcherDeclineRoot 0\r\n\r\n# if turned to 1, the dispatcher uses the URL already processed\r\n# by handlers preceeding the dispatcher (i.e. mod_rewrite)\r\n# instead of the original one passed to the web server.\r\nDispatcherUseProcessedURL 0\r\n\r\n# if turned to 1, the dispatcher does not spool an error\r\n# response to the client (where the status code is greater\r\n# or equal than 400), but passes the status code to\r\n# Apache, which e.g. allows an ErrorDocument directive\r\n# to process such a status code.\r\nDispatcherPassError 0\r\n&lt;\/IfModule&gt;<\/pre>\n<\/li>\n<li>Also add the following config to the end of apache2.conf file, which loads the dispatcher in web-server.\n<pre class=\"lang:default decode:true \">&lt;Directory \/&gt;\r\n\r\n&lt;IfModule disp_apache2.c&gt; \r\n# enable dispatcher for ALL request. if this is too restrictive, \r\n# move it to another location\r\nSetHandler dispatcher-handler\r\n&lt;\/IfModule&gt;\r\n\r\nOptions FollowSymLinks\r\nAllowOverride None\r\n\r\n&lt;\/Directory&gt;<\/pre>\n<p>Comments given above are self explanatory but, you can still go and edit configs if needed as per following descriptions:<\/p>\n<ul>\n<li>DispatcherConfig: Location and name of the configuration file (Can be given as an absolute or relative path)<\/li>\n<li>DispatcherLog: Location and name of the log file (Can be given as an absolute or relative path)<\/li>\n<li>DispatcherLogLevel: Log level for the log file<\/li>\n<li>DispatcherNoServerHeader: Whether to use the Apache or CQ server header<\/li>\n<li>DispatcherDeclineRoot: Defines whether to decline requests to the root \u201c\/\u201d<\/li>\n<li>DispatcherUseProcessedURL: Defines whether to use the original request URL or to use one already processed by other handlers (ie: <a href=\"http:\/\/httpd.apache.org\/docs\/current\/mod\/mod_rewrite.html\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">mod_rewrite<\/a>)\n<ul>\n<li>Note: This is essential for rewriting incoming links (stripping away the \u2018content\/{site_name}\u2019)<\/li>\n<\/ul>\n<\/li>\n<li>DispatcherPassError: Defines whether CQ or Apache will handle HTTP 40x error codes<\/li>\n<li><a href=\"http:\/\/httpd.apache.org\/docs\/2.2\/mod\/core.html#sethandler\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">SetHandler<\/a> (Apache parameter): Forces all matching files to be processed by a handler<\/li>\n<\/ul>\n<\/li>\n<li>Make sure, that path that is provided for load module, matches with the path where you placed your dispatcher module. Also match the name and version of dispatcher module, and change the config as required.<\/li>\n<li>Now configure dispatcher.any file. Edit \/renders section in dispatcher.any.\n<pre class=\"lang:default decode:true \">\/renders\r\n{\r\n\/rend01\r\n{\r\n\/hostname \"localhost\"\r\n[2]--&gt; \/port \"80\"\r\n}\r\n}\r\n\/cache\r\n{\r\n\/docroot \"\/var\/cache\/apache2\/&lt;cqcache&gt;\"\r\n}<\/pre>\n<p>By default you may find port set to 8000 or 8080, change it to 80.<br \/>\nGive whatever soft-name you want to give to your cache folder in place of \u201ccqcache\u201d<\/li>\n<li>Restart the apache server to let webserver take effect. You can restart apache server by using following command:\n<pre class=\"lang:default decode:true\">sudo \/etc\/init.d\/apache2 restart<\/pre>\n<\/li>\n<li>Once server is restarted and you get [OK] message, go and check \/var\/log\/apache2\/dispatcher.log file. If it says dispatcher initialized with correct cache path, it means dispatcher is successfully setup and ready to be used.<\/li>\n<\/ol>\n<p>Now you just need to configure your CQ replication agent, and point dispatcher flush agents to correct port.<\/p>\n<p>I tested this today itself i.e. 14th Oct 2013 on Ubuntu 13 64 bit debian based OS. It worked like wonder for me. Please post your comments and queries if you have any issues with it, and also if there are better ways to do it. Cheeeerz.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Installing dispatcher for AEM in Apache Web-server in Linux may get little tricky, as documentation provided by Adobe on Installation of Dispatcher in Linux is not sufficient, and if we take it in analogy and try doing same way we do in Windows, then we face some issues locating the appropriate files. Prerequisites for Dispatcher &#8230; <a title=\"AEM Dispatcher Setup for Linux\" class=\"read-more\" href=\"https:\/\/www.argildx.us\/technology\/aem-dispatcher-setup-linux\/\">Read more<\/a><\/p>\n","protected":false},"author":29,"featured_media":6653,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_et_pb_use_builder":"","_et_pb_old_content":"","_et_gb_content_width":"","content-type":"","footnotes":""},"categories":[66],"tags":[60,25,61,27,62,63],"yst_prominent_words":[2393,2404,2400,2392,1361,2403,2394,2401,2406,2402,2303,2391,2395,1309,2396,2405,2399,2397,1362,2398],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v14.5 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>AEM Dispatcher Setup for Linux - Simplified step-by-step<\/title>\n<meta name=\"description\" content=\"Adobe Experience Manager Dispatcher Setup for Linux - Installing dispatcher for AEM in Apache Web-server in Linux may get little tricky, this post can help!\" \/>\n<meta name=\"robots\" content=\"index, follow\" \/>\n<meta name=\"googlebot\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<meta name=\"bingbot\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.argildx.us\/technology\/aem-dispatcher-setup-linux\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"AEM Dispatcher Setup for Linux - Simplified step-by-step\" \/>\n<meta property=\"og:description\" content=\"Adobe Experience Manager Dispatcher Setup for Linux - Installing dispatcher for AEM in Apache Web-server in Linux may get little tricky, this post can help!\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.argildx.us\/technology\/aem-dispatcher-setup-linux\/\" \/>\n<meta property=\"og:site_name\" content=\"Argil DX\" \/>\n<meta property=\"article:published_time\" content=\"2017-06-07T06:05:37+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2020-08-17T06:16:30+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.argildx.us\/wp-content\/uploads\/2017\/06\/AEM-Dispatcher-Setup-for-Linux.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1440\" \/>\n\t<meta property=\"og:image:height\" content=\"542\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.argildx.us\/#website\",\"url\":\"https:\/\/www.argildx.us\/\",\"name\":\"Argil DX\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":\"https:\/\/www.argildx.us\/?s={search_term_string}\",\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/www.argildx.us\/technology\/aem-dispatcher-setup-linux\/#primaryimage\",\"inLanguage\":\"en-US\",\"url\":\"https:\/\/www.argildx.us\/wp-content\/uploads\/2017\/06\/AEM-Dispatcher-Setup-for-Linux.jpg\",\"width\":1440,\"height\":542,\"caption\":\"AEM Dispatcher Setup for Linux\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.argildx.us\/technology\/aem-dispatcher-setup-linux\/#webpage\",\"url\":\"https:\/\/www.argildx.us\/technology\/aem-dispatcher-setup-linux\/\",\"name\":\"AEM Dispatcher Setup for Linux - Simplified step-by-step\",\"isPartOf\":{\"@id\":\"https:\/\/www.argildx.us\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/www.argildx.us\/technology\/aem-dispatcher-setup-linux\/#primaryimage\"},\"datePublished\":\"2017-06-07T06:05:37+00:00\",\"dateModified\":\"2020-08-17T06:16:30+00:00\",\"author\":{\"@id\":\"https:\/\/www.argildx.us\/#\/schema\/person\/1c5b6f3f2f7218d9acb851588b98551f\"},\"description\":\"Adobe Experience Manager Dispatcher Setup for Linux - Installing dispatcher for AEM in Apache Web-server in Linux may get little tricky, this post can help!\",\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.argildx.us\/technology\/aem-dispatcher-setup-linux\/\"]}]},{\"@type\":[\"Person\"],\"@id\":\"https:\/\/www.argildx.us\/#\/schema\/person\/1c5b6f3f2f7218d9acb851588b98551f\",\"name\":\"Argil DX Media\",\"image\":{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/www.argildx.us\/#personlogo\",\"inLanguage\":\"en-US\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/0ccbc04705942d1269cdf9f789e58484?s=96&d=mm&r=g\",\"caption\":\"Argil DX Media\"}}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","_links":{"self":[{"href":"https:\/\/www.argildx.us\/wp-json\/wp\/v2\/posts\/4000"}],"collection":[{"href":"https:\/\/www.argildx.us\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.argildx.us\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.argildx.us\/wp-json\/wp\/v2\/users\/29"}],"replies":[{"embeddable":true,"href":"https:\/\/www.argildx.us\/wp-json\/wp\/v2\/comments?post=4000"}],"version-history":[{"count":0,"href":"https:\/\/www.argildx.us\/wp-json\/wp\/v2\/posts\/4000\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.argildx.us\/wp-json\/wp\/v2\/media\/6653"}],"wp:attachment":[{"href":"https:\/\/www.argildx.us\/wp-json\/wp\/v2\/media?parent=4000"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.argildx.us\/wp-json\/wp\/v2\/categories?post=4000"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.argildx.us\/wp-json\/wp\/v2\/tags?post=4000"},{"taxonomy":"yst_prominent_words","embeddable":true,"href":"https:\/\/www.argildx.us\/wp-json\/wp\/v2\/yst_prominent_words?post=4000"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}