App Install

	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).

<screenshot>

Other times, you may receive notice in the Dashboard.

<screenshot>

We take these seriously and have tried to incorporate additional error checking and 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.

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.