diff --git a/docs/_documentations/troubleshooting.md b/docs/_documentations/troubleshooting.md index 2855b0ab..7990cc92 100644 --- a/docs/_documentations/troubleshooting.md +++ b/docs/_documentations/troubleshooting.md @@ -490,6 +490,35 @@ For Codewind to work with an Appsody stack image on a private Docker registry, t **Remote scenario** Follow the instructions in [Adding a container registry in Codewind](che-setupregistries.html). + +## Open Liberty projects do not start within the default timeout + +Occasionally, Appsody Open Liberty projects do not start, and you see the following entries in the `appsody.log`: + +``` +[Container] [INFO] CWWKM2010I: Searching for CWWKF0011I: in /opt/ol/wlp/usr/servers/defaultServer/logs/messages.log. This search will timeout after 120 seconds. +[Container] [INFO] CWWKM2013I: The file /opt/ol/wlp/usr/servers/defaultServer/logs/messages.log being validated does not exist. +... +[Container] [INFO] CWWKM2011E: Timed out searching for CWWKF0011I: in /opt/ol/wlp/usr/servers/defaultServer/logs/messages.log. +... +[Container] [ERROR] Failed to execute goal io.openliberty.tools:liberty-maven-plugin:3.2:dev (default-cli) on project starter-app: Unable to verify if the server was started after 120 seconds. Consider increasing the serverStartTimeout value if this continues to occur. -> [Help 1] +``` + +By default, Open Liberty projects are configured to wait 2 minutes (120 seconds) for the server to start. These messages are an indication that the server did not start within the default timeout period. + +**Workaround** + +Increase the timeout value in the project's `pom.xml` file. Look for the following element and increase the value: + +``` +120 +``` + *** # OpenShift Do (odo) with Codewind