用户指南

1 操作视频流云手机实例

1.1 启动视频流云手机实例

可根据需求配置cfct_config文件中的参数启动不同分辨率和帧率的视频流云手机实例，配置default.prop文件中的初始视频编码参数。当后续使用APK访问视频流云手机时，可以在APK视图中修改抓图分辨率。

1. （可选）若需要启动不同帧率的视频流云手机实例，则需要修改cfct_config配置文件中的帧率属性值。默认帧率为30fps，720p和1080p分辨率下也可支持60fps。

   BUILD_FPS=30

2. （可选）若需要启动使能C2解码器的视频流云手机实例（配置方案一可用），则需要修改cfct_config配置文件中的ENABLE_AMD_C2_DECODE=1。其他值不使能，默认为0。必须在容器第一次启动时配置开/关C2解码器，不支持中途切换。云手机内置应用会根据自身需要自行选择解码器。

   ENABLE_AMD_C2_DECODE=0

3. 若需要启动不同初始编码参数、抓图分辨率、音频视频输出格式的视频流云手机实例，则需要进行以下配置。

   1. 从DemoVideoEngine.tar.gz中解压获取“vendor”文件夹，并将其中的“default.prop”文件拷贝至当前目录。

      cd /home/kbox_video/
      tar -xvf DemoVideoEngine.tar.gz vendor
      cp vendor/default.prop .

   2. 配置初始化编码参数。通过修改default.prop中对应属性值来初始化编码参数，属性描述请参见3.2.1-启动脚本配置项章节的视频流引擎属性配置字段描述表，参考vmi.video.encode开头的属性。

   3. 配置抓图分辨率。通过修改default.prop中对应属性值来修改抓图分辨率，属性描述请参见3.2.1-启动脚本配置项章节的视频流引擎属性配置字段描述表，参考vmi.video.frame开头的属性。如果要改变分辨率，建议同步在cfct_config文件中修改屏幕像素密度以达到最佳显示效果，推荐的配置说明如下表 1 不同分辨率配置说明所示。

      表 1 不同分辨率配置说明

      屏幕宽度（BUILD_WIDTH）	屏幕密度（BUILD_DENSITY）
      360	120
      480	160
      720	320
      1080	480
      1440	640
      2160	960

      改变视频输出分辨率（与上次启动时配置不同）时，会改变AOSP系统和应用的渲染分辨率，可能会导致部分应用出现兼容性问题或渲染问题。一般此类问题可以通过重新启动应用解决，因此建议在修改分辨率前返回桌面，同时清空后台应用，以提升用户使用体验。 修改default.prop后直接启动容器不会立即生效，需要在启动容器时手动重启一次容器才能生效。

   4. 配置视频和音频的输出格式。

      若使用APK方式访问视频流云手机实例，可通过default.prop中修改视频和音频的输出格式，可配置的属性字段请参见3.2.1-启动脚本配置项章节的视频流属性配置项字段描述表。

4. 启动视频流云手机。

   cd /home/kbox_video/
   ./cfct_video start ${index1} 

   上述命令中 ${index1} 为启动实例的编号。启动一个编号为1的视频流云手机示例：

   ./cfct_video start 1

   启动容器的过程中可能会出现“writing syncT "procError"、exec /system/bin/chmod: no such file、/system/bin/getprop:no such file”等类似报错，该报错不影响正常功能，忽略即可。 若需要启动多路，则使用如下命令。

   ./cfct_video start ${start_index} ${end_index}

   若需要使用NFS挂载启动视频流云手机，将start改成nstart，例：

   ./cfct_video nstart ${start_index} ${end_index}

5. 查看基于Docker容器运行时的视频流云手机。

   docker ps -a

   回显示例如下。

   

   确认所启动的容器存在，且状态正常。

6. 确认基于Docker容器运行时的视频流云手机是否启动成功，其中 ${index} 为启动实例的编号，参见5中命令回显所示的最后一列，如 android_35， ${index} 即为35。

   docker exec -it android_${index} sh 

   getprop sys.boot_completed

   如果回显信息中sys.boot_completed显示为“1”，则表示启动成功。

   

1.2 查询组件版本号信息

