本文介绍如何在科研助手启动开发机。 前提条件 开发机实例状态必须为“停止”才可以启动。 操作步骤 1. 登录科研助手管理控制台。 2. 在控制台左侧导航栏中，选择【开发机】。 3. 在开发机列表中定位到想要启动的开发机，点击【启动】。启动开发机确认界面如下图所示 4. 启动开发机参数如下： 参数 说明 自动停止 自动停止开关，如果开启开关，开发机将在设定的时间后自动停止；如果关闭开关，开发机由用户手动停止。 自动停止时长 设置自动停止时长，单位小时。可用条件是开启自动停止开关。时长可选择1小时，2小时，4小时，6小时，自定义时长，自定义时长数值应该为大于0的整数。 5. 设置好自动停止及自动停止时长后，点【确认】，启动开发机。启动之后开发机的状态由“停止”变成“运行中”，用户可以打开开发机实例。

本文介绍如何在科研助手中保存自定义镜像。 前提条件 开发机实例状态必须为“运行中”才可以进行保存自定义镜像操作。 操作步骤 1. 登录科研助手管理控制台。 2. 在控制台左侧导航栏中，选择【开发机】。 3. 在开发机列表中定位到想要保存为镜像的开发机实例，点击右侧操作栏【保存镜像 】，进入【保存镜像弹窗】。 4. 在保存镜像对话框中，设置组织、镜像名称和镜像版本信息。单击【确认 】保存镜像，点击【取消】，放弃保存镜像。 在“组织”下拉框中选择一个组织。如果没有组织，可以单击右侧的“创建组织”（可免费创建3个组织，每个组织有10GB容量）。同一个组织内的用户可以共享使用该组织内的所有镜像，首次登录容器镜像服务控制台需先设置访问凭证。 5. 镜像保存过程约510分钟，开发机实例状态将变为【快照中】，请耐心等待。此时实例将无法操作。 6. 镜像保存成功后，开发机实例状态变为“运行中”，用户可在容器镜像服务（CRS）查看到该镜像详情。 7. 再次创建开发机，在框架版本的弹窗中选择“自定义镜像”，即可找到保存的镜像。

本文介绍了如何在科研助手中创建并行计算任务。 操作步骤 1. 登录科研助手管理控制台。 2. 在控制台左侧导航栏中，选择【并行计算】。 3. 在【并行计算】页面中，单击【作业管理】下方的【创建计算任务】。 4. 在【创建计算任务】页面中，配置参数，具体如下表所示。 参数 说明 企业项目 可将计算任务挂载在不同企业项目下。 作业名称 输入作业名称。要求如下：长度范围为4~25个字符。名称由小写字母、数字、中划线（）组成。以小写字母开头。 以小写字母或数字结尾。 并行框架 选择所需要使用的并行框架。支持MPI、Pytorch、Tensorflow、Paddle。 镜像地址 输入作业所需要使用的镜像URL地址，可以手动填写第三方镜像，也可以选择存储在天翼云的镜像。 启动命令 作业第一个实例启动时执行的命令内容，指令执行完成视为作业运行结束。例如"mpirun np 8 myapp.run"。 环境变量 为所有实例预置环境变量，输入形式为key+value。 可用区 选择所需的可用区。 实例规格 实例规格可选择通用计算型和GPU加速型，为作业的实例选择合适的实例规格。 数量 作业将创建的实例数量。输入范围1~99。 存储挂载 可将科研文件挂载到所有实例中，可设置实例中挂载的路径。 5. 所有参数填写完毕后，点击【确认订单】，作业将会创建和下发计算任务。

本文介绍了如何查看科研助手的并行计算作业。 操作步骤 1. 登录科研助手管理控制台。 2. 在控制台左侧导航栏中，选择【并行计算】。 3. 在【并行计算】列表中，点击对应并行计算名称即可进入详情页。 4. 进入【作业详情】页面，可在当前页面中查看作业的基础信息、详情信息、实例详情等，也可以操作作业的启动、停止、删除。 5. 点击【展开全部】可查看作业详情信息。 6. 在【实例详情】中，我们可以选择具体的实例，查看对应实例的日志内容。 7. 点击【实例终端】，可以在实例运行中时，进入到对应实例的Linux终端命令行中。如实例不在运行状态中，则无法连接。 8. 点击【运行】监控，可以查看资源的利用率情况： 9. 点击【实例事件】，可以查看实例运行过程中的相关事件。

本文介绍如何在科研助手中在在开发机中引用数据集。 操作步骤 1. 登录科研助手管理控制台。 2. 在控制台左侧导航栏中，选择【开发机】。 3. 在【开发机 】页面中，点击左上角【创建开发机】 4. 在【创建开发机 】页面，【数据集 】中，点击【添加】按钮。 5. 此时在下拉条中，可以选择之前已经创建好的数据集，若还未创建数据集，可单击【创建数据集】按钮。 6. 在选择完挂载数据集之后，用户可自定义填入例如“/tmp”类似的容器挂载路径。 7. 若不需要挂载数据集，也可点击右方删除操作，取消挂载数据集。

安装外部依赖包 可在Untitled.ipynb文件内用在pip安装命令前增加“！“符号： 或者可以开启系统终端，在命令行中输入pip安装命令：

本文介绍如何在科研助手中变更开发机规格。 前提条件 开发机实例状态必须为“停止”才可以变更规格。 操作步骤 1. 登录科研助手管理控制台。 2. 在控制台左侧导航栏中，选择【开发机】。 3. 在开发机列表中定位到想要变更规格的开发机，点击【变更规格】。 4. 在变更规格弹窗重选择目标规格，点击【确认 】完成规格变更，点击【取消】，放弃规格变更。 5. 变更规格将改变计算资源规格，具有以下参数： 参数 说明 类型 计算资源类型。可选： · GPU加速型。使用GPU加速。 · 通用计算型。仅使用CPU。 规格 计算资源规格。 · 通用计算型。包括CPU（核），内存(GB)。 · GPU加速型。包括CPU（核），内存(GB)，显卡数量（块）

