昇腾社区首页
中文
注册
开发者
下载

Initialize

产品支持情况

产品

是否支持

Atlas A3 训练系列产品/Atlas A3 推理系列产品

Atlas 800I A2 推理产品/A200I A2 Box 异构组件

Atlas A2 训练系列产品

x

Atlas 200I/500 A2 推理产品

x

Atlas 推理系列产品

x

Atlas 训练系列产品

x

函数功能

初始化LLM-DataDist。

函数原型

1
Status Initialize(const std::map<AscendString, AscendString> &options)

参数说明

参数名

输入/输出

描述

options

输入

初始化参数值。具体请参考表1

表1 options

参数名

可选/必选

描述

OPTION_LISTEN_IP_INFO

可选

配置当前option表示LLM-DataDist是Server,不配置表示Client。

当LLM-DataDist是Server时,需配置Host侧的IP地址和端口。

配置示例:如"192.168.1.1:26000",不支持传入多个IP地址和端口。

OPTION_DEVICE_ID

必选

设置当前进程的Device ID,如"0",不支持单进程多卡场景。

OPTION_SYNC_CACHE_WAIT_TIME

可选

kv相关操作的超时时间,单位:ms。不配置默认为1000ms。相关接口如下。

OPTION_LOCAL_COMM_RES

可选

配置本地通信资源信息,格式是json格式的字符串。仅需配置ranktable中当前llm datadist所使用Device信息,无需配置ranktable中的server_count和rank_id字段,ranktable具体信息请参见HCCL集合通信库用户指南中的“通信功能开发 > 集群信息配置 > rank table文件配置资源信息“章节。

说明:

该option可以不配置或配置为空串,为空将自动生成相关信息。

调用示例

请参考decoder_sample2

返回值

  • LLM_SUCCESS:成功
  • LLM_PARAM_INVALID:参数错误
  • 其他:失败

异常处理

约束说明

需要和Finalize配对使用,初始化成功后,任何退出前都需要调用Finalize保证资源释放,否则会出现资源释放顺序不符合预期而导致问题。