启动与卸载云手机实例
启动云手机实例路径下应存在kbox_config.cfg配置文件。容器会使用该文件中的配置,因此使用时应确保kbox_config.cfg配置文件中的配置正确。若启动路径下无该配置文件,则云手机将禁止启动。
kbox_config.cfg配置文件中有KBOX_GPU_MAP、KBOX_MOUNT_MAP、KBOX_CPUSET_MAP等配置项,可以修改map中对应路数的值来选择该路容器使用的GPU、CPU以及数据卷存放路径。使用kbox_config.cfg配置文件可以灵活配置云手机使用的资源,使性能达到最优。
- 解压Kbox-AOSP11.zip,将Kbox-AOSP11文件夹中的deploy_scripts目录上传至服务器的“~/dependency”目录。
- (可选)使能硬件解码(以下简称“硬解”)时,需要设置“deploy_scripts”目录下的kbox_config.cfg文件,将“ENABLE_HARD_DECODE”设置为“1”,同时需参考以下步骤设置NETINT卡节点。
- 执行如下命令查看编解码卡芯片对应节点号。
1
nvme list
回显示例如下,请以实际为准。加粗部分为NETINT编码卡Quadra芯片NVMe节点,一张编码卡包含2颗芯片。
1 2 3 4
Node SN Model Namespace Usage Format FW Rev ------------- -------------------- ---------------- --------- ------------------------ ---------------- -------- /dev/nvme0n1 Q2A325A11DC082-0454A QuadraT2A 1 8.59 TB / 8.59 TB 4 KiB + 0 B 4866rKr1 /dev/nvme1n1 Q2A325A11DC082-0454B QuadraT2A 1 8.59 TB / 8.59 TB 4 KiB + 0 B 4866rKr1
- 查看nvme节点与pcie bus号对应关系。
回显如下,其中0000:05:00.0为该设备对应的busID:
1 2
/sys/devices/pci0000:00/0000:00:0e.0/0000:05:00.0/nvme/nvme1 /sys/devices/virtual/nvme-subsystem/nvme-subsys1/nvme1
- 通过bus号找到该节点与NUMA从属关系。
回显如下。
1
NUMA node: 0
- 根据编码卡NVMe设备节点对应的NUMA修改kbox_config.cfg中NETINT的值。
鲲鹏920 7260服务器:从属于0、1号NUMA的NVMe节点写在NETINT0字段中,从属于2、3号NUMA的NVMe节点写在NETINT1字段中。
字段中每个设备需添加两个节点。例如2号NVMe设备,需添加“/dev/nvme2”、“/dev/nvme2n1”两个节点。
# NETINT编码卡设备节点 NETINT0="/dev/nvme0,/dev/nvme0n1,/dev/nvme1,/dev/nvme1n1" NETINT1="/dev/nvme2,/dev/nvme2n1,/dev/nvme3,/dev/nvme3n1"
- 若第一次启动容器时NETINT的值为空,禁止设置ENABLE_HARD_DECODE=1,且禁止重启时设置ENABLE_HARD_DECODE=1,否则播放视频会有短暂黑屏的现象。
- 若使能NETINT编码卡硬解,需要在kbox_config.cfg中设置ENABLE_HARD_DECODE=1。
- 针对一张Quadra T2A编码卡环境,请参考如下配置,请根据实际情况配置设备节点信息。
# NETINT编码卡设备节点 NETINT0="/dev/nvme0,/dev/nvme0n1,/dev/nvme1,/dev/nvme1n1" NETINT1="/dev/nvme0,/dev/nvme0n1,/dev/nvme1,/dev/nvme1n1"
- 执行如下命令查看编解码卡芯片对应节点号。
- 通过android11_kbox.sh脚本启动容器。
1 2 3
cd ~/dependency/deploy_scripts chmod +x android11_kbox.sh ./android11_kbox.sh start {镜像名称:tag} ${index1} ${index2}
Kbox基础云手机的默认配置信息如表1所示。
启动脚本使用示例:
- 启动一个编号为1的实例。
1
./android11_kbox.sh start kbox:latest 1
- 启动编号为1~5的五个实例。
1
./android11_kbox.sh start kbox:latest 1 5
- 启动一个编号为1的实例。
- 执行命令,确认Kbox容器是否启动成功,其中“${index}”为启动实例的编号。
1 2
docker exec -it kbox_${index} sh getprop | grep boot
若回显信息中的sys.boot_completed显示为“1”,则启动成功。
- 停止并删除Kbox容器的方法。
由于Kbox方案默认挂载数据卷,默认的docker stop、docker rm命令不能彻底清理容器数据,需要使用脚本彻底清理主机侧文件。
使用android11_kbox.sh脚本,停止并删除正在运行的Kbox容器。
- 停止并删除编号为${index}的容器。
1
./android11_kbox.sh delete ${index}
- 停止并删除编号为${index1}~${index2}的所有容器。
1
./android11_kbox.sh delete ${index1} ${index2}
- 停止并删除编号为${index}的容器。
- 重启Kbox容器的方法。
由于Kbox方案默认挂载数据卷,在重启容器时,无法使用默认的docker restart命令进行重启,需要使用脚本执行容器的重启操作。
使用android11_kbox.sh脚本重启Kbox容器。
- 重启编号为${index}的容器。
1
./android11_kbox.sh restart ${index}
- 重启编号为${index1}~${index2}的所有容器。
1
./android11_kbox.sh restart ${index1} ${index2}
- 重启编号为${index}的容器。