本文介绍科研助手提供百度网盘进行数据给本地盘供训练使用。 概述 科研助手支持从百度网盘同步数据，供本地盘训练使用。 操作步骤 1.登录科研助手管理控制台。 2.在控制台左侧导航栏中，选择【数据存储】选项的【数据集管理】。 3.选中具体的数据集文件，进入【文件管理】，点击【网盘同步】。 4.点击【更新授权】，点击【获取授权码】。 进入百度账号页面，登陆后复制授权码，填写至【更新授权】中，确认无误点击【授权】。 5.授权完成后，点击【浏览文件】，可浏览查看网盘的相关文件集数据信息。 7.勾选数据并点击【确认】，进行下载给本地盘。 8.等待数据同步完成，即可完成百度网盘数据同步。

本文介绍使用Rediscli迁移自建Redis(AOF文件) 迁移介绍 Rediscli 是 Redis 自带的命令行客户端工具，它允许用户通过命令行与 Redis 服务器进行交互。 在本章节中，我们将重点介绍如何使用 Rediscli 工具以 AOF 文件的方式，将自建的 Redis 数据迁移到 DCS 缓存实例。 说明 进行迁移操作前，建议暂停相关业务，以避免数据丢失或不完整。 建议业务空闲时间进行迁移操作。 步骤1：生成AOF文件 使用以下命令来开启缓存持久化并生成 AOF 持久化文件： ./rediscli h {redisaddress} p {redisport} a {password} config set appendonly yes 如果 AOF 文件的大小不再变化，说明AOF文件为全量缓存数据。 说明 使用 Rediscli 工具登录 Redis 实例，输入命令“config get dir”可以查找生成的AOF文件保存路径。 如果没有进行特殊指定，该文件的文件名默认为 appendonly.aof。 如果需要关闭同步，可以使用 Rediscli 工具登录 Redis 实例，并输入命令 “config set appendonly no” 来关闭同步。 步骤2：上传AOF文件至天翼云ECS 为节省传输时间，请先压缩AOF文件再传输。 将压缩文件（如以SFTP/SCP等方式）上传到天翼云ECS。 说明 ECS需保证有足够的磁盘空间，供数据文件存储，同时需要与缓存实例网络互通，通常要求相同VPC和相同子网，且安全组规则不限制访问端口。 步骤3：导入数据 ./rediscli h {redisaddress} p {redisport} a {password} pipe < appendonly.aof 步骤4：迁移后验证 数据导入成功后，连接DCS缓存实例，通过dbsize命令，确认数据是否导入成功 如果导入不成功，需要分析原因，修正导入语句，然后使用flushall或者flushdb命令清理实例中的缓存数据，并重新导入。

本节主要介绍移除服务器。 在“服务器管理”页面，选择要移除的服务，点击“操作”>“移除”，移除服务器。 注意 如果移除已损毁或者宕机的服务器，需要使用强制移除。强制移除服务器，会产生数据丢失风险，请谨慎操作。 如果移除服务器上有iSCSI目标，该iSCSI目标对应卷的高可用类型是ActiveStandby，移除服务器时，业务不会中断，此卷对应的iSCSI目标会切换到其他服务器上，客户端需要重新连接Target对应的新服务器IP。 如果移除服务器上有iSCSI目标，该iSCSI目标对应卷的高可用类型是Disabled，移除服务器时，业务会中断，此卷对应的iSCSI目标会切换到其他服务器上，客户端需要重新连接Target对应的新服务器IP。但服务器移除时，会有数据丢失风险。 如果执行日志采集后，产生的日志保存在服务器安装目录下，在服务器移除之后，该日志将被删除。如果产生的日志保存在HBlock的数据目录内，并且移除服务器时删除服务器HBlock数据目录中的数据，该日志也将被删除。 有服务器正在移除时，不能再移除其他服务器。如果必须移除，请使用强制移除，但有丢数据风险。 该节点的所有数据目录不属于任何存储池，允许移除该服务器。否则不能移除，如果必须移除，请使用强制移除，但有丢数据风险。 如果要移除服务器的某个数据目录属于基础存储池，且是基础存储池中仅剩的一个可用故障域中的节点，不允许移除。 如果服务器上有基础服务，不允许移除。 图1 移除服务器

本节主要介绍存储池监控信息。 在“监控”页面点击“存储池”，可以查看对应存储池的实时监控信息：数据目录（总量/已用/使用率）、容量配额（总量/已用/使用率）、带宽（总/读/写）。 说明 可以根据存储池名称，选择查看对应存储池的实时监控信息。 图1 存储池实时监控信息 项目 描述 存储池名称 存储池名称。 数据目录（总量/已用/使用率） 存储池中所有数据目录所在磁盘的总容量、已用容量、使用率的平均值。 容量配额（总量/已用/使用率） 存储池中所有数据目录的HBlock容量配额总量、已用容量配额、容量配额使用率的平均值。 带宽（总/读/写） 客户端与服务器之间的总带宽、读带宽、写带宽。 在“监控”>“存储池”页面，点击对应存储池名称，可以查看存储池内HBlock指定时间内的监控信息：数据目录使用率、容量配额使用率、数据目录使用量、数据目录总容量、配额使用量、配额、读带宽、写带宽、总带宽、读IOPS、写IOPS、总IOPS、读时延、写时延、总时延。 图1 存储监控信息 项目 描述 存储池名称 存储池名称，可以通过下拉框选择存储池。 时间范围 可以选择相对时间： 近2小时 近6小时 近1天 近7天 近1年 自定义时间段，选择开始日期和结束日期，精确到天。 注意 起始时间必须早于结束时间，且起始时间不能早于服务器当前时间一年。 数据目录使用率 存储池中所有数据目录所在磁盘使用率的平均值。 容量配额使用率 存储池中HBlock所有数据目录容量配额使用率的平均值。 数据目录使用量 存储池中所有数据目录所在磁盘使用量的总和。 数据目录总容量 存储池中所有数据目录所在磁盘容量的总和。 配额使用量 存储池中HBlock已使用容量配额。 配额 存储池中HBlock容量配额总和。 客户端 HBlock 当前存储池中，客户端与HBlock之间的数据传输情况。 读带宽 客户端从HBlock存储池读取数据的带宽。 写带宽 客户端向HBlock存储池写入数据的带宽。 总带宽 客户端与HBlock存储池之间的总带宽。 读IOPS 客户端从HBlock存储池读取数据的IOPS。 写IOPS 客户端向HBlock存储池写入数据的IOPS。 总IOPS 客户端与HBlock存储池之间的总IOPS。 读时延 客户端从HBlock存储池读取数据的时延。采集周期内，服务器关联卷的读时延平均值。 写时延 客户端向HBlock存储池写入数据的时延。采集周期内，服务器关联卷的写时延平均值。 总时延 客户端与HBlock存储池之间的总时延。采集周期内，服务器关联卷的读写时延平均值。