本章节提供两种方法获取视频流引擎组件版本信息，通过获取的软件包和API对外接口进行查询版本号信息。

方法一：通过获取的软件包查询版本号信息

1. 请参见视频流引擎 安装指南获取BoostKit-boostcph-videoengine_*_15.zip进行解压缩，获取版本文件。

2. 查看视频流引擎组件版本。

   unzip BoostKit-boostcph-videoengine_*_15.zip
   tar -xvf  VideoEngine.tar.gz vendor/etc/videoengine_version.txt
   cat vendor/etc/videoengine_version.txt

   回显信息即为视频流引擎组件版本号信息，示例如下。

   Product Name: Kunpeng BoostKit
   Product Version: 26.0.RC1
   Component Name: BoostKit-boostcph-videoengine
   Component Version: 8.0.RC1
   Component AppendInfo: 15.0.0_r17

方法二：通过视频流引擎对外API获取版本信息

请参见视频流引擎 开发指南中“对外接口”章节的“GetVersion”接口使用方法，通过调用该API获取版本信息，回显示例与方法一中的回显示例相同。

1.3 访问视频流云手机

1.3.1 APK方式访问

若使用默认方式启动视频流云手机时，可以通过apk方式访问云手机。

1. 解压CloudPhoneApk.tar.gz。

2. 在Android手机上安装CloudPhone.apk。

3. （可选）点击右上角齿轮，进入设置页。

   

4. 返回至主页面，自上而下依次输入服务器IP地址、${port}，双击“开始连接”即可访问云侧的视频流云手机，如下图所示。

   ${port} 默认值为 8000 + ${index}。

   

   • 每个视频流云手机实例需要设置端口 ${port} ，部署时可进入cfct_video脚本设置合适的 ${port}，端口号取值范围为1024~65535，且不能使用已占用端口号从而避免出现端口竞争，导致视频流云手机无法访问。
   • 视频流引擎客户端为64位，需要运行在鸿蒙系统或Android 7版本以上的64位Android系统手机上。
   • 请确保手机和服务器之间网络畅通。

1.4 （可选）动态修改云手机参数

通过CloudPhone.apk可以动态修改云手机运行时的视频编码、音频播放编码参数。

1. 连接云手机后，点击屏幕上的齿轮按钮。

   

2. 设置视频编码参数。

   1. 点击图中视频图标。

      

   2. 进入视频编码参数设置界面。

      参数取值范围，请参见3.2.1-启动脚本配置项章节中视频流引擎属性配置项中对应字段，参考vmi.video.encode开头的属性。出流分辨率分为3个可选清晰度档位：360P、720P、1080P。

      

   3. 设置完成后，点击发送按钮后编码参数将会被发送到服务端，如果参数合法，将立即生效。

      启动后需在容器内通过setprop命令更改对应属性，属性描述请参见3.2.1-启动脚本配置项章节的视频流引擎属性配置字段描述表。

3. 设置音频播放编码参数。

   1. 点击图中音频图标。

      

   2. 进入音频播放编码参数设置界面。

      参数取值范围，请参见3.2.1-启动脚本配置项章节中视频流引擎属性配置项中对应字段，参考vmi.audio.encode开头的属性。

      

   3. 设置完成后，点击发送按钮后编码参数将会被发送到服务端，如果参数合法，将立即生效。

1.5 重启视频流云手机实例

使用cfct_video脚本重启视频流云手机实例。

重启编号为 ${index1} 的视频流云手机。

./cfct_video restart ${index1}

1.6 删除视频流云手机实例

使用cfct_video脚本删除视频流云手机实例。

删除编号为 ${index1} 的视频流云手机。

./cfct_video delete ${index1}

./cfct_video ndelete ${index1}

2 K8s集群下操作视频流云手机实例

2.1 启动道客设备插件

在master节点下启动道客设备插件，启动前需要获取视频流服务端tar包组件，用于获取Kbox容器音视频数据等。

请参见视频流引擎 安装指南获取DemoVideoEngine.tar.gz软件包，获取后将软件包上传至服务器的“/home/k8s”目录。

1. 解压DemoVideoEngine.tar.gz。

   cd /home/k8s/
   tar -xvf DemoVideoEngine.tar.gz

