Difference between revisions of "Troubleshooting"

From Amahi Wiki
Jump to: navigation, search
 
(63 intermediate revisions by the same user not shown)
Line 1: Line 1:
  
  
The purpose of this page is twofold:
+
The purpose of this page is to capture various issues and solutions for common or uncommon problems users may encounter.<br /><br />
# Capture various issues and solutions for common or uncommon problems users may encounter.<br /><br />
 
# Provide quick access to various HDA Admin tasks using command line or HDA Dashboard.
 
<br />
 
 
 
<big>'''Current stable release:'''  [http://docs.amahi.org/ Amahi 7] (Fedora 19)</big>&nbsp;&nbsp;&nbsp;[[File:f19release.png|125px|middle]]
 
<br />
 
<br />
 
<big>'''Testing ALPHA release:'''  [[Amahi_8|Amahi 8]] (Fedora 21)</big>&nbsp;&nbsp;&nbsp;[[File:f21release.png|125px|middle]]
 
<br />
 
<br />
 
<big>'''Maintenance Support ONLY:''' Amahi 6 ([[Amahi_6|Ubuntu 12.04.x]])</big>&nbsp;&nbsp;&nbsp;[[File:Precise_Pangolin_Ubuntu_OS_2.jpg|125px|middle]]
 
<br />
 
::::::::::<big>Amahi 6 ([[Amahi_6.0|Fedora 14]])</big>&nbsp;&nbsp;&nbsp;[[File:fedora14_logo.png|125px|middle]]
 
 
 
:'''NOTE:'''  ''Maintenance Support ONLY'' indicates all Amahi updates (i.e. platform, applications, etc) have been halted.
 
 
 
 
__TOC__
 
__TOC__
  
----
+
== Amahi Release (Common) ==
<center><big>
 
{|
 
|-
 
| [https://www.amahi.org Home]
 
|
 
|
 
| [https://www.amahi.org/apps Store]
 
|
 
|
 
| [http://docs.amahi.org Docs]
 
|
 
|
 
| [https://www.amahi.org/faq FAQ]
 
|
 
|
 
| [https://forums.amahi.org Forums]
 
|
 
|
 
| [https://bugs.amahi.org Bugs]
 
|
 
|
 
| [http://webchat.freenode.net/?channels=amahi IRC]
 
|
 
|
 
| [https://www.amahi.org/feedback Feedback]
 
|
 
|
 
| [https://www.amahi.org/apps/suggest Suggest]
 
|}
 
</big></center>
 
 
 
----
 
  
<br />
+
* [[Install_troubleshooting|Install]]
= Troubleshooting =
 
== Amahi Common ==
 
  
 
* [[Network_troubleshooting|Network]]
 
* [[Network_troubleshooting|Network]]
Line 70: Line 20:
 
* [[Platform_troubleshooting|Platform]]
 
* [[Platform_troubleshooting|Platform]]
  
== Amahi 8 (Fedora 21) ==
+
== Amahi Release (Specific)==
  
* [https://wiki.amahi.org/index.php/Dnsmasq_troubleshooting dnsmasq]
+
* [[Troubleshooting_Amahi_11|Amahi 11 (Fedora 27)]]
  
* [https://www.amahi.org/apps/amahi-sync Amahi Sync] ([https://bugs.amahi.org/issues/1096 Amahi Bug 1096])
+
* [[Troubleshooting_Amahi_10|Amahi 10 (Fedora 25)]]
  
== Amahi 7 (Fedora 19) ==
+
* [[Troubleshooting_Amahi_9|Amahi 9 (Fedora 23)]]
  
* [[Express_Disc_troubleshooting|Express Disc (64-bit) Install]]  
+
* [[Troubleshooting Amahi 8|Amahi 8 (Fedora 21)]]
  
* [[Dnsmasq_troubleshooting|dnsmasq]]
+
* [[Troubleshooting Amahi 7|Amahi 7 (Fedora 19)]]
  
* [https://www.amahi.org/apps/amahi-sync Amahi Sync] ([https://bugs.amahi.org/issues/1096 Amahi Bug 1096])
+
* [[Troubleshooting Amahi 6|Amahi 6 (Ubuntu 12.04.x LTS)]]
  
== Amahi 6 (Ubuntu 12.04.x) ==
+
== Helpful References ==
 +
* [[HDA Admin How To]]
  
* [[Ubuntu_Installation_Troubleshooting|Ubuntu Install]]
+
* [[Transition to Amahi]]
  
* Apache Web Server ([https://bugs.amahi.org/issues/1023 Amahi bug 1023])
+
* [http://www.amahi.net Interactive Network Troubleshooter]
  
= HDA Admin How To =
+
* [[Common Log Files]]
== Amahi Common ==
 
  
* [[Turning_off_DHCP_in_your_router|Disable Router DHCP Server]]:  Generic guidance for disabling DHCP server on some routers.
+
* [[App_Ports|Amahi Application Ports]]
  
* [[Changing_your_DNS_provider|Change DNS Provider]]: Change DNS from OpenDNS to different provider.
+
* [[Linux-hda_commands|Linux and HDA Commands]]
  
* [[Turning_off_DHCP|Disable DHCP Server]]: Disable DHCP server on HDA.
+
* [https://www.howtoforge.com/linux-commands Linux Commands - Overview and Examples]
  
* [[Change_IP_Address|Change Gateway IP Address]]: Change the 3rd octet of the router/client IP addresses.
+
* [http://www.webune.com/an-example-code-script-of-javascript-linux-permission-chart-table-chmod-s81.html Linux Permissions Chart]
  
* [[RenewIP|Renew Client IP Address]]: Applies to Windows, Mac OS X, and Linux.
+
* [http://www.csgnetwork.com/crongen.html Cron Job Calculator]
 
 
* [[Advanced_Settings|Enable Advanced Settings]]:  Unhides advanced areas in Network and Setup tabs.
 
 
 
* [[Open_Terminal_as_root|Open terminal as root user]]:  Command line access as root user.
 
 
 
* [[Reset_Amahi_Password|Reset User Password]]: Use to reset a user's forgotten password.
 
 
 
* [[Adding_a_second_hard_drive_to_your_HDA|Adding hard drives]]:  Command line guidance for adding hard drives to your HDA. .
 
 
 
* [[Greyhole|Greyhole]]: Setup/configure Greyhole Storage Pooling.
 
 
 
* [[Mount_Shares_Locally|Mount Shares Locally]]:  Safely manage Greyhole enabled share files locally on the HDA.
 
 
 
* [[Storage_and_file_sharing|Manage Shares]]:  Create, edit, delete, and manage file shares configuration.
 
 
 
* [[Share_Extra_Parameters|Shares Extra Parameters]]:  Manage extra options per file share, such as a recycle bin or quota.
 
 
 
* [[Networking_-_Static_IPs|Configure Static IP Address]]: Create static IP address for client devices.
 
 
 
* [[Key-Based_SSH_Logins|Secure Shell (SSH)]]:  Key-based SSH terminal access to your HDA.
 
 
 
* [[VPN|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 [http://www.amahi.org/apps/openvpn VPN] provides the capability.
 
 
 
* [[Post-Install_Hardware_Changes|Hardware Changes]]:  Steps for hardware changes on HDA (i.e. mother board, network card, etc).
 
 
 
* [[IPsec_VPN|Customize IPsec VPN]]:  How to change the secret and/or group name as well as procedure for routing all traffic through Amahi [https://www.amahi.org/apps/ipsec-vpn IPsec VPN] application.
 
 
 
* [[VNC|Virtual Network Computing (VNC)]]: Access your HDA desktop remotely from '''inside''' your network.
 
 
 
* [[Hosting_a_website|Hosting a web site]]: How to make the Amahi web server visible outside the local network.
 
 
 
== Amahi 8 (Fedora 21) ==
 
 
 
* net-tools/bind-utils (includes commands ifconfig, nslookup, netstat, and others): Not installed in Amahi 8.  Amahi application [https://www.amahi.org/apps/HDA-Troubleshooting-Tools HDA Troubleshooting Tools] provides the capability.
 
 
 
* Manual Web App Creation:  Amahi application [https://www.amahi.org/apps/web-apps Web App] provides the capability.
 
 
 
== Amahi 7 (Fedora 19) ==
 
 
 
<!--* Adding drives:  The Amahi [https://www.amahi.org/apps/disk-wizard Disk Wizard]  application provides functionality via Dashboard UI for Amahi 7.-->
 
* net-tools/bind-utils (includes commands ifconfig, nslookup, netstat, and others): Not installed in Amahi 7.  Amahi application [https://www.amahi.org/apps/HDA-Troubleshooting-Tools HDA Troubleshooting Tools] provides the capability.
 
 
 
* Manual Web App Creation:  Amahi application [https://www.amahi.org/apps/web-apps Web App] provides the capability.
 
 
 
* [[Calendars|Calendar Server]]:  This feature is currently broken in Amahi 7 ([https://bugs.amahi.org/issues/1339 Amahi bug 1339]), but guidance is provided to correct the issue.
 
 
 
* [[GUI_Install_for_Express_Disc|Express Disc Desktop]]:  Amahi 7 is headless, but guidance is provided for installing a GUI desktop.  The Amahi application [https://www.amahi.org/apps/vnc VNC] provides the Gnome 3 Desktop and remote capability.
 
 
 
== Amahi 6 (Ubuntu 12.04.x) ==
 
 
 
* Secure Shell (SSH):  Not installed in Amahi 6, but is required to remotely access your HDA, inside or outside your network.  Amahi applications [http://www.amahi.org/apps/openssh OpenSSH] and [http://www.amahi.org/apps/dropbear Dropbear] provides the capability.
 
  
* [[Web_App_Creation_Fix|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 ([https://bugs.amahi.org/issues/977 Amahi bug 977]).
+
* [https://www.shellcheck.net/ ShellCheck (script validator)]
  
= Tutorials =
+
* [[HDA OS Migration Guide]]
  
* [[Fedora_Tutorials|Fedora]]
+
* [https://wiki.amahi.org/index.php/App_release_process App Release Process]
  
* [[Ubuntu_Tutorials|Ubuntu]]
+
* [[Need More Information]]
 
 
* [[TerminalScripts|Terminal Scripts]]
 
 
 
* [[HDA_OS_Migration_Guide|HDA OS Migration Guide]]
 
 
 
= References =
 
 
 
* [http://www.amahi.net Interactive Network Troubleshooter]
 
 
 
* [[Common_Log_Files|Common Log Files List]]
 
 
 
* [[App_Ports|Amahi Web Application Ports]]
 
 
 
* [[Linux-hda_commands|Linux and HDA Commands]]
 
 
 
* [http://www.webune.com/an-example-code-script-of-javascript-linux-permission-chart-table-chmod-s81.html Linux Permissions Chart]
 
 
 
* [http://www.csgnetwork.com/crongen.html Cron Job Calculator]
 
  
* [https://www.amahi.org/videos Amahi Video Tutorials]
+
* [[Submit Bug Report|Submit a Bug Report]]

Latest revision as of 06:45, 14 February 2021