本节主要介绍变更服务器的父节点。 在“服务器管理”页面，选择需要修改父节点的服务器，点击“操作”>“重映射”，变更服务器的父节点。 图1 变更父节点 项目 描述 父节点名称 在下拉框中选择父节点。

本节主要介绍卷的主备切换。 在“卷管理”页面，选择需要主备切换的卷，点击“操作”>“主备切换”，可以触发卷对应的iSCSI目标主备切换。 说明 执行此操作后，客户端不需要进行任何操作。 图1 触发卷的主备切换

参数 描述 n LUNNAME 或 name LUNNAME 指定卷名称。可以指定一个或者多个卷，以英文逗号分开。 说明 如果不指定卷名称，表示设置所有卷。 priority SERVERID &<1n> 指定卷主备分布优先级的服务器ID，系统会根据指定的服务器ID顺序来选择卷的主备IQN。可以指定一个或者多个服务器ID，以英文逗号分开。 例如 ：lun1对应target1，其IQN分布在hblock1、hblock2和hblock4上。指定lun1卷主备分布优先级的服务器ID，如 priority hblock1,hblock3,hblock4 ，表示优先使用hblock1对应的 target1 IQN作为lun1的主IQN，hblock3对应的target1 IQN作为备用IQN。若hblock1故障，系统将自动切换至hblock3对应的target1 IQN作为主IQN，hblock4对应的target1 IQN作为备IQN。当hblock1故障恢复： 如果 autofailback 设置为Enabled，系统将自动恢复为设定的优先级顺序，Active target IQN、Standby target IQN、Cold target IQN切换至hblock1、hblock3、hblock4。 如果autofailback 的设置为Disabled，系统保持当前状态不变；如果恢复为设定的优先级顺序，可以执行命令 ./stor lun Sn LUNNAME 命令手动切换。 注意 如果指定卷主备分布优先级的服务器ID，必须且只能指定一个卷名称。 priority RANDOM 系统随机选择卷的主备IQN。即当卷对应target IQN所在的服务器故障后，系统随机切换卷的主备IQN。 priority CUSTOM 根据卷的当前主备target IQN（Active target IQN、Standby target IQN、Cold target IQN）所在服务器，进行优先级设置。设置完成后，根据autofailback来确定是否需要自动调整。 例如 ：lun1对应target1，其Active target、Standby target、Cold target分别对应hblock1、hblock2和hblock4上。若hblock1故障，系统将自动切换至hblock2对应的target1 IQN作为主IQN，hblock4对应的target1 IQN作为备IQN。当hblock1故障恢复： 如果 autofailback 设置为Enabled，系统将自动恢复为设定的优先级顺序，Active target IQN、Standby target IQN、Cold target IQN切换为hblock1、hblock2和hblock4。 如果 autofailback 的设置为Disabled，系统保持当前状态不变；如果恢复为设定的优先级顺序，可以执行命令 ./stor lun Sn LUNNAME 命令手动切换。 autofailback AUTOFAILBACK 是否根据指定的卷主备分布优先级自动进行主备切换，即针对卷主备状态，当高优先级的服务器恢复正常后，是否自动进行主备状态切换。 取值： Enabled：自动进行主备切换。 Disabled：不自动进行主备切换。

