服务管理

概述

功能简介

服务配置支持按需配置服务，并根据业务场景，支持多种增值服务。当前支持的增值服务包括启动控制、按需启动、命令执行、定时启动、fd代持、沙盒。

基本概念

• init服务参数选项列表

  参见service字段说明。

• init服务启动控制(仅标准系统以上提供)

  init会根据用户的服务配置，把服务分成三类，在不同的阶段并行启动。

  • “boot”类型：对应系统中需要优先启动的服务，该类服务在“init”阶段启动。
  • “normal”类型：默认配置，对应系统中的普通服务，该类服务在“post-init"阶段启动。
  • “condition”类型：必须通过启动命令启动，通过在jobs中添加“start xxxx”来启动对应服务。

• init服务支持命令执行(仅标准系统以上提供)

  init提供服务命令执行能力，在服务执行的不同阶段执行不同的命令。

  • "on-start"：在服务进程被fork后在子进程中执行，只对该进程产生影响。
  • "on-stop"：在服务停止时执行，在init进程中执行。
  • "on-restart"：在服务重启时执行，在init进程中执行。

  参考配置如下：

  "services" : [{
        "name" : "serviceName",
        "path" : ["/system/bin/serviceName"]
        "jobs" : {
            "on-boot" : "boot",
            "on-start" : "services:serviceName_start",
            "on-stop" : "services:serviceName_stop",
            "on-restart" : "services:serviceName_restart"
       }
  },
  

  通过并行启动和命令执行能力，可以实现进程的并行启动。

• init按需启动(仅标准系统以上提供)

  配置按需启动后，init进程不会启动对应的服务，只有服务被需要时才会被拉起。通过"ondemand"标记来控制服务是否被拉起。

  “ondemand”参考配置如下：

    "services" : [{
      "name" : "serviceName",
      "path" : ["/system/bin/serviceName"]
      "ondemand" : true
  }]
  

  • SA进程按需启动

    具体参考 samgr组件(说明3)。

  • socket进程按需启动

    1. init进程在pre-fork阶段为socket类进程创建好socket，init进程中监听创建好的socket上的读写事件。
    2. socket上有读写事件后，init进程拉起socket进程对应的native服务，并取消对socket的监听，将socket交由相应的native服务管理。
    3. native服务无报文处理后，可以自动退出。init进程在回收子进程时会根据服务配置重新监听socket。

  • 热插拔服务进程按需启动

    进程可根据系统参数的变化进行热插拔事件按需启动处理。

• init进程启动&回收能力增强

  进程启动时，支持在配置文件中配置服务进程的绑核、优先级、MAC信息以及AccessToken信息。

  • init提供修改*.cfg配置文件，为服务进程提供CPU绑核功能。
  • init提供修改*.cfg配置文件，为服务进程提供优先级设置。
  • init提供修改*.cfg配置文件，为服务提供MAC信息设置，即服务的SELinux标签（需要selinux支持）。
  • init提供修改*.cfg配置文件，为服务提供设置AccessToken, 为系统服务进程设置其分布式Capability能力（仅标准系统以上提供）。
  • init提供修改*.cfg配置文件，为服务提供抑制机制。

  服务进程启动&回收能力增强配置，如下：

  "services" : [{
      "name" : "serviceName",
      "path" : ["/system/bin/serviceName"]
      "importance" : 1,                  // 服务进程提供优先级设置
      "cpucore" : [0],                   // 服务进程提供CPU绑核功能
      "critical" : [1, 5, 10],           // 服务提供抑制机制
      "apl" : "normal",                  // 系统服务进程设置其分布式Capability能力
      "d-caps" : ["OHOS_DMS"],           // 系统服务进程设置其分布式Capability能力
      "secon" : "u:r:distributedsche:s0" // 服务的SELinux标签， "u:r:distributedsche:s0"为要设置的SELinux标签信息
  }
  

• 添加selinux标签

  服务配置selinux策略，需要通过"secon"为服务添加selinux标签。例如为watchdog_service添加selinux标签，如下:

  "services" : [{
            "name" : "watchdog_service",
            "secon" : "u:r:watchdog_service:s0"
  }]
  

  对应的需要在selinux中定义此标签，定义方法与配置文件参照selinux指导文档

• init FD代持（仅标准系统以上提供）

  FD代持是按需启动的一个辅助扩展机制，按需启动进程可以保持退出前的fd状态句柄不丢失。按需启动进程退出前可将fd发送给init代持，再次启动后再从init获取fd。

  init提供了相关接口供服务调用，服务进程退出前调用接口将fd通过支持IPC通信的socket发送给init代持，待该服务重新启动时，init将持有的该服务相关的fd句柄通过同样的方式返回给服务。相关接口参考：FD代持接口介绍。

• 定时启动

  通过约定时间拉起服务， 若服务已拉起， 则不在重新拉起服务。具体命令参考： begetctl命令说明 。

  timer_start servicename timeout
  

• 沙盒

  具体参考 沙盒指导。

约束与限制

仅限小型系统、标准系统下使用。

开发指导

场景介绍

通过对*.cfg文件的解析， 获取service中的属性， 设置并启动service。

参数说明

表1 service字段说明

表2 socket字段说明

接口说明

表3 FD代持接口介绍

表4 服务控制接口介绍

• 服务控制接口的DAC配置

  服务控制接口配置DAC，需要修改/base/startup/init/services/etc/group文件，在组servicectrl中添加对应的用户id，例如：

  servicectrl:x:1050:root,shell,system,samgr,hdf_devmgr
  

• 服务控制接口的selinux配置

  服务控制接口配置selinux，需要在init.te文件中添加该服务接口所需要的selinux权限，例如为init、samgr、hdf_devmgr等服务配置系统参数写权限：

  allow { init samgr hdf_devmgr } servicectrl_param:parameter_service { set };
  

开发步骤

此处以要新增一个名为MySystemApp的系统服务为例进行说明，使用如下配置：

{
    "jobs" : [{
    "name" : "pre-init",
    "cmds" : [
        "mkdir /storage/MyDir",       // MySystemApp服务启动之前需要先创建文件夹，因此放在 “pre-init”中进行
        "chmod 0600 /storage/MyDir",  // MySystemApp服务要求该文件夹只有本用户和属组才可读写，因此需要修改权限
        "chown 10 10 /storage/MyDir"
        ]
}, {
      "name" : "init",
      "cmds" : [
          "start MySystemApp"         // 在init中启动该系统服务
      ]
}, {
    "name" : "post-init",
    "cmds" : []                       // MySystemApp系统服务启动后无需进行其他操作，因此不用配置“post-init”
    }
],
    "services" : [{
        "name" : "MySystemApp",       // 系统服务名称
        "path" : ["/bin/MySystemAppExe", "param1", "param2", "param3"],    // MySystemApp系统服务的可执行文件路径为"/bin/MySystemAppExe"，其启动需要传入三个参数，分别是"param1"、"param2"和"param3
        "socket" : [{
          "name" : "ueventd",
          "family" : "AF_NETLINK",
          "type" : "SOCK_DGRAM",
          "protocol" : "NETLINK_KOBJECT_UEVENT",
          "permissions" : "0660",
          "uid" : "system",
          "gid" : "system",
          "option" : [
            "SOCKET_OPTION_PASSCRED",
            "SOCKET_OPTION_RCVBUFFORCE",
            "SOCK_CLOEXEC",
            "SOCK_NONBLOCK"
          ]
        }],
        "uid" : 20,                   // MySystemApp系统服务的uid是20
        "gid" : 20,                   // MySystemApp系统服务的gid是20
        "once" : 0,                   // MySystemApp系统服务的非一次性进程，即如果MySystemApp系统服务因任何原因退出，init进程需要将其重新拉起
        "importance" : 0,             // MySystemApp系统服务不是关键系统进程，即如果MySystemApp系统服务因任何原因退出，init进程无需重启单板
        "caps" : [],                  // MySystemApp系统服务不需要任何capability权限（即MySystemApp系统服务不涉及与capability相关的操作）
        "start-mode" : "condition",
        "critical": [1, 2, 10],       //MySystemApp系统服务的critical配置，需传入三个参数， 分别为使能：1， 执行次数：2， 执行时间：10
        "cpucore" : [0, 1],           // 设备为双核， 且都绑定cpu
        "apl" : "system_core",
        "d-caps" : ["OHOS_DMS"],
        "jobs" : {
            "on-boot" : "boot",
            "on-start" : "services:MySystemApp_start",
            "on-stop" : "services:MySystemApp_stop",
            "on-restart" : "services:MySystemApp_restart"
        }
      }
    ]
}

完成配置后，编译出包烧写单板：

1. 启动后使用task -a（liteos-a版本）或ps命令（linux版本）查看是否MySystemApp系统服务进程已启动。
2. 使用kill命令将上述新增的MySystemApp进程杀死，观察该进程是否会被重新拉起（此处应该为重新拉起）。
3. 使用kill命令将上述新增的MySystemApp进程杀死，观察是否会导致单板重启（此处应该为不重启）。

常见问题

服务不存在

现象描述

kernel日志打印 "Failed get servName"。

原因分析

在init中查找对应的代码位置，发现是服务不存在。

解决方法

1. 确认服务是否在cfg中正确配置。
2. 服务的cfg文件是否正常加载。
3. cfg文件格式是否正确。

请求其他服务代持fd，init有报错

现象描述

kernel日志打印 "Service ' xxx '(pid = xxx) is not valid or request with unexpected process(pid = xxx)"。

原因分析

kernel日志打印，都是由init 打印。在init中查找对应的代码位置。发现是其他服务代持fd。

解决方法

只支持代持本服务的fd，不允许让其他服务代持fd。