App Install

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 (Amahi 7 ONLY).

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

Reasons for failure vary, but the most common are:

• Network 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.