./stor storagepool ls n pool2 Storage Pool Name: default Pool Status: Normal Fault Domain: path Base Pool: true Total Capacity: 278.57 GiB Used Capacity: 23.98 GiB Created Time: 20260112 17:34:40 LUN: LUN for CachePool: lun05a LUN for Pool: lun02,lun02a,lun03a,lun01a,lun01b,lun01aC1 status: 7 total, 1.33 TiB (cache mode:1 total, 210 GiB; storage mode:1 total, 310 GiB; local mode:5 total, 841 GiB) Data Health: 100% normal, 0% low redundancy, 0% error Topology: Node Name: default:room1:rack1:hblock2:/mnt/stor01 Node Type: path Status: Healthy Disk Path(s): ++++++++ No. Path Used Capacity Total Capacity Used Capacity Quota Capacity Quota Health Status Health Detail ++++++++ 1. default:room1:rack1:hblock2:/mnt/stor01 8.4 GiB 92.86 GiB 1000.26 MiB 90 GiB Healthy ++++++++ Node Name: default:room1:hblock3:/mnt/stor01 Node Type: path Status: Healthy Disk Path(s): ++++++++ No. Path Used Capacity Total Capacity Used Capacity Quota Capacity Quota Health Status Health Detail ++++++++ 1. default:room1:hblock3:/mnt/stor01 7.82 GiB 92.86 GiB 984.27 MiB 90 GiB Healthy ++++++++ Node Name: default:hblock1:/mnt/stor02 Node Type: path Status: Healthy Disk Path(s): ++++++++ No. Path Used Capacity Total Capacity Used Capacity Quota Capacity Quota Health Status Health Detail ++++++++ 1. default:hblock1:/mnt/stor02 7.76 GiB 92.86 GiB 1004.29 MiB 90 GiB Healthy ++++++++ 查询指定存储池信息的描述 项目 描述 Storage Pool Name 存储池名称。 Pool Status 存储池状态： Normal：正常。 Deleting：删除中。 Fault Domain 存储池故障域级别： path：数据目录级别。 server：服务器级别。 rack：机架级别。 room：机房级别。 Base Pool 是否是基础存储池： true：是基础存储池。 false：不是基础存储池。 Total Capacity 存储池总容量。 Used Capacity 存储池已用容量。 Created Time 存储池创建时间。 Description 存储池描述信息。 LUN 卷相关信息，包含LUN for CachePool、LUN for Pool、status。 LUN LUN for CachePool 缓存存储池卷列表。 LUN LUN for Pool 存储池卷列表。 LUN status 卷的状态信息，包括卷的总数、总容量，以及各类型卷的个数及容量。 Data Health 存储池的数据健康度，包括：正常数据的比例（normal）、降级数据的比例（low redundancy）、错误数据的比例（error）。如果存在降级状态的数据，会给出数据重建进度（low redundancy reconstruction progress）。 Topology 存储池拓扑图，包括：Node Name、Node Type、Status、Disk Path(s)、Removing Details。 Topology Node Name 节点名称。 Topology Node Type 节点类型： path：数据目录。 server：服务器。 rack：机架。 room：机房。 Topology Status 节点健康状态： Healthy：节点处于健康状态，可正常读写。 Warning：节点处于警告状态，可读。 Error：节点处于错误状态，无法访问。 Topology Disk Path(s) 数据目录信息： No.：编号。 Path：数据目录。 Used Capacity：HBlock数据目录对应分区的已用容量。 Total Capacity：HBlock数据目录对应分区的总容量。 Used Capacity Quota：已用数据目录容量配额。 Capacity Quota：数据目录容量配额，当HBlock的使用空间一旦达到配额，就立刻阻止数据写入，不允许再使用超出配额的空间。 Health Status：数据目录的健康状态： Healthy：数据目录处于健康状态，可正常读写，且数据目录所在磁盘使用率未超过阈值（系统默认值为95%）。 Warning：数据目录处于警告状态，可读，但存在以下情况的任意一种：慢盘；数据目录所在磁盘使用率超过阈值（系统默认值为95%）；磁盘剩余空间不足1GiB；HBlock对这个目录停写；数据目录配额使用率超过阈值（系统默认值为95%）；数据目录配额为0。 Error：数据目录错误状态，无法访问，原因可能是：所在磁盘出现I/O错误导致无法读写，数据目录未正确挂载等。 Health Detail：数据目录健康状态详情。 如果健康状态为Healthy，此列为空。 如果健康状态为Warning或Error，显示警告或错误的详细信息。 Topology Removing Details 被移除节点的详细信息： No.：编号。 Path：节点的具体数据目录。 Stage：移除节点所处的阶段： Reconfiguration：重置中。 CheckingData：检查数据。 Executing：执行移除节点。 Details：详细数据： FaultDomains：故障域详情，包括：healthy（健康个数），warning（告警个数），error（错误个数）。 Data：safe（安全数据百分比），await reconstruction（需要重建的数据百分比），await more faultdomains（需要额外故障域才能够重建的数据百分比），singlecopy（单副本数据百分比），corrupted（已经损坏的数据百分比）。

