Issue with error page in the dispatcher | Community
Skip to main content
M
mmasonWD
Level 3
November 21, 2022
Solved

Issue with error page in the dispatcher

  • November 21, 2022
  • 3 replies
  • 6678 views

Hi, 

 

I am having trouble with redirecting visitors to an error page that is located within the dispatcher itself. The use case for this would be to send visitors to a very general error page when AEM is entirely down/maintenance is in progress. I have read elsewhere in other posts that the best way around this would be to place an html error page within the dispatcher. 

 

The DispatcherPassError is set to 1 in the vhost. We also have localized error pages set up and working great. My issue is when I create the html file within the Dispatcher, and route the dispatcher to this file on 404, I get a Not Found with this message: "error was encountered while trying to use an ErrorDocument to handle the request."

 

It is very possible I am placing the html file in the wrong location as well. Could someone assist with best practices on what directory this error file should reside within the dispatcher, or send a link to some documentation on this specific tasks?

 

Thanks

Best answer by Avinash_Gupta_

@avinash_gupta_ Again, this is for when the Publisher is down entirely and the dispatcher can't serve the error pages from the Publisher, for AMS Maintenance or other critical conditions. 

 

Thanks for the article. Unfortunately I have everything on my end set up exactly as it is within the article you shared. I suspect there may be a rewrite or redirect condition on our end that is causing issues. 


@mmasonwd In case your application or publisher is down and going through the maintenance, use the approach mentioned here in this link. You can simply route your site requests to dispatcher error page

 

https://labs.tadigital.com/index.php/2018/06/15/implementing-maintenance-mode-for-a-production-release/ 

 

Let me know if this help!

3 replies

Avinash_Gupta_
Community Advisor and Adobe Champion
Avinash_Gupta_Community Advisor and Adobe Champion
Community Advisor and Adobe Champion
November 21, 2022

@mmasonwd : 

 

Apart from configuring DispatcherPassError is set to 1, you have to define the ErrorDocument directive in Apache which tells it about where the error page is (OR) what should be displayed upon receiving an error.
The syntax of the ErrorDocument directive is:

ErrorDocument <3-digit-code> <action>

where the action will be treated as:

1.A local URL to redirect to (if the action begins with a “/”).
2.An external URL to redirect to (if the action is a valid URL).
3.Text to be displayed (if none of the above). The text must be wrapped in quotes (“) if it consists of more than one word.

For example, if you have the error page in /content/site1 location then the ErrorDocument in this site’s vhost file can be given as:

ErrorDocument 404 /content/site1/404.html

ErrorDocument 500 /content/site1/500.html

(OR) specify the URL to which the error page should land to,

ErrorDocument 500 http://error.example.com/server_error.html

 

Please refer to the below post that describes the error handling on AEM sites.

https://labs.tadigital.com/index.php/2018/01/16/error-handling-using-a-dispatcher/ 

    M
    mmasonWDAuthor
    Level 3
    November 21, 2022

    Hi, 

     

    What you explained and mentioned above is currently working for us. But not what I am looking for unfortunately.

     

    We have our ErrorDocument 404 and 500 set up properly, as mentioned, and are working great.

     

    What we are trying to do now for the <action> is to link an error page that is located in the dispatcher itself (not AEM). My question is where should I place this error page file within the dispatcher? Currently I have the error page located in /mnt/var/www/html/content/*host*/error/errorpage.html

     

    The syntax we then have for this is: ErrorDocument 404 /error/errorpage.html

     

    This unfortunately is not working. I also feel confident this is in the wrong location, as when the dispatcher is cleared, it will delete this file, so this was mostly for testing purposes. 

      M
      mmasonWDAuthor
      Level 3
      November 21, 2022

      @mmasonwd Generally, these error pages are created on AEM side and it's get cached inside dispatcher path /var/www/html. When we define a below statement in the dispatcher rules, in case of 404 error, it will refer to first to error page path cached inside dispatcher and if it's not available, it will get it from publisher and cached it in dispatcher.

      ErrorDocument 404 /content/site1/404.html

       

      Manually these error pages shouldn't be created in dispatcher as dispatcher flush is going to clear these pages. For debugging you can create these pages on the web server and verify the functionality.

       

      Refer to the below link in which examples are given to create a custom page on Apache webserver.

      https://www.digitalocean.com/community/tutorials/how-to-configure-apache-to-use-custom-error-pages-on-ubuntu-14-04 


      @avinash_gupta_ Again, this is for when the Publisher is down entirely and the dispatcher can't serve the error pages from the Publisher, for AMS Maintenance or other critical conditions. 

       

      Thanks for the article. Unfortunately I have everything on my end set up exactly as it is within the article you shared. I suspect there may be a rewrite or redirect condition on our end that is causing issues. 

        SantoshSai
        Community Advisor
        SantoshSaiCommunity Advisor
        Community Advisor
        November 21, 2022

        Hi @mmasonwd,

        Please check this thread: https://experienceleaguecommunities.adobe.com/t5/adobe-experience-manager/how-to-configure-dispatchers-to-use-custom-error-pages/m-p/179675  it should solve your problem.

        Regards,

        Santosh

        Santosh Sai
          M
          mmasonWDAuthor
          Level 3
          November 21, 2022

          Hi, this what Avinash had recommended above as well. But is not what the issue is. our ErrorDocument syntax is setup and working well. But we are wanting to do additionally is to link an error page that is living within the dispatcher, which is causing issues as mentioned above. 

            arunpatidar
            Community Advisor
            arunpatidarCommunity Advisor
            Community Advisor
            November 22, 2022

            Please check if this helps

            https://experienceleaguecommunities.adobe.com/t5/adobe-experience-manager/aem-dispatcher-errordocument-url-not-showing-up/m-p/539501 

            Arun Patidar
              Terms & ConditionsAccessibility statement

              Loading footer...