Browse code
Added sections to Photon OS Troubleshooting Guide.
Change-Id: I155ac70e968e9280b93762f880004eee89649942
Reviewed-on: http://photon-jenkins.eng.vmware.com:8082/1514
Tested-by: gerrit-photon <photon-checkins@vmware.com>
Reviewed-by: suezzelur <anishs@vmware.com>
shoenisch authored on 2016/10/13 07:01:08Showing 1 changed files
| ... | ... |
@@ -72,8 +72,8 @@ |
| 72 | 72 |
- [Fixing File System Errors When fsck |
| 73 | 73 |
Fails](#fixing-file-system-errors-when-fsck-fails) |
| 74 | 74 |
- [Packages](#packages) |
| 75 |
-- [Troubleshooting Kernel Problems, Boot Problems, and Login |
|
| 76 |
- Problems](#troubleshooting-kernel-problems-boot-problems-and-login-problems) |
|
| 75 |
+- [Kernel Problems and Boot and Login |
|
| 76 |
+ Problems](#kernel-problems-and-boot-and-login-problems) |
|
| 77 | 77 |
- [Kernel Overview](#kernel-overview) |
| 78 | 78 |
- [Boot Process Overview](#boot-process-overview) |
| 79 | 79 |
- [Blank Screen on Reboot](#blank-screen-on-reboot) |
| ... | ... |
@@ -83,8 +83,8 @@ |
| 83 | 83 |
On](#investigating-the-guest-kernel-when-you-cannot-log-on) |
| 84 | 84 |
- [Kernel Log Replication with |
| 85 | 85 |
VProbes](#kernel-log-replication-with-vprobes) |
| 86 |
-- [Troubleshooting Performance |
|
| 87 |
- Issues](#troubleshooting-performance-issues) |
|
| 86 |
+- [Performance Issues](#performance-issues) |
|
| 87 |
+ |
|
| 88 | 88 |
|
| 89 | 89 |
|
| 90 | 90 |
## Introduction |
| ... | ... |
@@ -93,7 +93,7 @@ This guide describes the fundamentals of troubleshooting problems on Photon OS. |
| 93 | 93 |
|
| 94 | 94 |
This guide covers the basics of troubleshooting systemd, packages, network interfaces, services such as SSH and Sendmail, the file system, and the Linux kernel. The guide includes a quick tour of the tools that you can use for troubleshooting and provides examples along the way. The guide also demonstrates how to access the system's log files. |
| 95 | 95 |
|
| 96 |
-For information on how to set up and manage Photon OS, see the [Photon OS Administration Guide](https://github.com/vmware/photon/blob/master/docs/photon-admin-guide.md). |
|
| 96 |
+For information on how to install and manage Photon OS, see the [Photon OS Administration Guide](https://github.com/vmware/photon/blob/master/docs/photon-admin-guide.md). |
|
| 97 | 97 |
|
| 98 | 98 |
### Systemd and TDNF |
| 99 | 99 |
|
| ... | ... |
@@ -101,7 +101,7 @@ Two characteristics of Photon OS stand out: It manages services with systemd, an |
| 101 | 101 |
|
| 102 | 102 |
By using systemd, Photon OS adopts a contemporary Linux standard to bootstrap the user space and concurrently start services--an architecture that differs from traditional Linux systems such as SUSE Linux Enterprise Server 11. |
| 103 | 103 |
|
| 104 |
-[[Image:photon-logo.png|right]] |
|
| 104 |
+<!-- [[Image:photon-logo.png|right]] --> |
|
| 105 | 105 |
|
| 106 | 106 |
A traditional Linux system contains an initialization system called SysVinit. With SLES 11, for instance, SysVinit-style init programs control how the system starts up and shuts down. Init implements system runlevels. A SysVinit runlevel defines a state in which a process or service runs. In contrast to a SysVinit system, systemd defines no such runlevels. Instead, systemd uses a dependency tree of _targets_ to determine which services to start when. |
| 107 | 107 |
|
| ... | ... |
@@ -1248,7 +1248,7 @@ If you find a package that is installed but is not working, try re-installing it |
| 1248 | 1248 |
Reinstalling: |
| 1249 | 1249 |
shadow x86_64 4.2.1-7.ph1 3.85 M |
| 1250 | 1250 |
|
| 1251 |
-## Kernel Problems, Boot Problems, and Login Problems |
|
| 1251 |
+## Kernel Problems and Boot and Login Problems |
|
| 1252 | 1252 |
|
| 1253 | 1253 |
### Kernel Overview |
| 1254 | 1254 |
|
| ... | ... |
@@ -1573,10 +1573,27 @@ Finally, run the following command to print all the kernel messages from Photon |
| 1573 | 1573 |
You can use a directory other than `tmp` if you want. |
| 1574 | 1574 |
|
| 1575 | 1575 |
<!-- |
| 1576 |
-## Deep Kernel Analysis with the Crash Utility |
|
| 1576 |
+### Deep Kernel Analysis with the Crash Utility |
|
| 1577 | 1577 |
|
| 1578 | 1578 |
--> |
| 1579 | 1579 |
|
| 1580 |
+<!-- |
|
| 1581 |
+ |
|
| 1582 |
+### Go to the Debug Shell |
|
| 1583 |
+ |
|
| 1584 |
+‘ panic=1 init=/bin/bash’ |
|
| 1585 |
+mount –o rw,remount / |
|
| 1586 |
+cd /lib/systemd/system/multi-user.target.wants |
|
| 1587 |
+ln –s ../debug-shell.service |
|
| 1588 |
+umount / |
|
| 1589 |
+sync |
|
| 1590 |
+exit |
|
| 1591 |
+ |
|
| 1592 |
+After reboot debug-shell will be available on tty9. No password required. |
|
| 1593 |
+ |
|
| 1594 |
+--> |
|
| 1595 |
+ |
|
| 1596 |
+ |
|
| 1580 | 1597 |
## Performance Issues |
| 1581 | 1598 |
|
| 1582 | 1599 |
Performance issues can be difficult to troubleshoot because so many variables play a role in overall system performance. Interpreting performance data often depends on the context and the situation. To better identify and isolate variables and to gain insight into performance data, you can use the troubleshooting tools on Photon OS to diagnose the system. |
| ... | ... |
@@ -1602,13 +1619,3 @@ In addition, `systemd-analyze`, which reveals performance statistics for boot ti |
| 1602 | 1602 |
The additional tools that you select depend on the clues that your initial investigation reveals. The following tools can also help troubleshoot performance: `sysstat`, `sar`, `systemtap`, and `crash`. |
| 1603 | 1603 |
|
| 1604 | 1604 |
|
| 1605 |
- |
|
| 1606 |
- |
|
| 1607 |
- |
|
| 1608 |
- |
|
| 1609 |
- |
|
| 1610 |
- |
|
| 1611 |
- |
|
| 1612 |
- |
|
| 1613 |
- |
|
| 1614 |
- |