本节主要介绍集群拓扑。 点击导航栏中的“系统”>“集群拓扑”，进入“集群拓扑”，可以查看HBlock的集群拓扑图。 集群拓扑对集群物理资源实际部署方式的可视化逻辑展示。 图1 集群拓扑 名称 描述 根节点 根节点名称默认为default。点击右键，可以选择“添加子节点”或“编辑”节点。 根节点 添加子节点 父节点类型。 根节点 添加子节点 父节点名称。 根节点 添加子节点 子节点类型，可以选择： room：机房。选择room时，可以编辑下列信息： 子节点名称：字符串形式，长度范围1~63，只能由字母、数字、句点(.)、下划线（）和短横线()组成，字母区分大小写，且仅支持以字母或数字开头。 描述：节点描述，取值：1~50位字符串。 rack：机架。选择rack时，可以编辑下列信息： 子节点名称：字符串形式，长度范围1~63，只能由字母、数字、句点(.)、下划线（）和短横线()组成，字母区分大小写，且仅支持以字母或数字开头。 描述：节点描述，取值：1~50位字符串。 server：服务器。选择server，添加服务器。添加服务器时，待添加的服务器安装HBlock后，才可以编辑下列信息： 子节点名称：字符串形式，长度范围1~63，只能由字母、数字、句点(.)、下划线（）和短横线()组成，字母区分大小写，且仅支持以字母或数字开头。 服务器IP：指定需要添加的服务器IP，支持IPv4和IPv6地址。 端口号：指定API端口号。取值范围是[1, 65535]，默认值是1443。需要和该服务器安装HBlock时设置的API端口号保持一致。 数据目录：包括数据目录、容量配额、操作。 数据目录：服务器中，用于存储用户数据的绝对路径。 容量配额：一旦达到配额，就立刻阻止数据写入。支持输入数字（默认单位为GiB），或者输入“数字+单位”，数字应精确到两位小数，单位可为KiB、MiB、GiB、TiB或者PiB，并且配额需要不大于数据目录总容量，0表示禁止写入，负数或者不填表示无限制。 操作：点击“移除”，可以移除添加的数据目录。点击“添加”，可以添加数据目录。 描述：节点描述，取值：1~50位字符串。 根节点 编辑 节点名称：修改节点名称。取值：字符串形式，长度范围1~63，只能由字母、数字、句点(.)、下划线（）和短横线()组成，字母区分大小写，且仅支持以字母或数字开头。 根节点 编辑 描述：节点描述，取值：1~50位字符串。 room类型节点 机房类型的节点。将鼠标放至节点名称处，可以显示节点名称、类型及描述信息。点击右键，可以选择添加子节点、移除或编辑节点。 room类型节点 添加子节点 父节点类型。 room类型节点 添加子节点 父节点名称。 room类型节点 添加子节点 子节点类型，可以选择： rack：机架。选择rack时，可以编辑下列信息： 子节点名称：字符串形式，长度范围1~63，只能由字母、数字、句点(.)、下划线（）和短横线()组成，字母区分大小写，且仅支持以字母或数字开头。 描述：节点描述，取值：1~50位字符串。 server：服务器。选择server，添加服务器。添加服务器时，待添加的服务器安装HBlock后，才可以编辑下列信息： 子节点名称：字符串形式，长度范围1~63，只能由字母、数字、句点(.)、下划线（）和短横线()组成，字母区分大小写，且仅支持以字母或数字开头。 服务器IP：指定需要添加的服务器IP，支持IPv4和IPv6地址。 端口号：指定API端口号。取值范围是[1, 65535]，默认值是1443。需要和该服务器安装HBlock时设置的API端口号保持一致。 数据目录：包括数据目录、容量配额、操作。 数据目录：服务器中，用于存储用户数据的绝对路径。 容量配额：一旦达到配额，就立刻阻止数据写入。支持输入数字（默认单位为GiB），或者输入“数字+单位”，数字应精确到两位小数，单位可为KiB、MiB、GiB、TiB或者PiB，并且配额需要不大于数据目录总容量，0表示禁止写入，负数或者不填表示无限制。 操作：点击“移除”，可以移除添加的数据目录。点击“添加”，可以添加数据目录。 描述：节点描述，取值：1~50位字符串。 room类型节点 移除 当room节点没有子节点时，可以点击移除按钮，删除该节点。 room类型节点 编辑 节点名称：修改节点名称。取值：字符串形式，长度范围1~63，只能由字母、数字、句点(.)、下划线（）和短横线()组成，字母区分大小写，且仅支持以字母或数字开头。 room类型节点 编辑 描述：节点描述，取值：1~50位字符串。 rack类型节点 机房类型的节点。将鼠标放至节点名称处，可以显示节点名称、类型及描述信息。点击右键，可以选择添加子节点、移除节点、编辑节点或重映射。 rack类型节点 添加子节点 父节点类型。 rack类型节点 添加子节点 父节点名称。 rack类型节点 添加子节点 子节点类型，可以选择server，添加服务器。添加服务器时，待添加的服务器安装HBlock后，才可以编辑下列信息： 子节点名称：字符串形式，长度范围1~63，只能由字母、数字、句点(.)、下划线（）和短横线()组成，字母区分大小写，且仅支持以字母或数字开头。 服务器IP：指定需要添加的服务器IP，支持IPv4和IPv6地址。 端口号：指定API端口号。取值范围是[1, 65535]，默认值是1443。需要和该服务器安装HBlock时设置的API端口号保持一致。 数据目录：包括数据目录、容量配合、操作。 数据目录：服务器中，用于存储用户数据的绝对路径。 容量配额：一旦达到配额，就立刻阻止数据写入。支持输入数字（默认单位为GiB），或者输入“数字+单位”，数字应精确到两位小数，单位可为KiB、MiB、GiB、TiB或者PiB，并且配额需要不大于数据目录总容量，0表示禁止写入，负数或者不填表示无限制。 操作：点击“移除”，可以移除添加的数据目录。 描述：节点描述，取值：1~50位字符串。 rack类型节点 移除 当rack节点没有子节点时，可以点击“移除”按钮，删除该节点。 rack类型节点 编辑 节点名称：修改节点名称。取值：字符串形式，长度范围1~63，只能由字母、数字、句点(.)、下划线（）和短横线()组成，字母区分大小写，且仅支持以字母或数字开头。 rack类型节点 编辑 描述：节点描述，取值：1~50位字符串。 rack类型节点 重映射 变更父节点。通过下拉框，重新选择父节点名称。 server类型节点 服务器类型的节点。 将鼠标放至节点名称处，可以显示节点名称、类型、服务器ID、业务IP、集群IP、数据目录容量、数据目录已用容量、服务器状态及描述信息。 点击右键，可以选择添加子节点、移除节点、编辑节点或重映射。 server类型节点 添加子节点 父节点类型。 server类型节点 添加子节点 父节点名称。 server类型节点 添加子节点 子节点类型，可以选择path，添加数据目录。 数据目录：服务器中，用于存储用户数据的绝对路径，一次可以添加多个数据目录，数据目录以英文逗号（,）分开。 容量配额：一旦达到配额，就立刻阻止数据写入。支持输入数字（默认单位为GiB），或者输入“数字+单位”，数字应精确到两位小数，单位可为KiB、MiB、GiB、TiB或者PiB，并且配额需要不大于数据目录总容量，0表示禁止写入，负数或者不填表示无限制。 操作：点击“移除”，可以移除添加的数据目录。点击“添加”，可以添加数据目录。 server类型节点 移除 点击“移除”按钮，可以移除服务器。 注意 如果移除已损毁或者宕机的服务器，需要使用强制移除。强制移除服务器，会产生数据丢失风险，请谨慎操作。 如果移除服务器上有iSCSI目标，该iSCSI目标对应卷的高可用类型是ActiveStandby，移除服务器时，业务不会中断，此卷对应的iSCSI目标会切换到其他服务器上，客户端需要重新连接Target对应的新服务器IP。 如果移除服务器上有iSCSI目标，该iSCSI目标对应卷的高可用类型是Disabled，移除服务器时，业务会中断，此卷对应的iSCSI目标会切换到其他服务器上，客户端需要重新连接Target对应的新服务器IP。但服务器移除时，会有数据丢失风险。 如果执行日志采集后，产生的日志保存在服务器安装目录下，在服务器移除之后，该日志将被删除。如果产生的日志保存在HBlock的数据目录内，并且移除服务器时删除服务器HBlock数据目录中的数据，该日志也将被删除。 有服务器正在移除时，不能再移除其他服务器。如果必须移除，请使用强制移除，但有丢数据风险。 该节点的所有数据目录不属于任何存储池，允许移除该服务器。否则不能移除，如果必须移除，请使用强制移除，但有丢数据风险。 如果要移除服务器的某个数据目录属于基础存储池，且是基础存储池中仅剩的一个可用故障域中的节点，不允许移除。 server类型节点 编辑 节点名称：修改节点名称。取值：字符串形式，长度范围1~63，只能由字母、数字、句点(.)、下划线（）和短横线()组成，字母区分大小写，且仅支持以字母或数字开头。 server类型节点 编辑 描述：节点描述，取值：1~50位字符串。 server类型节点 重映射 变更父节点。通过下拉框，重新选择父节点名称。 path类型节点 数据目录类型的节点。 将鼠标放至节点名称处，可以显示节点名称、类型、数据目录容量、数据目录已用容量、容量配额、已用容量配额、健康状态、健康详情、存储池。 点击右键，可以移除数据目录。 注意 强制移除数据目录，有产生数据丢失风险。 如果执行日志采集后，产生的日志保存在HBlock的数据目录内，移除数据目录时删除数据目录上的HBlock数据，该日志将被删除。 有数据目录正在移除时，不能再移除其他数据目录。如果必须移除，请使用强制移除，但有丢数据风险。

