App install Application installs should <u>'''neverNEVER''' </u> fail. Period. App install failures are high priorityto the [https://www.amahi.org/team Amahi Team].
= Debugability =
Debugging app install issues is very important, so any time something permanently destructive is attempted, it should be done with care to preserve the ability to analyze and debug what happened:
* preserve Preserve as much as possible from the existing (buggy) environment* make sure httpd configuration is sane: httpd -t - should say "Syntax OK"
The idea * Make sure httpd configuration is to not delete anything permanently sane (result should be "'''Syntax OK'''"): httpd - copy or move things to, say, a folder in /tmp if you have to get something out of their place. For example:t
{{code|* The idea is to not delete anything permanently - copy or move things to, say, a folder in /tmp if you have to get something out of their place. For example: mkdir /tmp/app-debug/}}
* Then add things there as necessary for later analysis, like: cp -a /var/log/amahi-app-installer.log /tmp/app-debug cp -a /etc/httpd/conf.d /tmp/app-debug
cp The user can provide this information:* Copy of the app install log:<blockquote><u>Fedora</u></blockquote> tail -a 300 /var/log/amahi-app-installer.log /tmp/app-debug cp -a /etc/httpd/conf.d /tmp/app-debug| fpaste
ALso the user can provide this information:<blockquote><u>Ubuntu</u></blockquote> tail -300 /var/log/amahi-app-installer.log | apaste
* tail Copy of the app error and access logs (i.e. Adminer is the app): cat /var/hda/web-300 apps/adminer/logs/error.log cat /var/loghda/amahiweb-app-installerapps/adminer/logs/access.log | fpaste
* To check if process is running (i.e. sab is the app):
{{Code|ps guax <nowikiblockquote><u>Fedora</u>|</nowikiblockquote> ps guax | grep sab | fpaste <nowikiblockquote><u>Ubuntu</u>|</nowikiblockquote> fpaste}} ps guax | grep sab | apaste
