App troubleshooting - Revision history

Bigfoot65 at 23:08, 6 August 2014

2014-08-06T23:08:21Z

Bigfoot65 at 23:07, 6 August 2014

2014-08-06T23:07:48Z

Bigfoot65: /* Miscellaneous */

2014-05-08T01:47:03Z

Miscellaneous

Bigfoot65: /* Debugability */

2014-04-02T22:19:40Z

Debugability

Cpg: /* Debugability */

2012-09-30T06:28:00Z

Debugability

Bigfoot65: /* Miscellaneous */

2011-03-23T17:13:04Z

Miscellaneous

Bigfoot65: /* Miscellaneous */

2011-03-23T16:52:39Z

Miscellaneous

Bigfoot65: /* Filesystem Full */

2011-03-23T16:47:54Z

Filesystem Full

Bigfoot65: /* Filesystem Corrupt */

2011-03-23T16:47:28Z

Filesystem Corrupt

Bigfoot65: /* Filesystem Corrupt */

2011-03-23T16:45:15Z

Filesystem Corrupt

← Older revision		Revision as of 23:08, 6 August 2014
Line 1:		Line 1:
−	~~App install~~ should '''~~never~~''' fail. Period. App install failures are high priority to the [https://www.amahi.org/team Amahi Team].	+	Application installs should <u>'''NEVER'''</u> fail. Period. App install failures are high priority to the [https://www.amahi.org/team Amahi Team].

	= Debugability =		= Debugability =

← Older revision		Revision as of 23:07, 6 August 2014
Line 1:		Line 1:
−	App install should '''never''' fail. Period. App install failures are high priority.	+	App install should '''never''' fail. Period. App install failures are high priority to the [https://www.amahi.org/team Amahi Team].

	= Debugability =		= Debugability =

← Older revision		Revision as of 01:47, 8 May 2014
Line 35:		Line 35:
	<blockquote><u>Ubuntu</u></blockquote>		<blockquote><u>Ubuntu</u></blockquote>
	ps guax \| grep sab \| apaste		ps guax \| grep sab \| apaste
−
−	~~= Miscellaneous =~~
−	~~[http://www.linuxhomenetworking.com/wiki/index.php Linux Home Networking]~~

@@ Line 8: / Line 8: @@
 * Make sure httpd configuration is sane (result should be "'''Syntax OK'''"):
-{{Code|httpd -t}}
+ httpd -t
 * The idea is to not delete anything permanently - copy or move things to, say, a folder in /tmp if you have to get something out of their place. For example:
-{{code|mkdir /tmp/app-debug/}}
+ mkdir /tmp/app-debug/
 * Then add things there as necessary for later analysis, like:
-{{Code|cp -a /var/log/amahi-app-installer.log /tmp/app-debug
+ cp -a /var/log/amahi-app-installer.log /tmp/app-debug
-cp -a /etc/httpd/conf.d /tmp/app-debug}}
+ cp -a /etc/httpd/conf.d /tmp/app-debug
 The user can provide this information:
 * Copy of the app install log:
-{{Code|tail -300 /var/log/amahi-app-installer.log <nowiki>|</nowiki> apaste}}
+<blockquote><u>Fedora</u></blockquote>
-* Copy of the app error and access logs (i.e. sabnzbd is the app):
+<blockquote><u>Ubuntu</u></blockquote>
-{{Code|cat /var/hda/web-apps/sabnzbd/logs/error.log
+ tail -300 /var/log/amahi-app-installer.log | apaste
-cat /var/hda/web-apps/sabnzbd/logs/access.log}}
 * To check if process is running (i.e. sab is the app):
-{{Code|ps guax <nowiki>|</nowiki> grep sab <nowiki>|</nowiki> apaste}}
+<blockquote><u>Fedora</u></blockquote>
 = Miscellaneous =
 [http://www.linuxhomenetworking.com/wiki/index.php Linux Home Networking]

@@ Line 19: / Line 19: @@
 The user can provide this information:
 * Copy of the app install log:
-{{Code|tail -300 /var/log/amahi-app-installer.log <nowiki>|</nowiki> fpaste}}
+{{Code|tail -300 /var/log/amahi-app-installer.log <nowiki>|</nowiki> apaste}}
 * Copy of the app error and access logs (i.e. sabnzbd is the app):
@@ Line 26: / Line 26: @@
 * To check if process is running (i.e. sab is the app):
-{{Code|ps guax <nowiki>|</nowiki> grep sab <nowiki>|</nowiki> fpaste}}
+{{Code|ps guax <nowiki>|</nowiki> grep sab <nowiki>|</nowiki> apaste}}
 = Miscellaneous =
 [http://www.linuxhomenetworking.com/wiki/index.php Linux Home Networking]

← Older revision		Revision as of 17:13, 23 March 2011
Line 29:		Line 29:

	= Miscellaneous =		= Miscellaneous =
		+	[http://www.linuxhomenetworking.com/wiki/index.php Linux Home Networking]

← Older revision		Revision as of 16:52, 23 March 2011
Line 29:		Line 29:

	= Miscellaneous =		= Miscellaneous =
−	~~=== <u>Filesystem Corrupt</u> ===~~
−	Filesystems are corrupted, due to a power failure or system crash. Generally, after a system crash or power outage (what? No UPS?), the system will come up and repair itself. If you are using a journalling filesystem like ext3fs, jfs, xfs or resiserfs, it will usually perform a roll-forward recovery from its journal file and carry on. Even with the older ext2fs, the system usually runs an fsck (file system check) on the various file systems and repairs them automatically. However, just occasionally manual intervention is required - ; you might have to answer 'Y' to a string of questions (answering 'N' will get you nowhere unless you intend to perform really low-level repairs yourself in a last-ditch attempt to avoid data loss). In the worst case, you might have to reboot from rescue media and manuall run the e2fsck (or similar) command against each filesystem in turn. For example:
−	~~{{Code\|e2fsck -p /dev/hda7}}~~
−	* If the program complains that the superblock - the master block that links to everything else - is corrupted, it is useful to remember that the superblock is so critical that it is duplicated every 8192 blocks through the filesystem and you can tell e2fsck to use one of the backups:
−	~~{{Code\|e2fsck -b 8193 /dev/hda7}}~~
−	* One or more filesystems cannot be found and mounted: Check the contents of /etc/fstab - in making quick alterations here, typographical errors are common. You can use the e2label command to view the label of each filesystem: some distributions set these to the mount point so you can figure out what is what.
−
−	~~=== <u>Filesystem Full</u> ===~~
−	Is a filesystem full? This can show up in lots of different ways: being unable to save files, print jobs not spooling correctly (especially on Samba print/file servers), and so on. Use the df command to see available space:
−
−	~~<pre>[root@freya home]# df -H~~
−	~~Filesystem Size Used Avail Use% Mounted on~~
−	~~/dev/Volume00/LogVol00 520MB 254MB 240MB 52% /~~
−	~~/dev/hda3 128MB 2 1MB 101MB 17% /boot~~
−	~~/dev/Volume00/LogVol03 2.2GB 134MB 1.9GB 7% /home~~
−	~~/dev/Volume00/LogVol05 520MB 8.5MB 485MB 2% /opt~~
−	~~none 264MB 0 264MB 0% /dev/shm~~
−	~~/dev/Volume00/LogVol02 1.1GB 36MB 969MB 4% /tmp~~
−	~~/dev/Volume00/LogVol01 4.3GB 3.0GB 1.1GB 75% /usr~~
−	~~/dev/Volume00/LogVol06 1.1GB 101MB 903MB 11% /usr/local~~
−	~~/dev/Volume00/LogVol04 3.2GB 2.3GB 756MB 75% /var~~
−	~~/dev/hda1 16GB 13GB 2.8GB 83% /mnt/winc</pre>~~
−
−	* Remember that a filesystem can fill up either because almost all of its data blocks are used up (some are reserved for the root user, just to get out of trouble) or because all its i-nodes (there is one of these per file) are used up.
−	* If you need to make space by deleting some large files, use the command 'ls -lS' to get a directory listing that is sorted by file size. To scan an entire filesystem (e.g. /home or /var) for the largest files, use the command:
−	~~{{Code\|du <nowiki>\|</nowiki> sort -n}}~~
−	~~The largest files will be at the end of the listing.~~

@@ Line 54: / Line 54: @@
 * Remember that a filesystem can fill up either because almost all of its data blocks are used up (some are reserved for the root user, just to get out of trouble) or because all its i-nodes (there is one of these per file) are used up.
 * If you need to make space by deleting some large files, use the command 'ls -lS' to get a directory listing that is sorted by file size. To scan an entire filesystem (e.g. /home or /var) for the largest files, use the command:
-{{Code|du | sort -n}}
+{{Code|du <nowiki>|</nowiki> sort -n}}
 The largest files will be at the end of the listing.

@@ Line 30: / Line 30: @@
 = Miscellaneous =
 === <u>Filesystem Corrupt</u> ===
-* Filesystems are corrupted, due to a power failure or system crash. Generally, after a system crash or power outage (what? No UPS?), the system will come up and repair itself. If you are using a journalling filesystem like ext3fs, jfs, xfs or resiserfs, it will usually perform a roll-forward recovery from its journal file and carry on. Even with the older ext2fs, the system usually runs an fsck (file system check) on the various file systems and repairs them automatically. However, just occasionally manual intervention is required - ; you might have to answer 'Y' to a string of questions (answering 'N' will get you nowhere unless you intend to perform really low-level repairs yourself in a last-ditch attempt to avoid data loss). In the worst case, you might have to reboot from rescue media and manuall run the e2fsck (or similar) command against each filesystem in turn. For example:
+Filesystems are corrupted, due to a power failure or system crash. Generally, after a system crash or power outage (what? No UPS?), the system will come up and repair itself. If you are using a journalling filesystem like ext3fs, jfs, xfs or resiserfs, it will usually perform a roll-forward recovery from its journal file and carry on. Even with the older ext2fs, the system usually runs an fsck (file system check) on the various file systems and repairs them automatically. However, just occasionally manual intervention is required - ; you might have to answer 'Y' to a string of questions (answering 'N' will get you nowhere unless you intend to perform really low-level repairs yourself in a last-ditch attempt to avoid data loss). In the worst case, you might have to reboot from rescue media and manuall run the e2fsck (or similar) command against each filesystem in turn. For example:
 {{Code|e2fsck -p /dev/hda7}}
 * If the program complains that the superblock - the master block that links to everything else - is corrupted, it is useful to remember that the superblock is so critical that it is duplicated every 8192 blocks through the filesystem and you can tell e2fsck to use one of the backups:
 {{Code|e2fsck -b 8193 /dev/hda7}}
 * One or more filesystems cannot be found and mounted: Check the contents of /etc/fstab - in making quick alterations here, typographical errors are common. You can use the e2label command to view the label of each filesystem: some distributions set these to the mount point so you can figure out what is what.