本节主要介绍如何下载备份数据 Redis 管理控制台支持备份数据下载。 备份完成后，您可根据需求获取公网或内网下载地址进行下载。 前提条件 只有当缓存实例处于“运行中”状态，才能执行此操作。 操作步骤 1. 登录 Redis管理控制台。 2. 在管理控制台右上角选择实例所在的区域。 3. 在实例列表页，单击目标实例名称进入实例详情页面。 4. 左侧菜单点击备份与恢复，进入备份管理操作页面。 5. 点击【下载】按钮，弹框展示公网和内网下载地址，根据需求获取下载地址。 6. 访问下载地址，获取备份文件。 说明 仅当备份成功后，方可下载备份数据。

本节主要介绍分布式缓存Redis的连接约束 分布式缓存服务Redis实例可以被兼容Redis协议的任何客户端访问。您可以根据自己的应用需求选择适合的Redis客户端。有关Redis支持的客户端列表，请参考Redis官网，有关各客户端的连接方式，请参考通过客户端连接方式。 使用分布式缓存Redis实例前，请注意以下约束条件： 1.Redis默认安全组未配置规则时，禁止所有入站流量。如需允许同VPC内云主机访问，必须显式添加允许Redis服务端口（6379）的入站规则。 2.在您的弹性云主机安装客户端后，必须要与需要连接的Redis实例处于同一虚拟私有云（VPC）内，并配置相同的安全组。如果使用不同的安全组，则您需设置安全组连通规则，以确保弹性云主机与Redis实例之间的网络连接正常。目前暂不支持弹性云主机与Redis实例跨VPC访问。 3.当使用公网访问Redis实例时，Redis缓存实例配置了正确的安全组规则，其安全组入方向规则，必须允许外部地址访问实例端口。具体配置请参考常见问题网络与连接如何配置安全组。

分布式缓存提供实例开启扩展模块功能（Redis Module），目前支持以下几种扩展模块 RedisJSON：对JSON类型的原生支持 RediSearch：一个功能齐全的搜索引擎 说明 扩展模块功能目前为白名单特性，如需要使用该特性，请联系技术支持开通后使用。 注意 RedisJSON、RediSearch等模块均包含有自定义数据类型，开启后不能被卸载，且有可能会影响离线全量key分析功能。 前提条件 只有当分布式缓存Redis缓存实例处于“运行中”状态且副本数不小于2时，才能执行此操作。 约束条件 经典集群、Proxy集群、读写分离实例类型不支持。 操作步骤 1. 登录 Redis管理控制台。 2. 在管理控制台左上角选择实例所在的区域。 3. 在实例列表页，单击目标实例名称进入实例详情页面。 4. 左侧菜单点击RedisModule菜单，进入RedisModule界面，即可展示和管理当前实例的扩展模块。 界面自动展示当前实例可加载的扩展模块种类。 点击选定扩展模块开关可开启加载选定的扩展模块。

本节主要介绍如何下载备份数据 Redis 管理控制台支持备份数据下载。 备份完成后，您可根据需求获取公网或内网下载地址进行下载。 前提条件 只有当缓存实例处于“运行中”状态，才能执行此操作。 操作步骤 1. 登录 Redis管理控制台。 2. 在管理控制台右上角选择实例所在的区域。 3. 在实例列表页，单击目标实例名称进入实例详情页面。 4. 左侧菜单点击备份与恢复，进入备份管理操作页面。 5. 点击【下载】按钮，弹框展示公网和内网下载地址，根据需求获取下载地址。 6. 访问下载地址，获取备份文件。 说明 仅当备份成功后，方可下载备份数据。

参数 示例值 描述 k8s.ctyun.cn/eciusespecs pi7.4xlarge.4 指定ECI实例规格，只支持指定一种规格 k8s.ctyun.cn/eciimagecache "true" 配置为true表示自动匹配镜像缓存 k8s.ctyun.cn/eciimagesnapshotid imc7nh0dkpoaxepqyh2 指定镜像缓存ID k8s.ctyun.cn/ecisecuritygroup sg5bvqyvrmch 指定ECI容器实例所在的安全组ID k8s.ctyun.cn/ecieipinstanceid eipxxxx 指定弹性IP的ID。注：弹性IP默认不开放8080、80、443、8443端口，建议使用其他端口 k8s.ctyun.cn/eciiamrolename testName ECS资源委托名称 k8s.ctyun.cn/ecisubnet subnetxxxx 指定ECI子网ID。注：只支持单个子网