2. 在指定K8s节点创建标签label（va-device=va-sg100）。

   kubectl label nodes $NODENAME va-device=va-sg100

   “$NODENAME”为工作节点名称。

3. 创建命名空间va-plugin。

   kubectl create ns va-plugin

4. 创建一个名为va-plugin的ConfigMap对象，并将config.yaml文件的内容添加到ConfigMap中。

   cd /home/k8s/k8s/script
   kubectl create cm -n va-plugin va-plugin-configs --from-file=config=config.yaml

5. 修改道客设备插件镜像名称。

   vi va-device-plugin.yaml

   关注如下字段，并修改成实际值。

   spec.spec.containers.image：道客设备插件镜像，输入在工作节点导入的道客设备插件镜像名称。

6. 启动道客设备插件。

   cd /home/k8s/k8s/script
   kubectl create -f va-device-plugin.yaml

   执行kubectl delete -f va-device-plugin.yaml命令可删除道客设备插件。

7. 启动完成后，查看道客设备插件是否可运行成功。

   kubectl get pods -A

   期望是以va-device-plugin-daemonset开头的pod名称，其状态（STATUS）列都是Running状态。

2.2 启动设备插件

在master节点下启动设备插件。

1. 启动设备插件。

   cd /home/k8s/k8s/script
   ./start_devices.sh

   第一次执行./start_devices.sh命令后会出现一些报错，是因为脚本会先删除一遍设备插件的daemonSet。 删除设备插件可通过执行 ./delete_devices.sh 命令。

2. 启动完成后，查看设备插件是否运行成功。

   kubectl get pods -A

   期望是以k8s-host-device开头的pod名称，其状态（STATUS）列都是Running状态。

2.3 运行hook脚本

在所有工作节点运行hook脚本。

1. 请参见视频流引擎 安装指南获取DemoVideoEngine.tar.gz软件包，获取后将软件包上传至服务器的“/home/k8s”目录。

2. 将“/home/k8s/k8s/script”目录下的oci-device-hook.sh脚本拷贝到“/usr/local/sbin/”目录。

   cd /home/k8s/k8s/script
   cp oci-device-hook.sh /usr/local/sbin/

3. 更改Containerd配置，将部署道客设备插件镜像新增的容器运行时改成“/usr/local/sbin/oci-device-hook.sh”。

   sed -i 's|BinaryName = "/usr/bin/va-container-runtime"|BinaryName ="/usr/local/sbin/oci-device-hook.sh"|g' /etc/containerd/config.toml

4. 重启Containerd。

   systemctl restart containerd

2.4 运行nri插件

在所有工作节点运行nri插件。

1. 请参见视频流引擎 安装指南获取DemoVideoEngine.tar.gz软件包，获取后将软件包上传至服务器的“/home/k8s”目录。

2. 进入/home/k8s/k8s/scripts/nri-quota-plugin目录构建插件。

   go build -o quota-plugin main.go

3. 配置containerd并重启启用NRI。

   编辑 /etc/containerd/config.toml，将disable改为false。

   [plugins."io.containerd.nri.v1.nri"]
   disable = false
   plugin_config_path = "/etc/nri"
   plugin_socket_path = "/var/run/nri"

   重启containerd。

   systemctl restart containerd

4. 部署插件。

   mkdir -p /var/log/nri /var/run/nri
   cp quota-plugin /opt/nri-quota-plugin/
   chmod +x /opt/nri-quota-plugin/quota-plugin

5. 启动nri插件。

   cp quota-plugin.service /etc/systemd/system/quota-plugin.service
   systemctl daemon-reload
   systemctl enable quota-plugin
   systemctl start quota-plugin

2.5 启动K8s视频流云手机实例

启动K8s视频流云手机实例需要在工作节点下操作。

1. 修改k8s-video.yaml文件。

   cd /home/k8s/k8s/script
   vi k8s-video.yaml

   如下字段需关注，并修改成实际值。

   • spec.containers.image：视频流的镜像，输入在工作节点导入的视频流镜像名称。
   • spec.containers.resources.limits.cpu和spec.containers.resources.requests.cpu：容器需绑核数量，两者需同时修改。
   • spec.containers.resources.limits.memory和spec.containers.resources.requests.memory：容器的内存，两者需同时修改。

