Troubleshooting

The purpose of this page is twofold:

1. Capture various issues and solutions for common or uncommon problems users may encounter.
   
   
2. Provide quick access to various HDA Admin tasks using command line or HDA Dashboard.

Current stable release: Amahi 7 (Fedora 19)   

Maintenance Support ONLY: Amahi 6 (Ubuntu 12.04.x)

Amahi 6 (Fedora 14)

NOTE: No Amahi new features, applications, or application updates are provided

when in Maintenance Support ONLY status.

---

Home

Store

Docs

FAQ

Forums

Bugs

IRC

Feedback

Suggest

---

Troubleshooting

Amahi Common

• Network

• OpenVPN

• Shares

• Greyhole

• Applications

• Platform

Amahi 7 (Fedora 19)

• Express CD (64-bit) Install

• dnsmasq

Amahi 6 (Ubuntu 12.04.x)

• Ubuntu Install

• Apache Web Server (Amahi bug 1023)

HDA Admin How To

Amahi Common

• Disable Router DHCP Server: Generic guidance for disabling DHCP server on some routers.

• Change DNS Provider: Change DNS from OpenDNS to different provider.

• Disable DHCP Server: Disable DHCP server on HDA.

• Change Gateway IP Address: Change the 3rd octet of the router/client IP addresses.

• Renew Client IP Address: Applies to Windows, Mac OS X, and Linux.

• Enable Advanced Settings: Unhides advanced areas in Network and Setup tabs.

• Open terminal as root user: Command line access as root user.

• Reset User Password: Use to reset a user's forgotten password.

• Greyhole: Setup/configure Greyhole Storage Pooling.

• Mount Shares Locally: Safely manage Greyhole enabled share files locally on the HDA.

• Manage Shares: Create, edit, delete, and manage file shares configuration.

• Shares Extra Parameters: Manage extra options per file share, such as a recycle bin or quota.

• Configure Static IP Address: Create static IP address for client devices.

• Secure Shell (SSH): Key-based SSH terminal access to your HDA.

• Virtual Private Network (VPN): Not included in Amahi 6 or 7, but is required for secure connection between a client and HDA outside your network. Amahi application VPN provides the capability.

• Hardware Changes: Steps for hardware changes on HDA (i.e. mother board, network card, etc).

• Customize IPsec VPN: How to change the secret and/or group name as well as procedure for routing all traffic through Amahi IPsec VPN application.

• Virtual Network Computing (VNC): Access your HDA desktop remotely from inside your network.

Amahi 7 (Fedora 19)

• net-tools/bind-utils (includes commands ifconfig, nslookup, netstat, and others): Not installed in Amahi 7. Amahi application HDA Troubleshooting Tools provides the capability.

• Manual Web App Creation: Not installed in Amahi 7. Amahi application Web App provides the capability.

• Calendar Server: This feature is currently broken in Amahi 7 (Amahi bug 1339), but guidance is provided to correct the issue.

• Express CD Desktop: Amahi 7 is headless, but guidance is provided for installing a GUI desktop. The Amahi application VNC provides the Gnome 3 Desktop and remote capability.

Amahi 6 (Ubuntu 12.04.x)

• Adding disk drives: There is no Dashboard UI for adding additional drives in Amahi 6, but manual guidance is provided.

• Secure Shell (SSH): Not installed in Amahi 6, but is required to remotely access your HDA, inside or outside your network. Amahi applications OpenSSH and Dropbear provides the capability.

• Manual Web App Creation: Creating a manual web app via the dashboard results in a "HTTP error 500" message. This work around should correct the issue (Amahi bug 977).

Tutorials

• Fedora

• Ubuntu

• Terminal Scripts

• HDA OS Migration Guide

References

• Interactive Network Troubleshooter

• Common Log Files List

• Linux and HDA Commands

• Linux Permissions Chart

• Amahi Video Tutorials