Chapter 5. Debugging Problems with Specific Applications
5.1. Common Resources
If you are having problems with an application gear, look in the
/etc/passwd file for information unique to that particular gear. You will see an account for the gear, represented with the gear's UUID. This file also provides the path to the login shell for the application's gear. The following sample screen output shows how gears are represented in the /etc/passwd file.
........ haproxy:x:188:188::/var/lib/haproxy:/sbin/nologin postgres:x:26:26:PostgreSQL Server:/var/lib/pgsql:/bin/bash mysql:x:27:27:MySQL Server:/var/lib/mysql:/bin/bash jenkins:x:498:498:Jenkins Continuous Build server:/var/lib/jenkins:/bin/false def4330dff68444b96846dd225a0a617:x:500:500:OpenShift guest:/var/lib/openshift/def4330dff68444b96846dd225a0a617:/usr/bin/oo-trap-user c9279521cffd4a5ba1118f1b6ac2d6d6:x:500:500:OpenShift guest:/var/lib/openshift/def4330dff68444b96846dd225a0a617:/usr/bin/oo-trap-user e16a4a4c2c1144c3815f19ba36ea9d32:x:500:500:OpenShift guest:/var/lib/openshift/def4330dff68444b96846dd225a0a617:/usr/bin/oo-trap-user
Below is a list of directories and log files to help you diagnose problems with specific applications:
- The
/var/lib/openshift/gear_UUIDdirectory on the node host is the home directory for each application gear. Check the SELinux contexts. - The
/var/lib/openshift/.httpd.d/gear_UUID*directory on the node host is the operations directory for each application gear. It contains thehttpdconfiguration for that particular application gear. - The
/var/logdirectory on the node host contains theruby193-mcollective.logfile. - Searching the
/var/log/openshiftdirectory on the node host for the gear's user UUID usinggrepcould help you find problems with application gears that generate error messages. - The
/var/log/openshift/user_action.logfile on the broker host contains logs of user actions.
