Difference between revisions of "App Install"

From Amahi Wiki
Jump to: navigation, search
Line 2: Line 2:
 
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).  
 
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).  
  
<screenshot>
+
<pre>=======  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>'
 +
/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>'</pre>
  
 
Other times, you may receive notice in the Dashboard.   
 
Other times, you may receive notice in the Dashboard.   
Line 43: Line 61:
 
** Look to see if there is an entry for the app that failed to install correctly.
 
** Look to see if there is an entry for the app that failed to install correctly.
 
** Remove that row if it exists.
 
** Remove that row if it exists.
 +
<pre>MariaDB [hda_production]> select id,name from webapps;
 +
+----+------------+
 +
| id | name      |
 +
+----+------------+
 +
|  1 | phpsysinfo |
 +
|  2 | cups      |
 +
|  4 | zm        |
 +
|  5 | zm1        |
 +
|  6 | zm2        |
 +
|  7 | zm3        |
 +
|  8 | zm4        |
 +
|  9 | zm5        |
 +
| 10 | zm6        |
 +
| 12 | zm7        |
 +
| 14 | zm8        |
 +
+----+------------+
 +
11 rows in set (0.00 sec)</pre>
 
* Check /etc/httpd/conf.d directory for a file that is associated with the app.  ** For example, 1001-adminer.conf would be for Adminer.
 
* Check /etc/httpd/conf.d directory for a file that is associated with the app.  ** For example, 1001-adminer.conf would be for Adminer.
 
** If it exists, remove it.1
 
** If it exists, remove it.1
 
** Restart httpd.service-->
 
** Restart httpd.service-->

Revision as of 00:56, 8 May 2014

Msgbox-WOPr.png Work In Progress
This article is currently undergoing major expansion or restructuring. You are welcome to assist by editing it as well. If this article has not been edited in several days, please remove this template.


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 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>'
/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>'

Other times, you may receive notice in the Dashboard.

<screenshot>

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
    • Incorrect syntax
    • Insufficient privileges
  • Application source file is unavailable.
    • New version
    • File moved
    • Wrong SHA1 hash


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. File a bug report.