1# init常见问题指导
2
3## 服务进程相关问题
4
5### 系统服务进程退出后不自动重启
6
7    查看服务进程的cfg文件，是否将"once"项配置为1；该项若为1，则表示为一次性进程，进程退出后不会再被init拉起
8
9### 如何默认disable系统服务进程
10
11    当前服务的cfg文件中配置"disable" 项未启用，可以通过配置"start-mode" 项来控制启动方式
12
13### 如何关闭系统服务进程沙盒
14
15    在服务的cfg文件中配置 "sandbox" : 0 即服务不进入沙盒、1为进入沙盒，默认服务是进入沙盒
16
17### 服务不存在
18
19  **现象描述**
20
21  kernel日志打印 "Failed get servName"。
22
23  **原因分析**
24
25  在init中查找对应的代码位置，发现是服务不存在。
26
27  **解决方法**
28
29  1. 确认服务是否在cfg中正确配置。
30  2. 服务的cfg文件是否正常加载。
31  3. cfg文件格式是否正确。
32## init开机启动相关问题
33
34### 卡在开机Logo界面
35
36 1. 原因分析：init 二级启动没有完成。
37
38    解决方法：执行begetctl setloglevel 0并重启设备，通过串口查看内核日志。确认init的二级启动是否正常完成，关键log如下：
39
40  ```
41  [32.173144][pid=1] [Init] [INFO] [init.c:206]Start init second stage.
42  [33.173144][pid=1] [Init] [DEBUG] [init.c:206]Parse init configs from /etc/init.cfg.
43  ```
44
45​  如果此时hdcd服务没有启动，或者分区没有挂载好，无法执行begetctl 命令。需要修改init 代码，设置log等级。确保init 的debug        log能正常输出。
46
47 2. 原因分析：init.cfg 解析失败。
48
49    1. cfg json格式错误。
50    2. 无法正确解析：无权限或权限受限。
51
52    解决方法：
53
54      1. 排查cfg文件json格式， init cfg文件遵循json格式，按要求修改cfg文件。
55      2. 日志中有 permission denied，init 进程报权限问题。1. 判断是否是selinux 导致的，关闭selinux 重新验证，如果正常，无权限报错。则是selinux 策略配置不正确导致的。 请配置正确的selinux 策略。selinux 策略配置，请参考base/security/selinux_adapter 仓中的说明。
56
57  3. 原因分析：required mount 分区没有正常挂载。
58
59     1. cmdline中没有配置或格式错误。
60     2. ramdisk中没有fstag.requried 文件。
61
62     解决方法：
63
64       1. 查看日志， 查看Kernel command line 中是否required mount 分区配置；如果配置，查看cmdline格式是否出错，按照格式修改或添加命令。
65
66          ```
67          [0.000000] Kernel command line: currentslot=0 bootslots=0 rw rootwait earlycon=uart8250,mmio32,0xfe660000 console=ttyFIQ0 ohos.boot.eng_mode=on root=PARTUUID=614e0000-0000 hardware=rk3568 default_boot_device=fe310000.sdhci ohos.required_mount.system=/dev/block/platform/fe310000.sdhci/by-name/system@/usr@ext4@ro,barrier=1@wait,required ohos.required_mount.vendor=/dev/block/platform/fe310000.sdhci/by-name/vendor@/vendor@ext4@ro,barrier=1@wait,required ohos.required_mount.misc=/dev/block/platform/fe310000.sdhci/by-name/misc@none@none@none@wait,required ohos.required_mount.bootctrl=/dev/block/platform/fe310000.sdhci/by-name/bootctrl@none@none@none@wait,required
68          ```
69
70           或 在设备中通过cat /proc/cmdline 查看。
71
72       2. 查看 ramdisk.img 中是否存在fstab.required文件。
73
74  4. 原因分析：com.ohos.launcher 没有启动， 导致无开机动画。
75
76     1. ps -ef 查看com.ohos.launcher是否存在。
77
78     解决方案：根据日志具体分析。
79
80  5. 原因分析： bootanimation 启动失败。
81
82     1. 查看bootanimation服务是否被拉起。
83     2. 判断bootanimation是否被重复拉起。
84
85     解决方法：
86
87     1. 在日志中查看log：
88
89        ```
90        [10.175192] [pid=1] [Init] [INFO] [init_service_manager.c:1088]Start service bootanimation
91        ```
92
93         表示服务启动。
94
95  6. 原因分析：data分区没有正常挂载
96
97     1. 设备分区表没有配置userdata分区。
98     2. device的fstab 中没有给出data分区的挂载配置。
99     3. device 给的fstab中配置的文件系统与userdata 镜像实际的文件系统不匹配。如fstab 中配置的是ext4, 而userdata 镜像实际的文件系统是f2fs。
100
101     解决方法：
102
103     对应的关键内核日志:
104
105     1. "wait for file:/dev/block/platform/soc/10100000.himci.eMMC/by-name/userdata failed after"。
106     2. 日志中看不到userdata 任何挂载相关的输出。
107     3. "Mount /dev/block/platform/soc/10100000.himci.eMMC/by-name/userdata to /data failed",  如果fstab 配置了nofail, log 有"Mount no fail     device /dev/block/platform/soc/10100000.himci.eMMC/by-name/userdata to /data failed"
108      nofail，表示该设备的挂载，不可以失败。
109
110### 卡在开机动画界面
111
112  原因分析：
113
114    1. 开机动画没有正常退出。
115    2. 系统应用孵化失败。
116    3. 服务上报bootevent不完整，所有注册了bootevent 的服务，没有全部上报。
117
118  解决方法：
119
120    1. 查看服务是否在反复重启， 重启服务是否配置critical。
121    2. ps -ef | grep ohos, 确定系统应用是否存在；日志中有 permission denied，init进程报权限问题。 确认系统应用权限，关闭selinux， 重新验证，如果正常， 则是selinux 策略配置不正确导致，重新配置或添加对应的selinux权限。 [selinux 策略配置](https://gitee.com/openharmony/security_selinux_adapter#%E6%97%A5%E5%BF%97%E4%BF%A1%E6%81%AF) 请参考base/security/selinux_adapter 仓中的说明。
122    3. 通过bootevent事件分析， 通过排查没有上报的bootevent的服务， 可能会导致开机动画卡死，比如systemUI。
123
124### 自动重启
125
126  原因分析：
127
128    1. init服务中定义“importance”的属性。
129    2. critcial 使能， 关键进程符合critical 会重启。
130    3. init进程挂掉会导致panic。
131
132  解决方法：
133
134    1. 小型系统中服务配置importance属性为0，importance: 0重启， 1 不重启。
135    2. 关键进程服务配置critcial 会导致进程重启。
136    3. CloseStdio();之前执行execv("/bin/sh", NULL)。
137
138### reboot命令无法重启
139
140  原因分析：
141    1. reboot 插件安装失败。
142    2. reboot 命令错误。
143    3. ohos.startup.powerctrl reboot 系统参数设置失败。
144    4. reboot selinux 权限受限。
145
146  解决方法：
147
148    1. 插件安装成功，在板子中查看/system/lib/init/reboot/librebootmodule.z.so是否安装成功。
149    2. 执行begetctl setloglevel 0设置日志级别，日志打印：
150
151    ```
152    08-10 18:48:07.653  1421  1421 D C02c0b/BEGET: [init_reboot_innerkits.c:51]Reboot cmd reboot
153    ```
154
155    ​       查看 reboot 命令， reboot命令不超过96。
156
157    3. hdc shell 执行param set ohos.startup.powerctrl reboot， 观察是否重启， 重启表示系统参数设置成功。
158    4. 日志中有 permission denied，init 进程报权限问题。关闭selinux, 重新验证， 如果验证成功，则是selnux策略配置不正确导致， 重新配置或添加对应的selinux权限。 [selinux 策略配置](https://gitee.com/openharmony/security_selinux_adapter#%E6%97%A5%E5%BF%97%E4%BF%A1%E6%81%AF) 请参考base/security/selinux_adapter 仓中的说明。
159
160### 系统启动过程中打印“parse failed!”错误后停止启动
161
162  **现象描述**
163
164  系统启动过程中，打印“[Init] InitReadCfg, parse failed! please check file /etc/init.cfg format.”错误，启动过程停止，如下图所示：
165
166    **图1** 运行报错图
167
168    ![zh-cn_image_0000001200053087](figures/zh-cn_image_0000001200053087.png)
169
170  **可能原因**
171
172  修改init.cfg文件时，漏掉或多加了逗号或括号等，导致init.cfg文件的json格式被破坏。
173
174  **解决办法**
175
176  仔细检查init.cfg文件，确保其格式符合json格式要求。
177
178### 请求其他服务代持fd，init有报错
179
180  **现象描述**
181
182  kernel日志打印 "Service ' xxx '(pid = xxx) is not valid or request with unexpected process(pid = xxx)"。
183
184  **原因分析**
185
186  kernel日志打印，都是由init 打印。在init中查找对应的代码位置。发现是其他服务代持fd。
187
188  **解决方法**
189
190  只支持代持本服务的fd，不允许让其他服务代持fd。