如果使用MindCluster Volcano组件作为调度器，需要先安装MindCluster Volcano组件。

MindCluster HCCL Controller配合MindCluster Volcano、MindCluster Ascend Device Plugin（启动参数volcanoType设置为true）一起使用，按照训练任务章节下各训练框架“选择yaml示例”章节中获取的训练任务yaml模板下发NPU训练任务时，会默认生成格式为“模板一”的昇腾AI处理器资源配置文件（即Rank table文件）。模板格式详见《CANN TensorFlow 1.15网络模型迁移和训练指南》中“模型训练 > 执行分布式训练 > 训练执行（配置文件方式设置资源信息） > 准备ranktable资源配置文件”章节的“准备配置文件”的模版一。

操作步骤

以root用户登录K8s管理节点，并执行以下命令，查看MindCluster HCCL Controller镜像和版本号是否正确。
```
docker images | grep hccl-controller
```
回显示例如下：
```
hccl-controller                      v5.0.0.2              f78993dcf54f        About an hour ago         143MB
```
- 是，执行步骤2。
- 否，请参见准备镜像，完成镜像制作和分发。
将MindCluster HCCL Controller软件包解压目录（以“/home/ascend-hccl-controller”为例）下的yaml文件拷贝到K8s管理节点上任意目录（以“/home/ascend-hccl-controller”为例）。如果MindCluster HCCL Controller软件包在K8s管理节点上解压，可以不用进行拷贝操作。
```
cd /home/ascend-hccl-controller
scp root@{软件包解压节点IP地址}:/home/ascend-hccl-controller/hccl-controller-v{version}.yaml ./
```
如不修改组件启动参数，可跳过本步骤。否则，请根据实际情况修改对应启动yaml文件中MindCluster HCCL Controller的启动参数。启动参数请参见表1，可执行./hccl-controller -h查看参数说明。

在管理节点的yaml所在路径，执行以下命令，启动MindCluster HCCL Controller。

kubectl apply -f hccl-controller-v{version}.yaml

启动示例如下：

root@ubuntu:/home/ascend-hccl-controller# kubectl apply -f hccl-controller-v5.0.0.2.yaml 
serviceaccount/hccl-controller created
clusterrole.rbac.authorization.k8s.io/pods-hccl-controller-role created
clusterrolebinding.rbac.authorization.k8s.io/hccl-controller-rolebinding created
deployment.apps/hccl-controller created

执行kubectl get pod -n mindx-dl命令，出现Running表示组件启动成功。

NAME                               READY   STATUS    RESTARTS   AGE
...
hccl-controller-5d484dcc68-wfvrr   1/1    Running   0          11s
...

安装组件后，组件的Pod状态不为Running，可参考组件Pod状态不为Running章节信息。
安装组件后，组件的Pod状态为ContainerCreating，可参考集群调度组件Pod处于ContainerCreating状态章节信息。
启动组件失败，可参考启动集群调度组件失败，日志打印“get sem errno =13”章节信息。
组件启动成功，找不到组件对应的Pod，可参考组件启动yaml执行成功，找不到组件对应的Pod章节信息。

参数说明

表1 MindCluster HCCL Controller启动参数
参数	类型	默认值	说明
-jobParallelism	int	1	job任务的并发数，范围为[1，32]。
-podParallelism	int	1	Pod任务的并发数，范围为[1，32]。
-version	bool	false	MindCluster HCCL Controller二进制版本号。
-json	string	v2	MindCluster HCCL Controller生成的ranktable文件模板。 v1：表示模板二。 v2：表示模板一。
-logLevel	int	0	日志级别： -1：debug 0：info 1：warning 2：error 3：critical
-maxAge	int	7	日志备份时间限制，范围为[7，700]，单位为天。
-logFile	string	/var/log/mindx-dl/hccl-controller/hccl-controller.log	日志文件。说明：单个日志文件超过20 MB时会触发自动转储功能，文件大小上限不支持修改。转储后文件的命名格式为：hccl-controller-触发转储的时间.log，如：hccl-controller-2023-10-07T03-38-24.402.log。
-maxBackups	int	30	转储后日志文件保留个数上限，范围为(0，30]，单位为个。
-h或者-help	无	不涉及	显示帮助信息。

HCCL-Controller

操作步骤

参数说明