活动

天翼云最新优惠活动,涵盖免费试用,产品折扣等,助您降本增效!
热门活动
  • 云上钜惠 爆款云主机全场特惠,2核4G只要1.8折起!
  • 中小企业服务商合作专区 国家云助力中小企业腾飞,高额上云补贴重磅上线
  • 出海产品促销专区 NEW 爆款云主机低至2折,高性价比,不限新老速来抢购!
  • 天翼云奖励推广计划 加入成为云推官,推荐新用户注册下单得现金奖励
免费活动
  • 免费试用中心 HOT 多款云产品免费试用,快来开启云上之旅
  • 天翼云用户体验官 NEW 您的洞察,重塑科技边界

息壤智算

领先开放的智算服务平台,提供算力、平台、数据、模型、应用“五位一体”智算服务体系,构建全流程的AI基础设施能力
AI Store
  • 算力市场
  • 模型市场
  • 应用市场
  • MCP市场
算力互联调度平台
  • 裸金属
  • 定制裸金属
训推服务
  • 模型开发
  • 训练任务
  • 服务部署
模型推理服务
  • 模型广场
  • 体验中心
  • 服务接入
应用托管
  • 应用实例
科研助手
  • 科研智能体
  • 科研服务
  • 开发机
  • 并行计算
大模型
  • DeepSeek-V3.1
  • DeepSeek-R1-0528
  • DeepSeek-V3-0324
  • Qwen3-235B-A22B
  • Qwen3-32B
智算一体机
  • 智算一体机
模型适配专家服务
  • 模型适配专家服务
算力服务商
  • 入驻算力服务商

应用商城

天翼云精选行业优秀合作伙伴及千余款商品,提供一站式云上应用服务
进入甄选商城进入云市场进入AI Store创新解决方案公有云生态专区智云上海应用生态专区
AI应用
  • 泛微合同管理解决方案
  • 泛微数智大脑Xiaoe.AI解决方案
  • MaxKB知识库解决方案
  • 天翼AI文创
AI服务
  • 昆仑AI训推服务解决方案
  • 国信模型服务解决方案
企业应用
  • 翼电子签约解决方案
  • 翼协同解决方案
  • 翼电签-契约锁解决方案
  • 翼视频云归档解决方案
教育应用
  • 翼电子教室
  • 潜在AI教育解决方案
建站工具
  • SSL证书
  • 翼定制建站解决方案
  • 翼多端小程序解决方案
办公协同
  • 天翼云企业云盘
  • 安全邮箱
灾备迁移
  • 云管家2.0
资源管理
  • 全栈混合云敏捷版(软件)
  • 全栈混合云敏捷版(一体机)

定价

协助您快速了解云产品计费模式、价格详情,轻松预估上云成本
价格计算器
  • 动态测算产品价格
定价策略
  • 快速了解计费模式

合作伙伴

天翼云携手合作伙伴,共创云上生态,合作共赢
天翼云生态合作中心
  • 天翼云生态合作中心
天翼云渠道合作伙伴
  • 天翼云代理渠道合作伙伴
天翼云服务合作伙伴
  • 天翼云集成商交付能力认证
天翼云应用合作伙伴
  • 天翼云云市场合作伙伴
  • 天翼云甄选商城合作伙伴
天翼云技术合作伙伴
  • 天翼云OpenAPI中心
天翼云培训认证
  • 天翼云学堂
  • 天翼云市场商学院
天翼云合作计划
  • 云汇计划
天翼信创云专区
  • 信创云专区
  • 适配互认证

开发者

开发者相关功能入口汇聚
技术社区
  • 专栏文章
  • 互动问答
  • 技术视频
资源与工具
  • OpenAPI中心
培训与认证
  • 天翼云学堂
  • 天翼云认证
开源社区
  • 魔乐社区
  • OpenTeleDB

支持与服务

为您提供全方位支持与服务,全流程技术保障,助您轻松上云,安全无忧
文档与工具
  • 文档中心
  • 新手上云
  • 自助服务
  • OpenAPI中心
定价
  • 价格计算器
  • 定价策略
基础服务
  • 售前咨询
  • 在线支持
  • 在线支持
  • 工单服务
  • 服务保障
  • 会员中心
