Groovy console not launching in Adobe Experience Manager due to DNS resolution error

Adobe Experience Manager (AEM) non-production environments can experience DNS resolution errors that prevent access to the Groovy console. The issue can occur when the environment’s domain isn’t correctly configured in DNS, DNS servers aren’t reachable, or the Groovy console package isn’t installed. To resolve the issue, verify DNS configuration and connectivity, and ensure that the Groovy console package is installed.

Description description

Environment

Adobe Experience Manager (AEM) non-production environments, such as staging or test environments

Issue/Symptoms

  • Attempting to access the Groovy console at its standard URL results in a DNS error.
  • The browser displays a message indicating that the domain name can’t be resolved.
  • The issue prevents access to the Groovy console for running administrative scripts and performing project tasks.

Root cause

The issue occurs when the domain name for the AEM environment isn’t correctly configured in DNS or when network connectivity to the DNS servers is unavailable. The Groovy console package might also not be installed in the environment.

Resolution resolution

Follow the steps below to resolve the issue:

  1. Verify that the domain name for the AEM environment is correctly configured in DNS and resolves to the intended IP address.
  2. Check that the client machine can reach the DNS servers and that no network restrictions block access to the AEM environment’s domain.
  3. Ensure that the Groovy console package is installed in the relevant AEM environment. If it isn’t installed, deploy the package as required.
  4. After completing these steps, access the Groovy console at the URL provided in the source and confirm that the issue is resolved.
recommendation-more-help
experience-cloud-kcs-help-kbarticles