参数 示例值 描述 ccse.ctyun.cn/eniinstanceid portxxx ECI容器实例的网卡ID k8s.ctyun.cn/eciinstanceid ecixxxxx ECI容器实例的ID k8s.ctyun.cn/eciinstancecpu "1.0" ECI容器实例CPU大小 k8s.ctyun.cn/eciinstancemem "1.0" ECI容器实例Memory大小 k8s.ctyun.cn/eciinstancezone cnxxxxxxxxpublicctcloud ECI容器实例所在可用区名称 k8s.ctyun.cn/ecivpc vpcxxxxxx ECI容器实例所属VpcId k8s.ctyun.cn/ecisubnet subnetxxxxxx ECI容器实例所属子网ID k8s.ctyun.cn/ecisecuritygroup sgxxxxxx ECI容器实例所在的安全组ID k8s.ctyun.cn/ecirequestid 80e90ccca5b54034acae7c0c8eeb376f 请求ID k8s.ctyun.cn/k8sversion v1.25.6 集群版本 k8s.ctyun.cn/clusterdns 10.96.0.10 集群DNS服务器的IP地址 k8s.ctyun.cn/clusterdomain cluster.local 集群本地域名 k8s.ctyun.cn/vkversion v1.2.020240829 cubevk版本

本文介绍如何配置eciprofile。 基于 Kubernetes 的 Mutating Webhook机制实现了eciprofile，支持为调度到虚拟节点上的 Pod 自动追加Annotations、Labels、Tolerations等，实现自动修改Pod 的规格、镜像缓存、安全组等配置，降低您对业务 Pod 配置的维护成本。本文介绍如何配置eciprofile。 功能介绍 对于ECI的一些功能特性，例如指定ECI实例规格，启用镜像缓存等，需要在Pod中追加Annotation或者Label来实现。更多信息，请参见ECI Pod Annotation。 对于上述情况，eciprofile实现了自动追加Annotation和Label的功能。在eciprofile中，您可以自定义selector，在selector中同时指定筛选条件和要追加的Annotation和Label，满足selector筛选条件的Pod会自动追加指定的Annotation和Label。 前提条件 1. 确保您已经创建Serverless集群，具体操作请参阅创建Serverless集群。 2. 已在插件市场安装插件eciprofile，且插件正常运行。 3. 确保kubectl工具已经连接目标集群。 selectors配置 创建Pod时，系统会按照selectors去匹配Pod，对于Label能够匹配上的Pod，会自动追加Annotation和Label，以便生效ECI的功能特性。 Selector 支持两种匹配方式： 1. 命名空间标签匹配。 2. Pod标签匹配。 可以分别通过 namespaceLabels 和 objectLabels 字段来指定匹配的 Namespace 和 Pod 标签。通过 effect 字段配置的 Annotation 和 Label 会自动追加到匹配的 Pod 上。 说明 要了解 Selector 的生效情况，可以通过查看 Pod 上的 k8s.ctyun.cn/matchedselector 标签来判断。 新增的 Selector 不会应用于存量 Pod，仅对新创建的 Pod 生效，若需要对现有工作负载生效，请重新部署工作负载。 在一个 Selector 中，建议您至少配置 namespaceLabels 和 objectLabels 中的一个。如果两者同时配置了，则Pod需要同时匹配两者；如果两者均未配置或者为空对象，且配置了 effect，则 effect 对所有 Pod 均生效。 1. 命名空间标签匹配。 假设想让集群中新创建的所有Pod都默认使用1C1G的规格，Selector配置模板如下： shell apiVersion: eci.ctyun.cn/v1 kind: Selector metadata: name: 1c1gglobal spec: namespaceLabels: {}

本文介绍如何配置eciprofile。 基于 Kubernetes 的 Mutating Webhook机制实现了eciprofile，支持为调度到虚拟节点上的 Pod 自动追加Annotations、Labels、Tolerations等，实现自动修改Pod 的规格、镜像缓存、安全组等配置，降低您对业务 Pod 配置的维护成本。本文介绍如何配置eciprofile。 功能介绍 对于ECI的一些功能特性，例如指定ECI实例规格，启用镜像缓存等，需要在Pod中追加Annotation或者Label来实现。更多信息，请参见ECI Pod Annotation。 对于上述情况，eciprofile实现了自动追加Annotation和Label的功能。在eciprofile中，您可以自定义selector，在selector中同时指定筛选条件和要追加的Annotation和Label，满足selector筛选条件的Pod会自动追加指定的Annotation和Label。 前提条件 1. 确保您已经创建Serverless集群，具体操作请参阅创建Serverless集群。 2. 已在插件市场安装插件eciprofile，且插件正常运行。 3. 确保kubectl工具已经连接目标集群。 selectors配置 创建Pod时，系统会按照selectors去匹配Pod，对于Label能够匹配上的Pod，会自动追加Annotation和Label，以便生效ECI的功能特性。 Selector 支持两种匹配方式： 1. 命名空间标签匹配。 2. Pod标签匹配。 可以分别通过 namespaceLabels 和 objectLabels 字段来指定匹配的 Namespace 和 Pod 标签。通过 effect 字段配置的 Annotation 和 Label 会自动追加到匹配的 Pod 上。 说明 要了解 Selector 的生效情况，可以通过查看 Pod 上的 k8s.ctyun.cn/matchedselector 标签来判断。 新增的 Selector 不会应用于存量 Pod，仅对新创建的 Pod 生效，若需要对现有工作负载生效，请重新部署工作负载。 在一个 Selector 中，建议您至少配置 namespaceLabels 和 objectLabels 中的一个。如果两者同时配置了，则Pod需要同时匹配两者；如果两者均未配置或者为空对象，且配置了 effect，则 effect 对所有 Pod 均生效。 1. 命名空间标签匹配。 假设想让集群中新创建的所有Pod都默认使用1C1G的规格，Selector配置模板如下： shell apiVersion: eci.ctyun.cn/v1 kind: Selector metadata: name: 1c1gglobal spec: namespaceLabels: {}