2. 启动k8s视频流云手机。

   注意：如果提前创建的数据卷格式为f2fs，那么需要配置f2fs开关为1；如果提前创建的数据卷格式为ext4，需要配置f2fs开关为0。

   ./k8s-video.sh start ${index1} ${index2} ${index3} ${index4} 

   若需要使用NFS挂载启动，则将start改成nstart。例：

   ./k8s-video.sh nstart ${index1} ${index2} ${index3} ${index4} 

   ${index1} 与 ${index2} 为pod编号，${index3}表示是否使能容器内文件为F2FS格式， 1表示使能，0表示不使能，默认是0；${index4}表示配置给容器内/system分区的大小值，单位为MB，输入大于0的数值则使能，输入0或无输入则不使能，该配置项默认是0。其中 ${index2} ${index3} ${index4}可缺省。 例：

   • 创建名为video2的pod。

   ./k8s-video.sh start 2

   • 创建名为video1~video5共5个pod。

   ./k8s-video.sh start 1 5

   • 创建名为video1~video5共5个pod，并且都使能f2fs文件格式，且容器内/system分区大小配额为10240M。

   ./k8s-video.sh start 1 5 1 10240

   • 创建名为video1~video5共5个pod，不使能f2fs文件格式，且容器内/system分区大小配额为10240M。

   ./k8s-video.sh start 1 5 0 10240

   • 创建名为video2的pod，不使能f2fs文件格式，且容器内/system分区大小配额为10240M。

   ./k8s-video.sh start 2 2 0 10240

3. 启动后，查看是否启动成功。

   kubectl get pods -o wide

   期望对应以video开头的pod名称其状态（STATUS）列都是Running。

   启动多路云手机时可能会因为Pod达到上限（默认Pod是110）而无法启动新的云手机，可以在工作节点编辑“/etc/sysconfig/kubelet”文件，“KUBELET_EXTRA_ARGS”中增加“--max-pods=300”后。使用systemctl restart kubelet重启kubelet，修改Pod上限为“300”，重启前不需要清理现有的容器。 可以通过如下命令观察输出的Capacity.pods的值是否为300，“$NODENAME”为工作节点名称。

   kubectl describe node $NODENAME

4. 连接视频流云手机及操作容器，通过NODE列可查看对应的视频流云手机pod调度对应的NODE节点。

   kubectl get pods -o wide

   请参见1.3-访问视频流云手机章节访问视频流云手机，其中客户端连接端口为8000+${index}，index为Pod编号。

   • 在master节点和工作节点上，可通过如下命令进入容器，以video1为例：

     kubectl exec -it video1 -- sh

   • 在工作节点可以通过crictl ps查看云手机实例，根据NAME字段可以查看对应的pod。通过如下命令可进入容器，其中“${CONTAINER}”是crictl ps返回的第一列。

     crictl exec -it ${CONTAINER} sh

2.6 删除K8s视频流云手机实例

删除K8s视频流云手机实例需要在工作节点下操作。

cd /home/k8s/k8s/script
./k8s-video.sh delete ${index1} ${index2}

./k8s-video.sh delete 2（删除名为video2的pod）
./k8s-video.sh delete 1 5（删除名为video1 -video5 共5个pod）

./k8s-video.sh ndelete 1 5（删除名为video1 -video5 共5个pod）

2.7 制作基础数据卷

通过本章节步骤制作基础数据卷，用于工作节点的容器存储隔离和大小设置。

1. 在工作节点使用k8s-video.sh脚本启动一路云手机，以video1为例。

   ./k8s-video.sh start 1

2. 在工作节点找到云手机video1所在节点。

   kubectl get pod -A -o wide

   在回显信息中找到NAME为video1的行，NODE列的值即为video1所在节点。

3. 将所需的应用（例地铁跑酷等）预装到该云手机容器中。

4. 登录云手机video1所在节点，基础数据卷所在位置为“/home/mount/img/video1.img”，将img文件重命名成videobase.img并拷贝至每个工作节点的“/home/mount/img”目录下，若需使用此videobase.img作为数据卷，请参见工作节点操作-1执行操作。

