Changes

From Amahi Wiki
Jump to: navigation, search
2,410 bytes added ,  03:37, 18 June 2017
__TOC__
 
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).
Other times, you may receive notice in the Dashboard.
[[File:DashboardAppError.png|750px850px]]
We take these seriously and have incorporated additional error checking/prevention methods. Unfortunately they don't catch everything.
= Reasons for Failure =
Reasons for failure vary, but the most common are:
<ul><li> Network connection<lismall> Install script:<ulpre>#<li> Taking RuntimeError: run_script had to KILL this script. it was taking too long. sorry.>,<small><pre>======= app install begin @ 2014-05-03 14/var/hda/platform/html/lib/system_utils.rb:3366:00 -0400 ==========in `run_script',Installing app id yi7uxa8mlb under /var/hda/platform/html/scriptapp/models/app.. ENV=productionrb:241:in `block in install_bg',Your HDA services have been restarted/var/hda/platform/html/app/models/app.rb:240:in `chdir',Your HDA services have been restarted/var/hda/platform/html/app/models/app.rb:240:in `install_bg',NOTE/var/hda/platform/html/script/install-app: file 86:in `install_or_uninstall',/var/hda/tmpplatform/html/amahiscript/install-download-cache/956319338e8752e6a8f544423df61187d8b7e320 written app:107:in cache`main',/var/hda/platform/html/libscript/install-app:119:in `<main>'</pre></small></li><li> Insufficient privileges<small><pre>#<Errno::EACCES: Permission denied @ dir_s_mkdir - /var/hda/web-apps/bandwidthd>,/usr/share/ruby/fileutils.rb:252:in `mkdir',/usr/share/ruby/fileutils.rb:252:in `fu_mkdir',/usr/share/ruby/system_utilsfileutils.rb:66226:in `run_scriptblock (2 levels) in mkdir_p',/usr/share/ruby/fileutils.rb:224: run_script had to in `reverse_each',KILL this script/usr/share/ruby/fileutils. it was taking too longrb:224:in `block in mkdir_p',/usr/share/ruby/fileutils. sorryrb:210:in `each',/usr/share/ruby/fileutils. (RuntimeError)rb:210:in `mkdir_p', from /var/hda/platform/html/app/models/app.rb:241364:in `block in install_bgmkdir', from /var/hda/platform/html/app/models/app.rb:240440:in `chdirinstall_webapp', from /var/hda/platform/html/app/models/app.rb:240208:in `install_bg', from /var/hda/platform/html/script/install-app:86:in `install_or_uninstall', from /var/hda/platform/html/script/install-app:107:in `main', from /var/hda/platform/html/script/install-app:119:in `<main>'</pre></small></li>:To correct, as ''root'' user (or precede with <licode> Incorrect syntaxsudo</licode>) do:<li> Insufficient privileges< chown -R apache:users /var/li><hda/ul>web-apps<li> Application source Source file is unavailable:</li>
<ul>
<li> New version</li>
<li> File moved</li>
<li> Wrong SHA1 hash</li></ul>
<small><pre>WARNING: primary downloaded file /tmp/amahi-download-
cache/b224eae4f30c011cbe6eae3c81d662f199eaa85f did not pass signature check - got
2da58737f99c63f47983db27789cf4b989975220, expected
b224eae4f30c011cbe6eae3c81d662f199eaa85f</pre></small></li>No space left on root (/) partition<small><pre>#<Errno::ENOSPC: No space left on device @ io_write - /ulvar/hda/tmp/amahi-download-cache/3ab7164c607c124b97e08dd25d3a9712afebde2b>,/var/hda/platform/html/lib/downloader.rb:100:in `write',/var/hda/platform/html/lib/downloader.rb:100:in `block in download',/var/hda/platform/html/lib/downloader.rb:100:in `open',/var/hda/platform/html/lib/downloader.rb:100:in `download',/var/hda/platform/html/lib/downloader.rb:50:in `download_and_check_sha1',/var/hda/platform/html/app/models/app.rb:200:in `install_bg',/var/hda/platform/html/script/install-app:86:in `install_or_uninstall',/var/hda/platform/html/script/install-app:107:in `main',/var/hda/platform/html/script/install-app:119:in `<main>'</pre></small></li>:Empty the ''/var/hda/tmp/amahi-download-cache'' directory. rm -rf /var/hda/tmp/amahi-download-cache/*</ul>
= 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>
# Look at the log for details of why the app install failed.
# View the Dashboard Apps tab, Installed section for the app.
# [[Submit Bug Report|Submit a bug report]]. Provide details to help with [[App_troubleshooting|debugability]] of the issue.
= Clean Up Failed Web App Install Clean Up =<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.
An application 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://www.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 name (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 the 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'' (hda_production, apps ''webapps'' table). 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].** Look to see if there is an entry for the each app that failed to install correctly.** Remove the row(s) that exist for the applicationapp (i.e. id 4, 5, 6, and 7)
<br />
:'''EXAMPLE'''
+----+------------+
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]].
 
 
Back to the [[Troubleshooting]].
12,424

edits