云电脑OpenClaw默认模型 API 云电脑中的 OpenClaw ，会根据当下算力使用情况，默认动态调用如下大模型：Mini Max M2.5，GLM5，DeepSeek V3.2等。 如何切换模型（使用云电脑中云智助手） 在云智助手更新算力模型 1. 进入天翼AI云电脑的桌面端、移动端或小程序的AI云电脑列表页面； 2. 在进入【云电脑】桌面后找到【云智助手】客户端； 3. 在【云智助手】OpenClaw模块中找到云桌面名称（小龙虾住址）； 4. 在【云智助手】侧边栏中找到【AI算力】模块； 5. 在【AI算力】列表中，找到对应小龙虾（OpenClaw）桌面名使用的API，点击【编辑】； 6. 在【编辑】页面中，选择你想用的模型，保存后生效。 在云智助手中获取配置项 1. 打开云智助手AI算力列表，查看当前账号的模型API Key；若无API Key，需按流程手动创建； 2. 在算力列表页，点击【API接入】； 3. 在【API接入】页面获取模型参数：Base URL（基础URL）、模型ID、API协议类型。

本节介绍云电脑的镜像和迁移操作指南。 如何升级到最新镜像 如何迁移OpenClaw 如何迁移skills Windows 系统迁移步骤 Ubuntu/妙逸系统迁移步骤 如何升级到最新镜像 升级新镜像的方法同重装操作系统一致，参考下方链接中“已有云电脑用户，切换OpenClaw镜像体验” + /share++ 如何迁移OpenClaw 如何把openclaw从一台云电脑迁移到另一台云电脑，龙虾启动不起来了，想重装镜像，客户要备份哪些文件夹，可以保留当前的龙虾的记忆和特点。以云电脑A迁移到云电脑B为例，操作方法如下： 1. 备份云电脑A中，C:UsersAdministrator.openclaw这个文件夹，直接右键文件夹，复制整个； 2. 备份云电脑A中，C:UsersAdministratorclawd 这个文件夹，直接右键文件夹，复制整个； 3. 将复制好的两个文件夹 .opencalw 、 clawd 备份，重装系统后再传入到新的云电脑B； 4. 重装镜像 或者 进入云电脑B 之后，将上述备份的两个文件夹，替换掉这两个路径下的文件夹： C:UsersAdministrator.openclaw C:UsersAdministratorclawd 注意 1. 可以先备份新镜像 或 新云电脑B 的 .openclaw、 clawd这两个文件夹，然后将云电脑A的两个文件夹放到上述两个路径 2. 上述路径为openclaw默认路径，如用户修改过默认存储路径，以用户修改为准。 （5）替换文件夹成功后，在云电脑B重启OpenClaw应用，即可看到云电脑A的使用数据。

本节介绍在云电脑中使用OpenClaw的常见问题。 如何获取云电脑系统密码？ OpenClaw云电脑开机后一直停留在黑色页面，没有进度。 OpenClaw的后台服务打开后闪退 如果云电脑是内网，不能访问外网可以用吗？ 云电脑OpenClaw默认打开谷歌浏览器，这个默认浏览器可以修改吗？ 提问OpenClaw没有回答，后台进程显示“403 Forbidden”字样的报错信息。 OpenClaw提示：已断开与网关的连接，device identity required 小程序的AI云电脑的界面进入不了云电脑，显示订购页面 OpenClaw上下文超过模型处理上限 windosw 安装插件时找不到NPM问题 旧版本openclaw集成飞书后再升级openclaw导致 配置文件改坏导致无法启动 无法创建提醒与定时任务 如何获取云电脑系统密码？ 在开通云电脑时，会通过短信发送系统密码，请注意查收短信。如未收到短信，请通过云电脑客户端→设置→立即报障，进行处理。

本节介绍在云电脑中使用OpenClaw的常见问题。 如何获取云电脑系统密码？ OpenClaw云电脑开机后一直停留在黑色页面，没有进度。 OpenClaw的后台服务打开后闪退 如果云电脑是内网，不能访问外网可以用吗？ 云电脑OpenClaw默认打开谷歌浏览器，这个默认浏览器可以修改吗？ 提问OpenClaw没有回答，后台进程显示“403 Forbidden”字样的报错信息。 OpenClaw提示：已断开与网关的连接，device identity required 小程序的AI云电脑的界面进入不了云电脑，显示订购页面 OpenClaw上下文超过模型处理上限 windosw 安装插件时找不到NPM问题 旧版本openclaw集成飞书后再升级openclaw导致 配置文件改坏导致无法启动 无法创建提醒与定时任务 如何获取云电脑系统密码？ 在开通云电脑时，会通过短信发送系统密码，请注意查收短信。如未收到短信，请通过云电脑客户端→设置→立即报障，进行处理。

本节主要介绍如何使用API设置存储池内卷的默认QoS策略。 此操作用来设置存储池内卷的默认QoS策略。 说明 当多次设置存储池内卷的默认QoS策略，以最后一次操作为准。 请求语法 plaintext PUT /rest/v1/system/qos/qosName/storagepoolforlun/assoc HTTP/1.1 Date: date ContentType: application/json; charsetutf8 ContentLength: length Host: ip:port Authorization: authorization { "list": [ storagepool1,storagepool2… ], } 请求参数 参数 类型 描述 是否必须 qosName String 指定QoS策略名称。 是 list Array of string 指定存储池名称，设置该存储池内卷的默认QoS策略。 是 请求示例 设置存储池内卷的默认QoS策略。 plaintext PUT /rest/v1/system/qos/QoS6/storagepoolforlun/assoc HTTP/1.1 Date: Wed, 02 Jul 2025 04:01:21 GMT ContentType: application/json; charsetutf8 Authorization: HBlock userName:signature ContentLength: 37 Host: 192.168.0.64:1443 { "list": ["default","pool1"] } 响应示例 plaintext HTTP/1.1 204 No Content xhblockrequestid: e4cec28689ef42bc9cd8caac91134fdc Connection: keepalive Date: Wed, 02 Jul 2025 04:01:21 GMT Server: HBlock

参数 类型 描述 是否必须 filter String 查询的过滤条件。 支持的过滤条件类型包括： poolName：存储池名称。 否

参数 类型 描述 是否必须 poolName String 存储池名称。 取值：长度范围是1~16，只能由字母、数字和短横线（）、下划线（）组成，字母区分大小写，且仅支持以字母和数字开头。 是

名称 类型 描述 ip String iSCSI target的IP。 port Integer iSCSI target的端口号。