3 可配置项功能说明

3.1 视频流引擎商用部分

3.1.1 系统属性说明

视频流服务端引擎可通过系统属性配置视频，音频，网络等功能引擎参数，本章节对相关配置参数进行配置说明。

如表 1 视频流引擎商用部分配置属性字段描述表所示是商用模块的系统属性说明，开发者可以通过修改属性说明中的不同属性，配置视频流引擎商用模块的默认运行参数。

表 1 视频流引擎商用部分配置属性字段描述表

3.1.2 图形加速层配置项

当前图形加速层使能了GPUMock和ShaderCache两个可配置功能，本章节对两个可配置功能的配置项、配置规则进行说明，并且提供配置示例以供参考。

• GPUMock：对GPU厂商、GPU型号、OpenGL ES版本、GLMax能力值、OpenGL ES拓展进行模拟。
• ShaderCache：通过预构建着色器二进制、多云手机共享缓存，消除着色器编译链接等处理时间，降低OpenGL ES大型应用运行卡顿率。

可使用kbox_render_accelerating_configuration.xml配置文件进行相关功能配置。

配置项

表 1 kbox_render_accelerating_configuration.xml配置项说明

表 2 应用配置项中feature元素的name属性取值不同时配置说明

配置规则

• 为了方便进行全局配置，除了支持对具体应用进行独立配置外，也支持系统通用配置。系统通用配置的Application名固定为“system”，具体应用的配置可以覆盖系统通用配置；系统通用配置支持GPUMock，不支持ShaderCache进行配置。
• GPUMock是个基础功能，可供图形加速层其他功能使用，应用使能ShaderCache功能会自动使能GPUMock功能。

配置示例

<!-- 配置示例 -->
<!-- 系统通用配置 -->
<Application name="system" isEnable="false">
     <feature name="kbox.render.accelerating.gpuMock"  isEnable="false">
          <GL_RENDERER_MOCK>
               <param name="GL_RENDERER" value="Mali_G76"/>
               <param name="GL_VENDOR" value="Huawei"/>
               <param name="GL_VERSION" value="OpenGL ES 3.2 Mesa 22.1.7"/>
          </GL_RENDERER_MOCK>
     </feature>
</Application>
<!-- 具体应用配置 -->
<Application name="process_name" isEnable="false">
     <feature name="kbox.render.accelerating.shaderCache"  isEnable="false">
          <GL_SHADER_CACHE>
               <param name="SHADER_CACHE_MODE" value="0"/>
               <param name="SHADER_CACHE_DIR_SIZE" value="200"/>
          </GL_SHADER_CACHE>
     </feature>
     <feature name="kbox.render.accelerating.gpuMock"  isEnable="false">
          <GL_RENDERER_MOCK>
               <param name="GL_RENDERER" value="Mali_G76"/>
               <param name="GL_VENDOR" value="Huawei"/>
               <param name="GL_VERSION" value="OpenGL ES 3.2 Mesa 22.1.7"/>
          </GL_RENDERER_MOCK>
          <GL_EXTENSION_MOCK>
               <param name="GL_EXT_blend_minmax" value="1"/>
          </GL_EXTENSION_MOCK>
          <GL_MAX_VALUE_MOCK>
               <param name="GL_MAX_VERTEX_ATTRIBS" value="16"/>
          </GL_MAX_VALUE_MOCK>
     </feature>
</Application>

3.2 视频流引擎非商用部分

3.2.1 启动脚本配置项

视频流服务端引擎可通过启动脚本cfct_config文件中的配置项，配置硬件解码等功能，本章节提供视频流启动脚本cfct_config默认功能配置项说明。

视频流启动脚本cfct_config默认功能配置项如表 1 视频流引擎非商用部分脚本配置项字段描述表 所示。

请参见表 1 视频流引擎非商用部分脚本配置项字段描述表配置视频流引擎音视频等模块的默认运行参数。

表 1 视频流引擎非商用部分脚本配置项字段描述表

3.2.2 视频流引擎属性配置项