增值服务
  • 红心服务
  • 首保服务
  • 客户支持计划
  • 专家技术服务
  • 备案管家
我要反馈
  • 建议与反馈
  • 用户体验官
信息公告
  • 客户公告

了解天翼云

天翼云秉承央企使命,致力于成为数字经济主力军,投身科技强国伟大事业,为用户提供安全、普惠云服务
品牌介绍
  • 关于天翼云
  • 智算云
  • 天翼云4.0
  • 新闻资讯
  • 天翼云APP
基础设施
  • 全球基础设施
  • 信任中心
最佳实践
  • 精选案例
  • 超级探访
  • 云杂志
  • 分析师和白皮书
  • 天翼云·创新直播间
市场活动
  • 2025智能云生态大会
  • 2024智算云生态大会
  • 2023云生态大会
  • 2022云生态大会
  • 天翼云中国行
天翼云
  • 活动
  • 息壤智算
  • 产品
  • 解决方案
  • 应用商城
  • 定价
  • 合作伙伴
  • 开发者
  • 支持与服务
  • 了解天翼云
      • 文档
      • 控制中心
      • 备案
      • 管理中心
      文档中心

      对象存储

      对象存储

      • 对象存储

      无数据

        • 产品动态
        • 产品简介
        • 产品定义
        • 基本概念
        • 产品优势
        • 功能特性
        • 产品应用场景
        • 产品规格
        • 地域说明
        • 产品使用限制
        • 与其他服务的关系
        • 产品能力地图
        • 计费说明
        • 计费项
        • 存储费用
        • 流量费用
        • 请求费用
        • 数据取回费用
        • 计费模式
        • 按需计费
        • 包年包月(资源包)计费
        • 资源包概述
        • 资源包购买
        • 查看资源包详情
        • 资源包续订
        • 资源包退订
        • 查看消费明细
        • 欠费
        • 常见问题
        • 快速入门
        • 入门流程
        • 准备工作
        • 开通对象存储服务
        • 获取访问密钥(AK/SK)
        • 查询终端节点(Endpoint)
        • 用户配额
        • 工具下载及使用
        • 创建桶
        • 上传文件
        • 下载文件
        • 删除文件
        • 删除桶
        • 常用实践
        • 用户指南
        • 使用方式
        • 访问规则
        • 存储类别
        • 统计数据
        • 桶管理
        • 桶概述
        • 创建桶
        • 列举桶
        • 桶概览
        • 桶配额
        • 删除桶
        • 对象管理
        • 对象概述
        • 新建目录
        • 上传文件
        • 下载文件
        • 其他文件管理操作
        • 列举文件
        • 复制文件
        • 查看文件
        • 分享文件
        • 解冻归档文件
        • 删除
        • 删除文件
        • 恢复文件
        • 清理碎片
        • 数据管理
        • 生命周期管理
        • 桶清单
        • 数据访问
        • 数据回源
        • 域名管理
        • 数据安全
        • 服务端加密
        • 合规保留
        • 跨域访问设置
        • 多版本管理
        • 防盗链
        • 数据处理
        • 图片处理
        • 监控与日志
        • 监控
        • 日志管理
        • 审计
        • 控制台指南
        • 控制台功能概述
        • 入门操作
        • 入门流程
        • 开通对象存储服务
        • 资源包管理
        • 接入管理(VPC)
        • 创建桶
        • 上传文件
        • 下载文件
        • 删除文件
        • 删除桶
        • 桶管理
        • 创建桶
        • 列举桶
        • 桶概览
        • 搜索桶
        • 桶配额
        • 删除桶
        • 文件管理
        • 新建目录
        • 上传文件
        • 修改文件存储类型
        • 下载文件
        • 其他文件管理操作
        • 列举文件
        • 重命名文件
        • 搜索文件
        • 设置文件标签
        • 通过URL访问对象
        • 复制文件
        • 分享文件
        • 解冻归档文件
        • 归档直读文件
        • 删除
        • 删除文件
        • 恢复文件
        • 清理碎片
        • 权限管理
        • 权限管理方式介绍
        • 读写权限
        • 桶的读写权限
        • 文件读写权限
        • IAM权限管理
        • 桶策略
        • STS临时授权
        • 桶ACL
        • 双端固定
        • 数据管理
        • 生命周期管理
        • 生命周期管理简介
        • 生命周期管理配置
        • 桶清单
        • 数据访问
        • 自定义域名管理
        • 静态页面设置
        • 数据回源
        • 数据回源简介
        • 数据回源配置
        • 数据安全
        • 服务端加密
        • 合规保留
        • 跨域访问设置
        • 多版本管理
        • 对象多版本简介
        • 配置多版本
        • 跨区域复制
        • 防盗链
        • 对象存储迁移服务
        • 服务概览
        • 评估任务教程
        • 创建评估任务
        • 查看评估任务详情
        • 管理评估任务
        • 迁移任务教程
        • 如何创建迁移任务
        • 查看迁移任务详情
        • 查看任务迁移记录
        • 查看迁移失败对象
        • 管理迁移任务
        • 迁移常见问题及处理
        • 使用前常见问题
        • 使用常见问题
        • 迁移异常处理
        • 如何使用半托管模式进行迁移
        • 半托管迁移模式简介
        • 使用控制台创建代理
        • 部署代理
        • 使用控制台管理已部署的代理
        • 半托管模式迁移任务的创建与管理
        • 各云服务商迁移至ZOS教程
        • 天翼云ZOS之间进行迁移
        • 阿里云OSS迁移至天翼云ZOS
        • 腾讯云COS迁移至天翼云ZOS
        • 华为云OBS迁移至天翼云ZOS
        • 天翼云OOS迁移至天翼云ZOS
        • 不同场景的迁移方案
        • 源端归档数据迁移方案
        • 源端增量数据迁移方案
        • 监控与日志
        • 监控
        • 日志管理简介
        • 日志管理配置
        • 数据处理指南
        • 图片处理
        • 图片处理概述
        • 使用方式
        • 图片处理参数
        • 图片缩放
        • 图片水印
        • 图片裁剪
        • 图片旋转
        • 格式转换
        • 信息获取
        • EXIF信息删除
        • 质量变换
        • 亮度变换
        • 渐进显示
        • 高斯模糊
        • 自适应方向
        • 获取平均色调
        • 锐化
        • 对比度
        • 内切圆
        • 圆角矩形
        • 索引切割
        • 图片连续处理
        • 图片样式
        • 图片持久化
        • SDK参考
        • 开发者文档
        • API参考
        • API(OpenAPI)
        • 调用前必知
        • 概述
        • 终端节点
        • 资源池regionID列表
        • 如何调用API
        • 构造请求
        • 认证鉴权
        • Python调用示例
        • Java调用示例
        • 最佳实践
        • 最佳实践汇总
        • 通过控制台访问对象存储ZOS
        • 云主机通过内网访问对象存储ZOS
        • 通过生命周期策略实现数据自动管理
        • 使用对象存储迁移服务将第三方云厂商数据迁移至对象存储ZOS
        • 修改文件读写权限
        • 数据一致性校验
        • 对象存储ZOS性能优化最佳实践
        • 通过云监控服务实时监控对象存储ZOS信息
        • 大文件分段上传
        • 解决浏览器跨域(CORS)问题的实践
        • 使用预签名URL直传对象存储
        • 批量删除桶内对象
        • 获取对象文件的直接地址(下载链接)
        • VPC内网中使用和公网相同的域名访问对象存储
        • 使用VPCE方式接入对象存储
        • 使用CDN加速访问对象存储ZOS
        • 基于全站加速的对象存储ZOS传输加速最佳实践
        • 统计目录中的对象数量和大小
        • 常见问题
        • 热点问题
        • 售前常见问题
        • 计费常见问题
        • 存储桶常见问题
        • 对象(文件)常见问题
        • 视频专区
        • 相关协议
        • 中国电信天翼云对象存储服务协议
        • 中国电信天翼云对象存储服务等级协议
        • 常用工具
        • zosfs(预览版)
        • zosfs介绍及下载
        • zosfs使用限制
        • zosfs使用说明
        • 对象迁移工具
        • 文件上云迁移工具
        • S3Browser
        • zosutil
        • 自动化策略工具
        • 自助工具
        • 签名工具
        • SDK工具
        • 网络异常工具
        • 文件下载方式工具
        • 文档下载
          无相关产品

          本页目录

          帮助中心对象存储控制台指南对象存储迁移服务如何使用半托管模式进行迁移部署代理
          部署代理
          更新时间 2026-02-04 21:53:52
          • 新浪微博
          • 微信
            扫码分享
          • 复制链接
          最近更新时间: 2026-02-04 21:53:52
          分享文章
          • 新浪微博
          • 微信
            扫码分享
          • 复制链接
          本文为您介绍什么是代理,如何部署代理,以及一些代理相关的常见问题。

          什么是代理软件

          代理软件(zms-agent)是依托于天翼云对象迁移服务(ZMS),专为天翼云对象存储ZOS(Zettabyte Object Storage)  数据迁移设计的分布式迁移工具。通过将代理软件(zms-agent)部署在本地或云主机中,能高效地从其他对象存储服务向ZOS进行大规模数据迁移。

          代理软件(zms-agent)包含两个部分:

          • zms-master服务(主节点):一个迁移集群部署一个,负责与服务端通信与任务调度。从源端对象存储获取待迁移的对象列表,然后分发给各个zms-worker服务执行迁移。

          • zms-worker服务(工作节点):一个迁移集群可部署一个或多个,至少一个,负责迁移数据。根据zms-master服务分发的对象列表,进行数据下载和数据上传,实现数据迁移。

          用户部署代理软件后与ZMS服务控制台的关系如下所示:

           

          代理的部署类型

          单台部署

          单台机器,用于部署代理的zms-master服务和zms-worker服务。

          分布式部署

          多台机器,每台机器均部署zms-worker服务,zms-master服务部署在其中一台机器;或一台机器部署zms-master服务,其余机器部署zms-worker服务。

          • 代理的zms-master服务与任一zms-worker服务部署在同一台机器。

          • 代理的zms-master服务单独部署于一台机器。

           

          代理的部署环境

          部署代理软件的环境、网络和机器配置如下,建议您阅读后,根据实际需要进行代理的部署。

          系统与架构

          • Linux-amd64

          • CentOS7.9、CtyunOS 23.01、CtyunOS 2.0.1、CtyunOS 22.06

          网络要求

          • 部署zms-master服务的机器必须联通公网,以供与对象迁移服务(ZMS)服务通信,与ZMS服务通信公网带宽不低于10Mbps即可。

          • 部署zms-worker服务的机器必须可联通源端、目的端的对象存储服务,公网、内网或专线均可。

          • 部署zms-master服务的机器与zms-worker服务的机器之间必须联通。

          推荐配置

          无论单台部署或分布式部署,每台机器的配置,我们推荐以下两种常见的配置组合:

          服务器配置zms-worker服务并发数(process_nums)网络带宽下限

          4核心8GB内存

          (系统盘不低于60GB)

          建议值为6不小于30Mbps即可

          8核心16GB内存

          (系统盘不低于60GB)

          建议值为12

          不小于60Mbps即可

           

          zms-worker服务并发数(process_nums)的调优:并发数配置最多不能超过机器核心数的1.5倍。

           

          如何针对源端数据模型调整配置:

          • 大文件较多的场景:迁移速度的主要瓶颈是网络带宽,建议配置较大的网络带宽进行迁移。

          • 存在大量小文件(<1KB)的场景:迁移速度的主要瓶颈为CPU核心数,建议配置教多核心数的CPU机器,通常在8核心以上。

           

          如何推算需要多少台机器进行部署:

          计算原则:所需机器数量=预期迁移总带宽÷单台机器的网络带宽

          例如:您预期本项目需要总共1000Mbps的公网带宽,你可提供机器的单台公网带宽为200Mbps,则您总共需要5台机器来部署(5台=1000Mbps÷200Mbps)。

          注意

          建议您针对源端数据模型的特征,选择合适的机器配置,通过迁移前的测试,进一步调整并发数(process_nums)的配置,以此实现更好的迁移效果。

           

          如何部署代理

          代理的部署与启用

          第一步:下载安装

          zms-agent 安装包下载,下载后进行解压,zms-agent 安装包解压后的目录如下:

          zms-agent/ conf/ -master_conf.ini -worker_conf.ini certs/ -server.key -server.crt bin/ -zms-agent -zms-master.service -zms-worker.service -install.sh -uninstall.sh

          文件/文件夹说明
          binfolder,可执行文件
          certsfolder, 用户rpc加密通信的自签名证书
          conffolder,master和worker的配置文件
          install.shfile,安装脚本
          uninstall.shfile,卸载脚本

          执行如下脚本,实现代理安装:

          sh install.sh

          zms-agent采用master-worker的主从架构,一台master对应一到多台worker。因此安装时可以选择安装zms-master、zms-worker或两者都安装。然后选择是否开机自启动,默认为否。实际使用时仅在一台机器上安装zms-master即可。

           

          第二步:填写配置文件参数

          zms-master、zms-worker服务启动前,需要确认配置文件内容填写正确。

          • zms-master配置文件:conf/master_conf.ini

          zms-master启动前必须修改配置文件中的[register]、[host]两个部分,其余参数若无特殊需要则无需修改。

          字段默认值限制说明
          [log]
          log_levelDEBUG

          DEBUG/INFO/

          WARNING/ERROR/CRITICAL

          日志级别
          [migration]
          check_sdk_timeout5[1, 60]校验源端目的端连通性时sdk超时时间
          max_scheduler_task_num6[1, 12]同时调度执行的任务数,后续任务排队
          list_max_nums1000[1, 1000]对象存储单次获取对象数(整桶/指定文件夹/指定前缀模式每批子任务包含对象数)
          distribution_sub_task_length12[2, 96]master向worker单次发送子任务数
          scanning_thread_nums6[1, 12]指定文件迁移或失败文件重试模式获取对象元数据并发数
          failed_retry_list_max_nums100[1, 1000]失败文件重试模式每批子任务包含对象数
          failed_file_upload_max_retry_times3[1, 5]失败对象文件上传到目的桶的最大重试次数
          [gRPC]
          grpc_max_workers100[50, 100]gRPC最大并发连接数
          grpc_server_port[::]:8282[::]:portgRPC服务端口
          grpc_client_timeout5[1, 60]gRPC客户端超时时间
          [MQ]
          mq_host加密值无需修改半托管MQ服务地址
          mq_port加密值无需修改半托管MQ服务端口
          mq_user加密值无需修改半托管MQ服务用户名
          mq_password加密值无需修改半托管MQ服务密码
          server_queuezmigserver_queue无需修改半托管MQ服务Server通道名称
          mq_reconnect_interval5[1, 60]连接MQ通道断开重连间隔
          [register]
          register_code——首次启动需要该字段半托管Agent注册码,在天翼云官网创建Agent时获取
          [host]
          master_addr——需要携带GRPC启动端口,与grpc_server_port保持一致半托管集群Master内网、公网地址,用于Master与Worker通信,不需要http://前缀
          work_addrs——多个Worker以逗号分隔,需要携带GRPC启动端口,并与Worker配置中保持一致半托管集群所有Worker内网、公网地址,用于Master与Worker通信,不需要http:// 前缀

          注意

          master与worker通信地址可以使用内网,也可以使用公网,如果各节点内网通的话建议优先使用内网地址。同时注意各机器安全组、防火墙等配置,需要放开通信端口。

           

          • zms-worker配置文件:conf/worker_conf.ini

          zms-worker参数若无特殊需求则都无需修改。

          字段默认值取值范围说明
          [log]
          log_levelDEBUGDEBUG/INFO/WARNING/ERROR/CRITICAL日志等级
          migration_retry_count3[1, 5]对象最多迁移失败重试次数
          process_nums8[1, 1.5*cpu核心数]迁移进程级别并发数
          [grpc]
          grpc_max_workers10[5, 20]gRPC服务器支持的最大并发数
          grpc_server_port[::]:8283[::]:portgRPC服务器监听的端口
          grpc_client_timeout5[2, 10]gRPC客户端最大超时时间

           

          第三步:工具的启动/停止

          • 启动zms-master:

          systemctl start zms-master

          • 启动zms-worker:

          systemctl start zms-worker

          • 关闭zms-master:

          systemctl stop zms-master

          • 关闭zms-worker:

          systemctl stop zms-worker

           

          部署实践

          场景一:单机部署

          前置准备:

          1. 在天翼云官网迁移服务代理列表界面创建半托管Agent,并获取注册码。

          1. 点击创建代理界面的“代理安装包下载”按钮下载半托管Agent安装包并解压。或通过命令下载:

            wget https://jiangsu-10.zos.ctyun.cn/bucket-zms/zms-agent/zms-agent-V1.0.0.zip

          1. 获取部署机器内网地址,用于zms-master与zms-worker通信。

          安装部署:

          1. 进入前置准备步骤二解压后的目录,执行install.sh脚本,选择zms-master、zms-worker两者都安装,并按需配置开启自启动。

          sh install.sh

          1. zms-worker服务启动。

          配置zms-worker配置文件(若无特殊需求则无需修改)。

          vi conf/worker_conf.ini

          启动zms-worker服务。

          systemctl restart zms-worker systemctl status zms-worker

          注意

          需要保证zms-worker服务启动端口(默认为8283)不冲突。

          1. zms-master服务启动。

          配置zms-master配置文件。

          vi conf/master_conf.ini

          必填项:

          register_code:前置准备步骤一中获取。

          master_addr:前置准备步骤三中获取,格式为ip:port。

          worker_addrs:前置准备步骤三中获取,格式为ip:port。

          启动zms-master服务。

          systemctl restart zms-master systemctl status zms-master

          注意

          需要保证zms-master服务启动端口(默认为8282)不冲突;若zms-master或zms-worker启动端口更改,zms-master配置文件中[host]标签下master_addr或worker_addrs中的端口也需同步更改。

           

          后置检查:

          1. 前往天翼云官网迁移服务代理列表界面查看半托管Agent状态。

          注意

          状态同步需要1-2分钟时间,若长时间后半托管Agent状态仍不可用,请先检查:a.部署机器可联通公网;b.zms-master服务启动成功后,联系天翼云技术人员处理。

           

          场景二:分布式部署

          前置准备:

          1. 在天翼云官网迁移服务代理列表界面创建半托管Agent,并获取注册码。

          1. 点击创建代理界面的“代理安装包下载”按钮下载半托管Agent安装包并解压。或通过命令下载:

            wget https://jiangsu-10.zos.ctyun.cn/bucket-zms/zms-agent/zms-agent-V1.0.0.zip

          1. 获取多台部署机器内网地址(以两台为例),用于zms-master与zms-worker通信。

          注意

          若多台机器内网不互通,也可以使用公网地址。

           

          从节点安装部署(仅zms-worker,可多个):

          1. 进入前置准备步骤二解压后的目录,执行install.sh脚本,选择仅安装zms-worker,并按需配置开启自启动。

          sh install.sh

          1. zms-worker服务启动。

          配置zms-worker配置文件(若无特殊需求则无需修改)。

          vi conf/worker_conf.ini

          启动zms-worker服务。

          systemctl restart zms-worker systemctl status zms-worker

          注意

          需要保证zms-worker服务启动端口(默认为8283)不冲突。

           

          主节点安装部署(同时安装zms-master与zms-worker,仅单个):

          注意

          主节点可同时安装zms-master与zms-worker,也可只安装zms-master。

          1. 进入前置准备步骤二解压后的目录,执行install.sh脚本,选择zms-master、zms-worker两者都安装,并按需配置开启自启动。

          sh install.sh

          1. zms-worker服务启动。

          配置zms-worker配置文件(若无特殊需求则无需修改)。

          vi conf/worker_conf.ini

          启动zms-worker服务。

          systemctl restart zms-worker systemctl status zms-worker

          注意

          需要保证zms-worker服务启动端口(默认为8283)不冲突。

          1. zms-master服务启动。

          配置zms-master配置文件。

          vi conf/master_conf.ini

          必填项:

          register_code:前置准备步骤一中获取。

          master_addr:前置准备步骤三中获取,格式为ip:port。

          worker_addrs:前置准备步骤三中获取,格式为ip:port,多个worker地址之间使用英文逗号分隔。

          启动zms-master服务。

          systemctl restart zms-master systemctl status zms-master

          注意

          需要保证zms-master服务启动端口(默认为8282)不冲突;若zms-master或zms-worker启动端口更改,zms-master配置文件中[host]标签下master_addr或worker_addrs中的端口也需同步更改。

           

          后置检查:

          1. 前往天翼云官网迁移服务代理列表界面查看半托管Agent状态。

          注意

          状态同步需要1-2分钟时间,若长时间后半托管Agent状态仍不可用,请先检查a.部署zms-master服务的机器可联通公网;b.zms-master服务启动成功后,联系天翼云技术人员处理。

           

          代理的卸载

          卸载:在部署zms-master或zms-worker的机器上执行uninstall.sh脚本即可。

          sh uninstall.sh

          注意

          若不选择删除历史数据,zms-master与zms-worker重新安装启动后,还可以继续连接控制台上上次连接的Agent;若选择删除历史数据,则不能重新连接上次Agent,但可以填写新的注册码,连接新的Agent。

           

          代理的扩容、缩容和替换主节点

          worker节点的扩容与缩容

          前置准备:

          1. 您已部署master节点,目的是新增worker节点或减少worker节点。

          2. 若需扩容请准备一台新的机器,部署并启动zms-worker服务(参考分布式部署小节中从节点安装部署步骤)。

          注意

          若需扩容多台机器,建议按照操作步骤一次对每台机器进行部署。

          1. 确定新机器内网ip

          1. 已部署半托管Agent,存在两个worker节点10.0.0.15、10.0.0.16。

          1. 已部署半托管Agent上执行任务暂停。

          注意

          若不手动暂停执行中的任务,zms-master节点重启后,执行中的任务状态将自动变为暂停。

           

          worker节点扩容

          1. 修改zms-master配置文件

          vi conf/master_conf.ini

          修改worker_addrs字段,添加新节点10.0.0.16,多个节点之间以英文逗号分隔。

          1. 重启zms-master服务

          systemctl restart zms-master 

          systemctl status zms-master

          1. worker节点扩容完成。

           

           

          worker节点缩容

          1. 修改zms-master配置文件

          vi conf/master_conf.ini

          修改worker_addrs字段,删除节点10.0.0.16。

          1. 重启zms-master服务

          systemctl restart zms-master systemctl status zms-master

          1. worker节点缩容完成。

           

          后置检查:

          1. 前往天翼云官网迁移服务代理列表界面查看半托管Agent下worker数量。

          注意

          状态同步需要1-2分钟时间,若长时间后半托管Agent下worker数量仍未更新,请联系天翼云技术人员处理。

          1. 恢复已暂停的任务。

           

          如何将旧master节点注册到控制台的新代理

          前置准备

          1. 您已经部署有旧的master节点和worker节点,您想将该节点全部注册到控制台新创建的代理上,则您只需将旧的master节点注册到新代理即可。

          2. 在天翼云官网迁移服务代理列表界面创建新的半托管Agent,并获取注册码。

           

          Agent替换

          注意

          只需要操作主节点即可,从节点无需执行操作。

          1. 已部署Agent主节点卸载

          sh uninstall.sh

          在主节点机器上执行命令卸载已部署Agent,需要选择清除运行数据。

          1. 修改zms-master配置文件,填写新Agent的注册码。

          vi conf/master_conf.ini

          1. 重新安装主节点

          sh install.sh

          在主节点机器上执行命令重新安装Agent,按需选择只安装zms-master服务或两者都安装。

          1. 启动zms-master服务

          systemctl restart zms-master systemctl status zms-master

          注意

          若同时安装了zms-worker服务,则也需要启动zms-worker服务。

           

          后置检查:

          1. 前往天翼云官网迁移服务代理列表界面查看替换的半托管Agent状态。

          注意

          状态同步需要1-2分钟时间,若长时间后半托管Agent状态仍不可用,请先检查a.部署zms-master服务的机器可联通公网;b.zms-master服务启动成功后,联系天翼云技术人员处理。

           

          代理的限制与约束

          额度限制

          1. 代理的任务数量限制:每个代理上最多可以下发50个迁移任务,超过限额请新建代理或删除不需要的任务后,再下发新任务。

          2. 代理的并发任务数量限制:每个代理最多可同时执行12个迁移任务(zms-master服务配置文件中修改),超过限制的任务将会排队。

           

          使用限制

          1. 工作节点数量:建议单个迁移集群内worker节点的数量不超过10个为最佳。

          2. 失败对象列表文件的存放限制:失败对象列表文件最多存放10万个失败对象,但任务重试可重试所有失败对象。例如:您本次任务有失败对象12万个,您在失败对象列表文件中只能查询到10万个失败对象,但您对该任务进行失败重试,迁移任务会重试迁移失败的全部12万个对象。

          3. 运行代理的资源占用:代理执行迁移任务时,会占用部署机器的CPU、内存、网络带宽等资源,请确保部署机器上没有您的其他业务系统,避免影响业务。

           

          注意事项

          1. zms-master服务第一次启动时必须在配置文件中填写注册码,后续填不填均可。

          2. 半托管Agent服务启动后,ZMS服务的控制台需要1-2min时间才能同步状态,您可以在“对象存储迁移-迁移任务-代理列表”中查看已部署代理的状态。

          3. 修改半托管Agent服务配置文件后,需要重启对应的服务,配置才能生效。

          4. 若代理某个工作节点始终处于“错误”状态,请按如下步骤排查:

            1. 检查该节点zms-worker服务状态

            2. 检查该节点与zms-master服务节点网络联通性(注意是否有安全组、防火墙阻止相关端口访问)

          5. 为了防止非预期的任务自动执行,zms-master服务重启后,该半托管Agent上所有正在执行的任务状态(包含:“排队中”、“迁移中”)都会被置为 “暂停” 状态。

          6. 任务状态变为 “任务结束 | 存在失败对象” 后,失败对象列表的文件上传到目的桶中需要一定耗时。若长时间后目的桶中仍没有失败对象列表的文件,可能有如下两种情况:

            1. 生成成功但上传失败:失败列表文件可以在代理的zms-master服务节点安装目录ZMS-failed-files文件夹下找到;

            2. 生成失败:本地与目的桶均没有该任务的失败列表文件。

          无论何种情况,该任务均可重试,重试仅上传上次执行失败的对象。

          1. 请勿随意删除zms-agent安装目录下的文件,否则可能造成该代理不可用。

          2. 若出现zms-master服务启动失败,报错为网络问题造成的 “Error when starting ZMS_Master: Connect to RabbitMQ failed.”,可稍等两分钟后进行重新启动,若长时间后重启仍失败,请联系天翼云技术人员处理。

          3. 若出现zms-worker服务长时间占用内存过高的情况,可以通过重启zms-worker服务解决。

          4. 迁移服务传输信息都会进行加密处理,但为了避免其他人伪造您的Agent登录造成信息被恶意盗用的情况,每次下发任务前,请确保您自己部署的Agent在正常运行。

          5. 运行日志:代理运行日志保存在安装目录log文件夹下,联系天翼云技术人员处理问题时请提供该目录。

          6. 部署代理节点时,请务必正确配置 master_addr 与 work_addrs 两个核心参数,参数配置错误将直接导致 zms-master 与 zms-worker 间的通信链路异常,进而影响整个集群的正常运行。若 work_addrs 参数配置有误,zms-worker 节点将无法与主节点 zms-master 建立连接,导致主从节点通信彻底中断;若 master_addr 参数配置错误,即使 zms-worker 节点完成数据迁移任务,也无法向主节点上报任务的实际执行状态,造成任务状态丢失或同步异常。

           

          文档反馈

          建议您登录后反馈,可在建议与反馈里查看问题处理进度

          鼠标选中文档,精准反馈问题

          选中存在疑惑的内容,即可快速反馈问题,我们会跟进处理

          知道了

          上一篇 :  使用控制台创建代理
          下一篇 :  使用控制台管理已部署的代理
          搜索 关闭
          ©2026 天翼云科技有限公司版权所有 增值电信业务经营许可证A2.B1.B2-20090001
          公司地址:北京市东城区青龙胡同甲1号、3号2幢2层205-32室
          备案 京公网安备11010802043424号 京ICP备 2021034386号
          ©2026天翼云科技有限公司版权所有
          京ICP备 2021034386号
          备案 京公网安备11010802043424号
          增值电信业务经营许可证A2.B1.B2-20090001
          用户协议 隐私政策 法律声明