Trusted, Bureaucrats, Administrators
12,424
edits
Changes
From Amahi Wiki
→Clean Up Failed Web App Install
Occasionally Amahi [https://www.amahi.org/apps applications] fail to install properly. This is often noted by error messages in the application install log (/var/log/amahi-app-install.log).
<screenshotsmall><pre>======= app install begin @ 2014-05-03 07:42:37 -0500 ==========Installing app id qf1tweahyo under /var/hda/platform/html/script/.. ENV=productionNOTICE: redirected 'http://downloads.sourceforge.net/project/linfo/Linfo%20Stable%20Releases/linfo-1.11.tar.gz' --> 'http://iweb.dl.sourceforge.net/project/linfo/Linfo%20Stable%20Releases/linfo-1.11.tar.gz' ...file /var/hda/tmp/amahi-download-cache/9306c736dc7197b9a3ed6b4c9395d4ab6e779a48written in cacheYour HDA services have been restarted.Your HDA services have been restarted.mv: cannot stat ‘unpack’: No such file or directorysed: can't read html/config.inc.php: No such file or directorychown: cannot access ‘html/lib’: No such file or directory/tmp/run_script20140503-14160-1huv0uh: line 47: html/config.inc.php: No such file or directoryApp: Linfo installed======= app install end @ 2014-05-03 07:42:43 -0500 ==========</pre></small>
Other times, you may receive notice in the Dashboard.
We take these seriously and have tried to incorporate incorporated additional error checking/prevention methods. Unfortunately they don't catch everything.
= Reasons for Failure =
Reasons for failure vary, but the most common are:
= Recipe for Success =
There are some recommendation users can follow to help correct or prevent these problems.
<b><big>DON'T:</big></b>
# Refresh your web browser or navigate from the page while an application is installing.
# Try to install an application after it initially fails. Need to diagnose issue.
<b><big>DO:</big></b># Check Look at the log for details of why the app install failed.# Check View the Dashboard Apps tab, Installed section for the app.
# Check /var/hda/web-apps to ensure the app did not partially install.
# File Search the [https://forums.amahi.org forums] for a similar issue and potential solution.# Visit the IRC, [http://webchat.freenode.net/?channels=amahi #amahi] channel for immediate assistance.# [[Submit Bug Report|Submit a bug report]]. Provide details to help with [[App_troubleshooting|debugability]] of the issue. = Clean Up Failed Web App Install =<div style="border: 1px solid #A3B1BF; padding: .8em 1em; background-color: #E6F2FF; margin: 0px 1em;">'''DISCLAIMER:''' The steps below should '''ONLY''' be attempted by advanced users. If you don't know what you are doing, recommend you seek professional assistance or you could break your HDA!</div> '''NOTE:''' We will use '''owncloud''' as an example of the application that failed to install. A web app install was unsuccessful, but it appears partially installed. This often happens and repeatedly trying to install without clean up results in multiple failed attempts. For example, 4 failed attempts of [https://bugswww.amahi.org /apps/owncloud ownCloud] would create ''owncloud'', ''owncloud1'', ''owncloud2'', ''owncloud3''. To return your HDA to a safe state for another install attempt, the following may help:* Navigate to the ''Network'' tab, ''DNS Aliases'' section in the Amahi Dashboard** Make note of the URL name(s)** Remove each entry for the failed application by selecting ''Delete''* If the app has a database, execute the following command: hda-create-db-and-user -d owncloud<ul><li>The next steps must be done from the command line as ''root'' user:</li><ul><li>Navigate to /etc/httpd/conf.d and determine file(s) to remove</li> ls -al<li>Remove each ####-app.conf (substitute the number for #### and URL name for app) file</li> cd /etc/httpd/conf.d rm -rf 1001-owncloud.conf rm -rf 1002-owncloud1.conf rm -rf 1003-owncloud2.conf rm -rf 1004-owncloud3.conf<li>Then as ''root'' user, restart apache</li> sysemctl restart httpd<li>Next, navigate to /var/hda/web-apps</li> cd /var/hda/web-apps<li>Remove each app directory</li> rm -rf owncloud rm -rf owncloud1 rm -rf owncloud2 rm -rf owncloud3</ul></ul>* Finally check the HDA database ''hda_production'' (''webapps'' table). ** Look to see if there is an entry for each app that failed to install correctly.** Remove the row(s) that exist for the app (i.e. id 4, 5, 6, and 7)<br />:'''EXAMPLE'''<blockquote><pre>MariaDB [hda_production]> select id,name from webapps;+----+------------+| id | name |+----+------------+| 1 | phpsysinfo || 4 | owncloud || 5 | owncloud1 || 6 | owncloud2 || 7 | owncloud3 |+----+------------+5 rows in set (0.00 sec)</pre></blockquote> The safest way is to use a web application such as [https://www.amahi.org/apps/adminer Adminer] or [https://www.amahi.org/apps/phpmyadmin phpMyAdmin]. TO do it via command line, execute the command below for each ''id' that needs to be deleted from the database: echo "delete from webapps where id=2" | mysql -uroot -p hda_production ::'''WARNING:''' Please see [[Database Root Password]] for the appropriate login password. Once these steps are complete, it should be safe to try and install the application. Monitor the '''/var/log/amahi-app-installer.log''' file for progress and errors via command line: tail -f /var/log/amahi-app-installer.log If the app continues to fail, recommend you seek professional assistance by [[Submit Bug Report|submitting a bug report]].