本章节提供非商用部分音视频等模块的系统属性说明，开发者可以通过default.prop文件修改属性说明中的不同属性，配置视频流引擎音视频等模块的默认运行参数。

非商用部分音视频等模块的系统属性说明如表 1 视频流引擎属性配置字段描述表所示。

表 1 视频流引擎属性配置字段描述表

3.2.3 容器内cpu频率动态调节

3.2.3.1 功能背景

在真机中，系统为了平衡负载和功耗，会动态调节 CPU 的运行频率，而云机依托于服务器宿主机的容器化环境运行，其底层物理 CPU 的频率通常处于恒定状态，与真机存在差异。下面步骤说明如何实现云手机cpu频率动态调节，提高仿真能力。

3.2.3.2 具体步骤

当前第三方检测应用一般通过读取scaling_cur_freq和cpuinfo_cur_freq这两个文件来获取当前设备的cpu运行频率，为了提高云机设备的仿真能力，这两个文件都要进行修改。

在修改前先确保相关路径有写入权限，在容器内输入如下命令查看相关路径的权限。

ls -ld /sys/devices/system/cpu/cpu${需要查询权限的cpu的编号}/cpufreq/scaling_cur_freq

ls -ld /sys/devices/system/cpu/cpu${需要查询权限的cpu的编号}/cpufreq/cpuinfo_cur_freq

如果包含 w（如 -rw-r--r--），说明文件的所有者（通常是 root）拥有写入权限。

如果没有 w（如 -r--r--r--），说明它是只读的，此时权限不足，无法直接写入。则输入如下命令新增权限。

在容器内输入如下命令给scaling_cur_freq添加写入（w）权限。

chmod u+w /sys/devices/system/cpu/cpu${需要新增权限的cpu的编号}/cpufreq/scaling_cur_freq

在容器内输入如下命令给cpuinfo_cur_freq添加写入（w）权限。

chmod u+w /sys/devices/system/cpu/cpu${需要新增权限的cpu的编号}/cpufreq/cpuinfo_cur_freq

随后在容器内输入如下命令读取cpu所支持的频率列表。

cat /sys/devices/system/cpu/cpu${准备进行频率修改的cpu的编号}/cpufreq/scaling_available_frequencies

随后在容器内输入如下两个命令进行修改，输入的频率值最好是刚刚查询到的当前cpu支持的频率值。

echo ${预期修改的值} > /sys/devices/system/cpu/cpu${准备进行频率修改的cpu的编号}/cpufreq/scaling_cur_freq

echo ${预期修改的值} > /sys/devices/system/cpu/cpu${准备进行频率修改的cpu的编号}/cpufreq/cpuinfo_cur_freq

如果容器重启，那么之前的修改值会失效，CPU频率值会恢复默认。

要实现cpu频率的动态调节，可以将如下shell命令直接复制粘贴到容器内任意路径中执行，即可在如“手机设备信息大全”这样的第三方应用中观察到cpu频率的动态变化，此处的“sleep 1”表示每隔1s变化一次，此处的“1”可以修改为其他时间值，FREQS数组里存放的是CPU频率的可能值，CPU_ID存放的是预期进行修改的CPU的编号，这三个值可以根据实际需求进行修改。

CPU_ID=0
FREQS=(554000 860000 956000 1042000 1128000 1224000 1320000 1397000 1512000 1628000 1748000 1858000 1954000)

while true; do
   for FREQ in "${FREQS[@]}"; do
      echo $FREQ > /sys/devices/system/cpu/cpu${CPU_ID}/cpufreq/scaling_cur_freq 2>/dev/null
      echo $FREQ > /sys/devices/system/cpu/cpu${CPU_ID}/cpufreq/cpuinfo_cur_freq 2>/dev/null
      echo "CPU${CPU_ID} 频率已动态调节为: $FREQ"
      sleep 1
   done
done

3.2.3.3 校验是否生效。

启动容器后，在容器内安装如“手机设备信息大全”的应用，查看cpu频率是否等于预期，若等于预期值即表示cpu频率调节生效。

4 故障处理

4.1 概述

4.1.1 故障处理原则

