App Install

From Amahi Wiki
Revision as of 02:08, 8 May 2014 by Bigfoot65 (talk | contribs)
Jump to: navigation, search

Occasionally Amahi applications fail to install properly. This is often noted by error messages in the application install log (/var/log/amahi-app-install.log).

=======  app install begin      @  2014-05-03 07:42:37 -0500 ==========
Installing   app id qf1tweahyo under /var/hda/platform/html/script/.. ENV=produc
tion
NOTICE: redirected 'http://downloads.sourceforge.net/project/linfo/Linfo%20Stabl
e%20Releases/linfo-1.11.tar.gz' --> 'http://iweb.dl.sourceforge.net/project/linf
o/Linfo%20Stable%20Releases/linfo-1.11.tar.gz' ...
file /var/hda/tmp/amahi-download-cache/9306c736dc7197b9a3ed6b4c9395d4ab6e779a48
written in cache
Your HDA services have been restarted.
Your HDA services have been restarted.
mv: cannot stat ‘unpack’: No such file or directory
sed: can't read html/config.inc.php: No such file or directory
chown: cannot access ‘html/lib’: No such file or directory
/tmp/run_script20140503-14160-1huv0uh: line 47: html/config.inc.php: No such fil
e or directory
App: Linfo installed
=======  app install end        @  2014-05-03 07:42:43 -0500 ==========

Other times, you may receive notice in the Dashboard.

DashboardAppError.png

We take these seriously and have tried to incorporate additional error checking/prevention methods. Unfortunately they don't catch everything.

Reasons for failure vary, but the most common are:

  • Slow or sporadic internet connection.
  • Install script:
    • Taking too long
      =======  app install begin      @  2014-05-03 14:33:00 -0400 ==========
      Installing   app id yi7uxa8mlb under /var/hda/platform/html/script/.. ENV=production
      Your HDA services have been restarted.
      Your HDA services have been restarted.
      NOTE: file /var/hda/tmp/amahi-download-cache/956319338e8752e6a8f544423df61187d8b7e320 written in cache
      /var/hda/platform/html/lib/system_utils.rb:66:in `run_script': run_script had to 
      KILL this script. it was taking too long. sorry. (RuntimeError)
              from /var/hda/platform/html/app/models/app.rb:241:in `block in install_bg'
              from /var/hda/platform/html/app/models/app.rb:240:in `chdir'
              from /var/hda/platform/html/app/models/app.rb:240: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>'
    • Incorrect syntax
    • Insufficient privileges
  • Application source file is unavailable.
    • New version
    • File moved
    • Wrong SHA1 hash
      WARNING: primary downloaded file /tmp/amahi-download-
      cache/b224eae4f30c011cbe6eae3c81d662f199eaa85f did not pass signature check - got 
      2da58737f99c63f47983db27789cf4b989975220, expected 
      b224eae4f30c011cbe6eae3c81d662f199eaa85f

There are some recommendation users can follow to help correct or prevent these problems.

DON'T:

  1. Refresh your web browser or navigate from the page while an application is installing.
  2. Try to install an application after it initially fails. Need to diagnose issue.


DO:

  1. Check the log for details of why the app install failed.
  2. Check the Dashboard Apps tab, Installed section for the app.
  3. Check /var/hda/web-apps to ensure the app did not partially install.
  4. Search the forums for a similar issue and potential solution.
  5. Visit the IRC, #amahi channel for immediate assistance.
  6. File a bug report. Provide details to help with debugability of the issue.