• 故障分析、定位和处理原则：

  • 以尽快恢复业务为原则。
  • 定位故障时，应及时采集故障数据信息，并尽量将采集到的故障数据信息保存在移动存储介质中或其他计算机中。
  • 在确定故障处理的方案时，应先评估影响，优先保证业务的正常运行。
  • 第三方的硬件故障，可查看第三方的相关资料或拨打第三方公司的服务电话。
  • 如果无法定位出故障点或无法按手册解决故障，及时联系技术支持，最大程度减少业务中断时间。

• 定位处理前注意事项：

  • 严格遵守操作规程和行业安全规程，确保人身安全与设备安全。
  • 应先分析故障现象，定位原因后再进行处理。在原因不明的情况下应避免盲目操作，导致问题扩大化。
  • 在处理故障前，需要保留好故障现场的任何记录，不能随意删除数据或日志。
  • 在处理故障时，为了确保客户网络的安全和隐私，如果需要采集相关故障日志，请事先得到客户的同意和授权。
  • 在进行任何修改前，应先通过脚本导出、手工备份等方式备份数据。
  • 更换和维护设备部件过程中，要做好防静电措施，佩戴防静电腕带。
  • 在维护过程中遇到的任何问题，应详细记录各种原始信息。
  • 所有的重大操作，如重启进程等操作，均应做记录，并在操作前仔细确认操作的可行性，在做好相应的备份、应急和安全措施后，方可由有资格的操作人员执行。
  • 在系统恢复后，必须对运行情况进行观察，确认故障已经排除并及时填写相关的处理报告。
  • 慎重使用高危操作及命令。

• 对维护人员的要求：

  • 具备网络设备、操作系统和数据库基础知识，掌握其常用的操作命令，并能熟练使用它们开展维护工作。
  • 熟知现场业务系统的逻辑结构、系统各部件和现场设备的对应关系以及现场设备之间的物理连接关系。
  • 熟悉业务流程、系统结构，能熟练操作业务相关的软硬件。
  • 了解基本故障相关定位和处理方法。
  • 掌握远程接入方式的使用。

4.1.2 故障处理流程

故障处理总体流程主要分为四个过程：故障信息收集、故障判断、故障定位、故障排除。

图 1 故障处理流程

故障信息收集

故障信息是故障处理的重要依据，系统维护人员应尽可能多的收集故障信息，例如AOSP中的logcat日志。

故障判断

排除故障之前，系统维护人员根据收集的故障详细信息，对故障范围和类型进行判断。

故障定位

故障定位是指从众多可能原因中找出故障原因的过程。通过一定的方法或手段分析、比较各种可能的故障成因，不断排除非可能因素，最终确定故障发生的具体原因。

以下是故障定位的常用方法：

• 查看客户端日志，关注告警信息
• 查看服务端日志，关注告警信息
• 查看操作系统日志，关注告警信息
• 查看资源使用情况，关注资源满载过载现象
• 查询操作日志，分析操作过程是否有误
• 查看配置文件，检查数据配置是否正确

故障排除

故障排除是指根据不同的故障原因清除故障的过程。故障排除包括检修设备、修改配置数据、重启相关进程、重启容器、重启服务器等。

4.2 信息收集

4.2.1 声明

在信息收集操作过程中，请严格遵守以下原则：

• 任何维护操作必须得到客户的授权，禁止进行超出客户审批范围的任何维护操作。
• 将问题定位数据传出客户网络必须得到客户的授权。

4.2.2 基本信息收集

收集局点信息

故障发生后，作为问题定位的首要条件，通过收集局点信息，让技术支持及研发人员快速了解现场的情况，同时，反馈现场工程师的联系电话，保证联络渠道的畅通。

需收集的局点信息如下表所示。

表 1 局点信息收集表

收集基本故障信息

通过基本故障信息，可初步了解现场发生的问题、目前的状态、产生故障前的设备状态和引起故障的可能因素。具体信息如下表所示。

表 2 基本故障信息收集表

收集故障相关告警信息

通过故障相关的告警信息，可进一步辅助故障的分析、定位和处理。具体信息如下表所示。

表 3 故障相关告警信息收集表

收集日志信息

收集系统的日志信息，可以通过日志，详细查看系统中用户的操作内容、操作时间等信息，从而进行故障的分析和定位。