CoMi V2.0.2智能部署工具安装升级手册

北京致远互联软件股份有限公司

2026年2月

前言

本手册就CoMi V2.0、V2.0.1、V2.0.2 版本智能部署工具安装升级提供详细说明，如对本手册中相关内容存在疑问，请与致远互联的客户服务人员联系。

CoMi智能部署工具（以下简称“部署工具”）支持将 CoMi核心服务部署至 Linux 或信创系统服务器 ，支持将CoMi V2.0 Linux/信创老版本升级到当前版本。该工具采用B/S架构，您只需在一台部署服务器（或堡垒机）上启动本工具，即可通过浏览器访问其Web界面，以向导式流程完成所有目标服务器的部署与配置。部署后CoMi服务启停、网络互通检查、CoMi日志提取均可通过Web界面可视化操作。

部署视频： CoMi V2.0使用智能部署工具部署视频可访问 协同云-赋能中心-致远学院-搜索“CoMi V2.0使用智能工具部署演示 (opens new window)”

修订记录

修订内容	修订时间
CoMi 2.0.2界面优化：CoMi初始化页面交互优化	2026-2-2
CoMi 2.0.2功能完善：CoMi Nginx配置自动写入	2026-2-2
CoMi 2.0.2新增服务：CoMi文件解析服务部署	2026-2-2
CoMi 2.0.2新增服务：CoMi沙箱服务部署	2026-2-2
CoMi 2.0.2功能完善：支持服务可视化卸载	2026-2-2
新增 CoMi V2.0升级CoMi V2.0.1操作步骤	2025-12-19
CoMi V2.0.1功能完善：支持修改CoMi连接的Nginx内网地址	2025-12-17
CoMi V2.0.1功能完善：增加工具登录密码重置功能	2025-12-17
CoMi V2.0.1安全完善：工具首次登录需要设置密码	2025-12-17
CoMi V2.0工具部署原始版	2025-11-10

部署工具适配说明

部署工具能力

场景	支持情况
CoMi V2.0.2全新安装	支持
CoMi V2.0、V2.0.1升级到CoMi V2.0.2	支持，参考[升级章节]

注意：

• 如原CoMi V1.1没有特殊数据需要保留，建议直接卸载CoMi V1.1，采用全新安装模式，可提高部署效率

部署维护范围

CoMi V2.0系列智能部署工具支持部署维护范围：

服务	部署工具支持情况	备注
AI-Manager	支持	CoMi基础服务，必须部署，需要一个关系型数据库存储数据
AI-Engine	支持	CoMi基础服务，必须部署
AI-Security	支持	CoMi基础服务，按需部署
Qdrant	支持	CoMi向量数据库，必须部署
CoMi Server	支持	CoMi UI和APP服务，v2.0.2开始要求必须部署，需要一个关系型数据库存储数据
AI-DocumentParse	支持	CoMi文件解析服务，v2.0.2新增，必须部署在AI-Manager服务器上
comi deno沙箱	支持	CoMi沙箱服务，v2.0.2新增，必须部署在AI-Engine服务器上
关系型数据库	不支持	必须部署，可复用协同数据库服务资源（新建空库给CoMi）
协同驾驶舱高级版	支持	智能问数BI，按需部署，需要PG数据库做数仓
协同驾驶舱高级版数仓	不支持	智能问数BI依赖数仓，需要提前部署，默认推荐《部署PostgreSQL (opens new window)》
Nginx	不支持	必须部署，需自行部署，详见后续章节
全文检索	不支持	协同知识问答场景需要，需自行部署，见《全文检索部署维护手册V10.SP1 (opens new window)》
协同	不支持	需自行部署
大模型	不支持	CoMi依赖模型，需由客户提供，详见《CoMi V2.0环境准备指导手册 (opens new window)》
OCR图片识别	不支持	OCR环境要求苛刻，需由客户提供GPU环境，详见《OCR图片理解模型Docker部署手册 (opens new window)》

注意：

• 本部署工具暂不支持如下服务的自动安装：协同全文检索ElasticSearch、Nginx、CoMi数据库、BI数仓，相关服务需要参考对应部署手册自行安装准备。
• CoMi V2.0部署架构图、服务器环境资源要求（配置要求）、插件准备要求、支持协同清单、大模型准备要求等详见 《CoMi V2.0环境准备指导手册 (opens new window)》，请先完成环境准备再进行本手册部署！

操作系统支持

CoMi V2.0部署工具系列服务支持如下操作系统：

分类	支持情况
权限要求	需要以管理员（root）权限操作
支持操作系统	CentOS 7、CentOS 8 RedHat 7、RedHat 8 openEuler 24.03-LTS Anolis 8.10 Ubuntu 22.04 LTS 麒麟V10 统信UOS V20
服务器类型	x86、Arm
其它说明	要求部署工具所在服务器和CoMi相关服务器都必须是支持范围内的操作系统

注意：

• 部署工具不支持Windows系统， 如无特殊要求，不建议使用Windows系统部署CoMi：没有部署工具、部署繁琐、易出错！

商务插件准备

使用CoMi，需要从致远商务侧申请更新协同加密狗授权文件（*.seeyonkey），申请到对应授权才能在协同中配置使用CoMi，详细插件要求见《CoMi V2.0环境准备指导手册 (opens new window)》-商务插件和功能对照章节。

适配协同版本

CoMi 2.0系列（V2.0、V2.0.1、V2.02）标准产品随协同V10.0SP1版本匹配发布，即标准支持V10.0SP1版本。

同时也提供了部分协同低版本适配，CoMi 2.0对V5产品线早期版本适配列表详见《协同版本边界feishu知识库 (opens new window)》；早期版本的适配补丁包详见CoMi安装包里的协同OA低版本补丁，协同侧需按要求打补丁。

依赖环境准备

操作系统环境准备（必须）

在进行安装部署前，先按照如下配置优化Linux、信创相关系统参数（所有CoMi服务、包含智能部署工具所在服务器都要执行）：

预装部署所需的命令：

# Red Hat系列，使用yum命令安装，如当前系统提示yum不可用，则尝试使用apt
yum update -y
yum install tar curl net-tools unzip vim telnet rsync nc -y

# 基于Debian的系统（如Ubuntu）使用apt预装组件
sudo apt update -y
sudo apt install tar net-tools unzip vim telnet rsync netcat -y

# 基于欧拉openEuler、龙蜥Anolis OS等系统使用dnf安装
sudo dnf update -y
sudo dnf install tar curl net-tools unzip vim telnet rsync nc -y

修改Linux内核参数：

# 编辑配置文件，并在文件末尾添加参数配置
vim /etc/sysctl.conf

net.ipv4.tcp_fin_timeout = 30
net.ipv4.tcp_keepalive_time = 1800
net.ipv4.tcp_window_scaling = 0
net.ipv4.tcp_sack = 0
net.ipv4.tcp_timestamps = 0

# 读取 /etc/sysctl.conf 文件中的设置，使其立即生效
sysctl -p

修改Linux最大进程数最大文件打开数：

通过 vim /etc/security/limits.conf 命令编辑此文件添加以下内容：

# RedHat系列、CentOS、欧拉、麒麟等大部分系统使用的配置====start
# open files  (-n)
* soft nofile 65535
* hard nofile 65535
# max user processes  (-u)
* soft nproc 65535
* hard nproc 65535
# RedHat系列、CentOS、欧拉、麒麟等大部分系统使用的配置====end


# 如Debian和Ubuntu系统使用root用户，还需添加如下配置====start
# open files  (-n)
root soft nofile 65535
root hard nofile 65535
# max user processes  (-u)
root soft nproc 65535
root hard nproc 65535
# 如Debian和Ubuntu系统使用root用户，还需添加如上配置====end

以上配置完成，重启操作系统，执行 ulimit -a 命令检查open files和max user processes是否都变成65535

部署前先关闭selinux：

# 执行如下命令永久关闭
sudo sed -i 's/^SELINUX=.*/SELINUX=disabled/' /etc/selinux/config
# 重启操作系统生效
sudo reboot

# 临时禁用（免重启），临时验证关闭效果可用此法，如果确认关闭有效，务必永久关闭
sudo setenforce 0

协同Nginx准备（必须）

在进行CoMi部署前，需要先提前部署配置Nginx，确保Nginx能代理协同OA服务，通过http访问Nginx服务能自动跳转到协同OA。如项目已经使用Nginx代理协同OA，可跳过本章节。

全新安装Nginx和配置强烈推荐参考如下方式（如参考如下手册配置，后续工具部署过程中可以自动写入comi相关配置）：

• Nginx服务安装位置根据项目实际情况规划，Nginx部署拓扑和推荐方案参考 《CoMi V2.0环境准备指导手册 (opens new window)》。

• Nginx需要在Linux或信创系统下部署运行

• Nginx服务部署强烈推荐参考《Nginx安装部署参考手册 (opens new window)》

• Nginx配置代理协同OA必须参考《Nginx反向代理和负载均衡协同HTTP (opens new window)》

请务必提前完成NG部署配置、并保证协同服务处于启动状态，后续CoMi部署需要检测NG连接状态。

CoMi数据库准备（必须）

在进行CoMi部署前，需要先提前准备一个关系型数据库服务，CoMi依赖数据库服务存储基本配置和使用记录等信息。

CoMi V2.0支持的数据库版本要求如下，不在版本范围的数据库不可用：

• mysql5.7、mysql8.0 （mysql都用utf8-mb4字符集）
• 达梦8.4
• 人大金仓（电科金仓）V8R6（Oracle兼容模式）
• postgreSQL 13.3
• sqlServer 2019
• oracle 19c（其它Oracle版本不支持）

数据库参数配置兼容要求与协同OA一致，故可以复用协同OA数据库服务（新建单独的comi数据库空间）。

如不涉及信创合规性，也推荐快速部署MySQL，实现comi单独数据库维护：

• MySQL8.0数据库安装参考手册Linux (opens new window)
• MySQL8.0数据库安装参考手册Windows (opens new window)

数据库服务准备之后，至少需要新建两个空库分别给ai-manager、comi-server服务使用，命名自定义：比如ai_manager库给AI-Manager服务使用，comi_server给CoMiServer服务使用，CoMi部署工具运行过程中会连接数据库，并自动初始化数据：

大模型提前准备

必须提前准备：LLM和Embedding模型，在部署过程中需要配置模型信息！

关于CoMi V2.0依赖的大模型和推荐，参考《CoMi V2.0环境准备指导手册 (opens new window)》。

安装包准备（必须）

CoMi智能部署工具从商务公布的安装程序地址下载（文档中心-文档库-营销中心-营销体系销售管理知识库-产品下载地址-提交给区域产品下载地址xxx.xls），产品线对应AI：

注意：CoMi智能部署工具部署包 和 CoMi相关服务部署包 是两个文件夹，项目上需要根据自身环境情况下载两个文件夹的部署包。

CoMi智能部署工具部署包：

CoMi相关服务部署包：

部分服务按照CPU架构和操作系统拆分成多个包，如果X86架构操作系统无匹配的安装包，则默认取centos8尝试：

部署工具安装和访问

部署工具运行架构图

整个部署组成元素分为 ：用户PC操作终端机器，安装部署工具服务机器，部署CoMi目标机器 三部分。

操作流程：用户在PC终端上，浏览器访问部署工具服务Web可视化页面，可视化选择对应的部署目标机器，上传安装包，配置服务参数 ，安装部署到对应的目标机器上。

部署工具网络要求：

• 确保部署工具能SSH到CoMi和NG服务器
• 确保至少一台PC终端能HTTP访问到部署工具服务

部署工具部署位置根据项目情况规划，以下整理几个典型场景的规划：

• 如客户单台服务器资源足够大，CoMi及BI相关服务都计划部署在这台服务器，则可以将部署工具也上传部署在这个服务器 或 其它同局域网服务器
• 如客户服务器较多，CoMi基础服务、BI、CoMi Server（APP服务）计划分离部署，则可以将部署工具上传部署在任意一台上面 或 其它同局域网的服务器

部署工具安装和运行

1、根据服务器架构选择合适的安装包，将部署工具安装包上传到提前规划好的服务器：

• x86服务器下载：Deployer-Tools-v2.0.2-linux-x86_64.zip

• arm服务器下载：Deployer-Tools-v2.0.2-linux-arm_64.zip

2、解压部署工具到目标目录：

# 创建工具存放目录
mkdir -p /data/comi-deployer-tools
# 将上传的zip包解压到工具存放目录（示例为X86工具包）
unzip Deployer-Tools-v2.0.2-linux-x86_64.zip -d /data/comi-deployer-tools/
# 检查解压后的目录文件是否存在（示例为X86工具包）
cd /data/comi-deployer-tools/Deployer-Tools-v2.0.2-linux-x86_64/
ls

3、部署工具端口调整（按需）：工具默认端口9526，可修改startup.sh文件按需调整端口。

vim startup.sh

4、启动部署工具：运行startup.sh脚本启动，启动会输出运行端口及日志文件位置，可实时查看日志文件信息。

# 启动工具
bash startup.sh
# 启动后等待30秒，netstate检查工具端口是否存活，存活则表示正常
netstat -ntlp | grep 9526
# 根据日志文件输出信息，实时查看日志运行情况（示例为X86工具包）
tail -f /data/comi-deployer-tools/Deployer-Tools-v2.0.2-linux-x86_64/logs/output.log

5、PC客户端通过浏览器访问 http://部署工具IP:端口（默认9526） ，如显示出CoMi智能部署工作台则表示启动成功。

如无法访问，则考虑部署工具服务器防火墙是否未放开端口（如默认9526）访问权限。注：自CoMi V2.0.1版本开始，智能部署工具首次登录需要设置密码（密码至少8位，且包含字母、数字、特殊字符中至少两种），请妥善保存密码，方便后期维护！如密码遗失，见后续日常维护-重置登录密码章节。

6、CoMi智能部署工作台运行成功后，按照后续章节进行CoMi服务的部署。以后服务的配置、启停均通过这个地址进行维护。

部署工具安装CoMi步骤

一、新建环境项目

1、点击 [新建环境项目] ，根据当前环境作用自定义一个清晰明了的环境项目名称：

2、在主机管理与链接卡片中，点击 [添加新主机] ，必须添加CoMi服务器、建议添加Nginx服务器信息，如果计划将智能问数BI或CoMi Server与CoMi分离部署，则还需要将分离部署服务器添加进主机列表。

在弹出的“主机维护”窗口中，需要准确填写主机信息：

• 主机别名： 自定义，填写清晰明确的名称方便识别
• IP地址：目标服务器局域网IP地址
• SSH端口、用户名、认证方式（支持密码认证或密钥认证）、密码：按需准确配置，需要确保当前部署工具服务器能通过SSH连接到目标服务器

配置完成后，点击 [测试并添加] ，工具将自动验证SSH连接，成功后主机会被添加至列表 。

如测试提示“连接测试失败，请检查用户名、密码等信息是否正常”，重点检查如下信息：

• 检查目标服务器的SSH IP端口是否能访问，可通过telnet命令测试，示例如telnet 192.168.188.170 22，如不通，尝试检查IP端口正确性和目标服务器防火墙等安全策略
• 检查目标服务器SSH帐号密码是否正确，可通过其它SSH连接工具等方法验证

二、上传解析CoMi部署包

完成上一步主机管理后，开始进行CoMi部署包准备与规划。

指定部署包： 按照“安装包准备”章节下载与系统相匹配的CoMi系列服务部署包，然后上传到部署工具服务器，由部署工具自动解析CoMi部署包。

产品提供了两种部署包上传解析方式：[本地上传部署包自动解析] 和 [输入服务器部署包路径自动解析]

方式一：本地上传部署包：

本地电脑新建一个文件夹（例如 comi-v2.0-packages），将所有下载好的CoMi系列部署包 .zip文件直接放入此文件夹内（不要解压）。然后，将这个 comi-v2.0-packages 文件夹整体压缩成一个 .zip 文件（例如 comi-v2.0-packages.zip）。

基于CoMi V2.0.2版本X86架构，最终您准备好的文件夹结构应如下所示：

- comi-v2.0.2-packages.zip
  |- AI-DocumentParse_centos8-x86_64.zip
  |- AI-Engine_centos8-x86_64.zip
  |- AI-Manager-linux-x86_64.zip
  |- comi-deno-x86.zip
  |- AI-Security_centos8-x86_64.zip
  |- Comi-Server-linux-x86_64.zip
  |- Qdrant_1.13.6_linux-x86_64.zip
  |- seeyon-datapulse-linux-x86_64.zip

点击上传区域，选择您已准备好的、包含所有服务安装包的部署压缩包（例如 comi-v2.0-packages.zip），工具将自动上传 。

方式二：输入服务器部署包路径：如果您已将包含CoMi系列部署包 .zip文件提前上传至部署工具所在的服务器指定目录，可选择此项并填入zip文件目录绝对路径，直接解析目录文件。

以上方式二选一，确保最终解析出服务器环境规划表为止，以下为CoMi V2.0.2版本的服务列表截图：

三、配置CoMi核心服务

CoMi核心服务配置流程

按需配置需要部署的服务：

1、对于每个已勾选的服务，依次设定服务的目标主机，点击其操作列的 [配置] 按钮，会弹出一个该服务专属的配置窗口

2、在弹出的配置窗口中，根据界面提示和本手册 [CoMi核心服务详细配置说明] 的指引，填写所有必填参数

3、完成一个服务的配置后，点击 [确定] 保存配置，改服务状态会变为 [待校验]

4、在 [外部依赖与集成配置] 版块配置好Nginx服务器主机和Nginx的配置文件目录

5、当所有需要部署的服务的参数都填写完毕后，点击服务列表左下角的 [一键配置校验] 按钮

6、工具将对所有配置进行校验。校验成功后，所有已勾选服务的“状态”列将变为绿色的 [已校验]，此时您才可以进入下一个部署阶段

完成所有服务的参数配置后，点击页面左下角的 [一键配置校验] 按钮 。

工具将对所有配置进行校验。校验成功后，所有已勾选服务的“状态”列将变为绿色的 [已校验] 。

注意：如果校验失败，状态将变为“校验失败”，会弹出提示具体错误原因，请根据提示修正后重新校验 。

一键配置校验通过后点击下一步： 下一步按钮在底部右下角。

CoMi核心服务详细配置说明

Qdrant向量数据库配置

Qdrant 是存储知识库向量数据的核心组件，安装 CoMi V2.0时必选。

配置说明：

• 通常情况下，保持默认配置即可。除非目标服务器上的端口已被占用，或您有特定的部署路径规划，否则建议您无需修改。

• 部署模式（CoMi V2.0.2+已经删除）：

  • 重新安装（默认）： 部署全新的 Qdrant 服务
  • 跳过安装使用现有实例： 连接已安装的 Qdrant 服务并保留数据（需确保 IP 和端口配置正确），在预检查页面会检查端口占用，这时候需要把已有的qdrant停止后再检查，检查通过后在启动然后进入下一步开始部署

• 目标主机：指定把Qdrant服务安装到哪一个服务器上，下拉列表数据关联**主机管理与连接**中添加的主机

• HTTP运行端口：默认为 6333。AI-Engine访问qdrant需要使用此端口

• GRPC运行端口：默认为 6334。AI-Manager访问qdrant需要使用此端口

• 部署路径：服务在目标服务器上的安装目录，默认为 /data/Seeyon/Comi/qdrant ，建议保持默认。

AI-Manager管理后台服务配置

AI-Manager 是 CoMi 平台的核心管理后台，配置项较多，重点关注标*必填项。

配置说明：

• 基础信息

  • 目标主机： 指定 AI-Manager 服务的部署目标服务器。
  • 运行端口： 默认 8181，用于对外提供管理接口服务。
  • 部署路径： 默认路径为 /data/Seeyon/Comi/ai-manager ，建议保持默认，用于存放程序包、日志及配置文件。
  • 产品线： 根据实际协同 OA 版本选择 A6、A8/A8N、G6/G6N 或 A9（云原生产品线），该项决定初始化 SQL 脚本及预置智能体模板的加载路径。
  • 当前CoMi版本：新客户无需选择。如果是CoMi V1.1升级场景需要选择1.1，工具会执行从1.1到2.0的升级SQL。
  • 同时向量化批次数量： Since CoMi V2.0.1新配置，设置批量调用Embedding模型数量，本地化模型保持默认50，如使用阿里云text-embedding这类限流模型，需要改成10。

• 数据库配置

  • AI-Manager 依赖独立数据库，新建一个空库，确保数据库服务处于可使用状态。详细要求见 【CoMi数据库准备】 章节。
  • 数据库类型： 下拉框选择你的数据库，注意数据库有版本要求，详细要求见 【CoMi数据库准备】 章节。
  • JDBC URL： 工具会自动生成JDBC URL模板。请 手动修改 模板中的变量为实际信息 ${ip}对应<主机IP>, ${port}对应<端口>, ${database}对应<数据库名>
  • 用户名、密码: 在用户名和密码框中，输入数据库的登录信息。 （注意：此账号需有建表权限）
  • 测试连接： 务必点击 [点击按钮进行测试] 。只有测试成功后，才能继续下一步。
  • 【重要提示 - 升级与重试场景】: 如果您正在执行 旧版本升级 ，请先备份原数据库。若后续部署过程失败，请恢复备份后再重新部署，避免在已被修改的数据库上继续操作导致错误。

# 达梦连接url（示例）
jdbc:dm://10.3.4.206:5236/AIMANAGER

# 人大金仓连接url（示例）：
jdbc:kingbase8://10.3.4.192:54321/AIMANAGER?clientEncoding=UTF-8

# Mysql连接url（示例）
jdbc:mysql://192.168.188.169:3306/ai_manager

# Oracle连接url（示例）
jdbc:oracle:thin:@127.0.0.1:1521:ai_manager

# SQLServer连接url（示例）
jdbc:sqlserver://127.0.0.1:1433;DatabaseName=ai_manager;maxStatements=0;SelectMethod=cursor;encrypt=false;trustServerCertificate=true

# Postgresql连接url（示例）
jdbc:postgresql://127.0.0.1:5432/ai_manager

• 集成配置

  • 协同 OA 的反向代理地址： 必填项，填写 Nginx 反向代理协同 OA 的完整内网访问地址（通过NG能访问协同的http地址），示例如 http://192.168.188.168:80，该地址用于回调与授权验证。
  • AI-Engine 服务地址： 集中部署保持默认值， ws://[AI-Engine主机IP]:8000，由部署规划自动填充，AI-Manager 通过此地址与引擎服务通信。
  • AI-Security 服务地址： 集中部署保持默认值， ws://[AI-Security主机IP]:9000，为可选项，由部署规划自动填充，用于敏感词检测服务调用。
  • 向量库主机与 gRPC 端口： 会关联 Qdrant 服务配置自动填充，默认端口为 6334，AI-Manager 通过该端口与 Qdrant 建立 gRPC 连接。
  • OA OCR 服务地址与 V8 OCR 服务地址： 为选填项，分别用于文本识别扩展，未部署OCR可保持默认值。

• 存储与文件路径

  • 日志存储路径： 默认位于部署路径下的 logs 目录，用于保存运行日志；自动生成，无需手动修改
  • 文件临时存储路径： 为部署路径下的 temp 目录，用于缓存临时文件；自动生成，无需手动修改
  • 静态资源路径： 默认指向 frontend 与 static 目录，用于存放前端页面与静态文件；自动生成，无需手动修改。

AI-Engine智能引擎配置

AI-Engine 是执行Agent智能体语义理解和逻辑调度的核心Python服务。

配置说明：

• 基础信息
  • 目标主机: 指定服务部署的目标服务器。必填，升级时不可修改。
  • 运行端口: 服务监听端口，默认 8000。必填，升级时不可修改。
  • 是否开启沙箱（CoMi v2.0.2新增）： 默认开启，需要使用工具同步部署comi-deno沙箱服务。
  • 部署路径: 服务安装目录，默认 /data/Seeyon/Comi/ai-engine ，建议保持默认。必填，升级时不可修改。
• 集成配置
  • 向量库URL: Qdrant 的 HTTP 地址。根据 Qdrant 配置自动生成，只读。
  • AI Manager 服务地址（CoMi v2.0.2已删除）: AI-Manager 的访问地址。根据 AI-Manager 配置自动生成，只读。
  • 向量模型标识（CoMi v2.0.2已删除）: Embedding 模型标识，必填，建议临时填写成客户Embedding模型的model名称。此标识在本次部署 AI-Engine 时预先定义。部署完成后，在 CoMi Builder 后台【模型】页面创建或配置 Embedding 模型时，【模型标识】字段必须输入与此处完全相同的值，以确保 AI-Engine 能正确关联并使用该模型，否则可能导致连接失败。
  • 向量维度（CoMi v2.0.2已删除）: Embedding 模型输出维度，默认 1024。需与客户使用的模型实际维度匹配，范围 256-2048，必填。
• 存储/文件路径
  • 日志路径: 存放运行日志的目录。根据部署路径自动生成，默认为 ${ai-engine.basic.deployment_path}/logs。只读。
  • 临时数据路径: 存放临时数据或文件的目录。根据部署路径自动生成，默认为 ${ai-engine.basic.deployment_path}/data。只读。
• 安全与认证
  • AI Manager API KEY: 此 Key 用于 AI-Engine 与 AI-Manager 之间的安全通信。在首次部署时，您无需填写此项，部署工具将自动生成并配置到 AI-Manager服务中。 您将在部署完成后的报告或指引中获取此 Key，用于配置协同 OA 平台。

AI-Security安全服务配置

AI-Security 是负责敏感词检测等安全策略的组件，为可选部署项。

配置说明：

• 目标主机：已自动选择，无需修改。
• 运行端口：默认为 9000。
• 部署路径：默认为 /data/Seeyon/Comi/ai-security ，建议保持默认。
• 日志路径：默认为 logs，即部署路径下的 logs 文件夹。通常保持默认配置即可，如遇端口冲突或路径问题再行调整 。

CoMi Server服务配置

CoMi 移动端服务，为App和 PC门户提供数据接口服务。如果需使用 CoMi 独立的移动端 APP，则必须部署此服务。

• 配置说明
  • 基础信息：
    • 目标主机：指定 CoMi Server 服务部署的目标服务器。必填，升级时不可修改。
    • 运行端口：服务监听端口，默认 8081。必填，升级时不可修改，取值范围 1024-65535。
    • 部署路径：服务安装目录，默认 /data/Seeyon/Comi/comi-server ，建议保持默认。必填，升级时不可修改。
• 数据库配置
  • **数据库类型：**下拉框选择你的数据库（目前支持的数据库类型有 MySQL 5.7或8.0、PostgreSQL 13.3+、Oracle 19c（其它不支持）、SqlServer 2019、达梦8.4、人大金仓V8（Oracle兼容））。
  • JDBC URL：工具会自动生成 JDBC URL 模板。请手动修改模板中的 ${ip}:<主机IP>, ${port}:<端口>, ${database}:<数据库名> 为你的实际数据库信息。
  • 用户名、密码: 在 用户名 和 密码 框中，输入数据库的登录信息。（注意：此账号需有建表权限）
  • 测试连接：务必点击 [点击按钮进行测试]。只有测试成功后，才能继续下一步。
  • 【重要提示 - 升级与重试场景】:
    • 如果您正在执行旧版本升级，请先备份原数据库。若后续部署过程失败，请恢复备份后再重新部署，避免在已被修改的数据库上继续操作导致错误。
• 集成配置
  • 协同OA反向代理地址：填写 Nginx 反向代理协同 OA 的完整内网访问地址（通过NG能访问协同的http地址）。必填，需填写完整 URL，例如 http://[nginx主机IP]:[nginx端口]。
  • AI Manager 服务地址：AI-Manager 的访问地址。由系统根据 AI-Manager 配置自动生成，仅供查看。只读。
• 安全与认证
  • 系统管理员-信息集成配置-三方互信访问权限修改（Comi一键登录）三方互信账号，用于CoMi App 的一键登录
  • 回调地址：http://comi服务器ip:8081/comi/relation/callBack
  • 绑定IP：comi服务器ip
  • 填写完成后复制ID和密钥填写到工具中
  • 三方互信ID：系统间通信的唯一标识，通过OA系统管理员-信息集成配置-三方互信访问授权中创建（参考下方图例）。必填。
  • 三方互信密钥：对应的安全密钥，通过OA系统管理员-信息集成配置-三方互信访问授权中创建（参考下方图例）。必填。
  • API KEY：AI-Manager 为 CoMi Server 分配的通信密钥，由部署工具自动注入。只读。
• 存储与文件路径
  • 日志存储路径：运行日志目录。自动根据部署路径生成，默认为 ${comi-server.basic.deployment_path}/logs。只读。
  • 文件上传路径：文件存储目录。自动根据部署路径生成，默认为 ${comi-server.basic.deployment_path}/uploads。只读。
• 腾讯语音识别配置（可选）
  • App ID / Secret Id / Secret Key：腾讯云语音识别服务凭证。需在腾讯云控制台申请后填写。
• 一键登录配置（可选）
  • iOS 配置：包含 App ID、App Key、App Secret、Public Key、Private Key 等字段，需与苹果开发者控制台配置一致。
  • Android 配置：包含 App ID、App Key、App Secret、Public Key、Private Key 等字段，需与腾讯或运营商登录服务配置一致。
• 实时转录配置（可选）
  • App Key / Access Key / Access Key Secret：阿里云实时语音转录服务凭证，用于语音识别调用。

AI-document-parse文档解析服务

配置说明：

• 目标主机：选择文档解析服务的部署服务器，需要与AI-Manager部署在一起。
• 运行端口：默认为 9880。
• 部署路径：默认为 /data/Seeyon/Comi/ai-document-parse，建议保持默认。
• 日志路径：默认为 logs，即部署路径下的 logs 文件夹。通常保持默认配置即可，如遇端口冲突或路径问题再行调整 。

CoMi代码执行沙箱

配置说明：

• 目标主机：选择文档解析服务的部署服务器，需要与AI-Engine部署在一起。
• 运行端口：默认为 8877。
• 部署路径：默认为 /data/Seeyon/Comi/sandbox，建议保持默认。

协同驾驶舱 (智能问数 BI)配置

此服务为智能问数功能提供数据处理和报表能力，为可选部署项。

配置说明：

• 基础信息：
  • 目标主机：【必填】 选择需要部署到的目标主机
  • 运行端口 (8058)、部署路径 通常保持默认即可 。
• 集成配置：
  • 协同OA的反向代理地址： 【必填】 填写Nginx代理协同OA的完整访问地址，例如 http://10.2.4.51:8080 。

外部依赖与集成配置 (Nginx)

本配置仅适用于V5的Nginx配置！

在此卡片中，您需要为所有服务配置统一的反向代理入口。

配置说明：

• 自动注入配置（v2.0.2新增）： 默认开启，开启后工具会根据配置信息自动寻找NG配置，并写入CoMi相关配置。如果找寻不匹配，工具不会做任何操作。
• Nginx服务器主机： 从“Nginx服务器主机”的下拉框中，选择一台已添加的主机作为Nginx服务器。
• Nginx主配置文件路径： CoMi V2.0.2版本填写该服务器上维护协同OA的Nginx配置文件路径。CoMi早期版本填写conf目录的路径。
• 协同服务监听端口（v2.0.2新增）： 填写Nginx代理的端口，以便工具根据监听端口检查配置，提升自动注入准确率。

注：由工具自动写入Nginx配置功能自CoMi V2.0.2开始支持。CoMi V2.0.1及之前的工具没有那么多配置，只会自动生成一份 comi.conf 配置文件。

四、环境预检查

完成环境创建与规划后点击“下一步”按钮，进入环境预检查页面，工具将自动对所有目标服务器进行一次全面的环境“体检”，以提前发现潜在的部署风险。

注意：下一步按钮在页面底部右下角！

环境预检查功能说明：

• 自动检查：检查过程自动开始，界面上会以清单形式实时显示每个检查项的结果。
• 失败处理：若有检查项失败，请根据界面下方提供的解决方案建议进行修复，然后点击 [重新检查] 按钮，直至所有项都通过。
• 强制通过：必须所有检查项的状态都变为“通过”（“警告”项可忽略），底部的“下一步”按钮才会被激活。

如遇“未通过”选项，需要分析原因并解决，如“核心依赖命令检查”不通过，需要参考“操作系统环境配置调整”章节在CoMi所在服务器执行相关依赖组件命令安装。

如遇到“Nginx连通性检查失败”的问题，则重点检查：

• 协同OA处于启动状态：安装过程中需要确保协同服务处于运行状态
• Nginx是否正确代理OA：通过浏览器访问HTTP的Nginx，需要确保能看到协同的登录页
• 上一步在AI-Manager中配置的Nginx HTTP地址是否正确

如“CPU核数检查”或“空闲内存检查”存在警告，需要及时做评估调整：POC环境资源有限可忽略警告；生产环境必须按照推荐准备合适的配置，如忽略警告，后续系统性能风险由项目组承担。

修改上一页的配置信息，点击“上一步”，上一步按钮在页面底部的左下角。

环境预检查通过后，点击“下一步”，下一步按钮在页面底部右下角。

五、自动化执行部署

预检查通过后，即可进入全自动化的部署执行阶段。

1、点击 [开始部署环境] 按钮，工具将自动进行服务的部署：

2、监控进度：部署过程无需人工干预。您可以通过界面左侧的 “部署进度时间线” 了解当前所处的阶段，并通过右侧的 “实时日志” 监控详细的执行情况 。

由于不同系统兼容性问题，输出可能出现乱码，此问题可忽略：

3、完成 [阶段四：服务启动与验证] ，能看到“安装任务执行成功”字样则表示自动部署完成，点击底部右下角的“完成部署”按钮进入看版页面。

异常说明：如遇到自动部署异常，需要分析异常服务的日志并解决后再重试，相关日志从服务器上提取，如未修改程序，日志默认存放于：

• 部署工具日志默认存放于 /data/comi-deployer-tools/Deployer-Tools-v2.0.2-linux-x86_64/logs
• ai-engine日志默认存放于 /data/Seeyon/Comi/ai-engine/logs
• ai-manager日志默认存放于 /data/Seeyon/Comi/ai-manager/logs
• qdrant日志默认存放于 /data/Seeyon/Comi/qdrant/qdrant.log
• ai-security日志默认存放于 /data/Seeyon/Comi/ai-security/logs

六、检查自动部署服务状态

完成部署后，进入核心服务状态看版页面，确保所有服务处于运行中，并且关键连接状态正常。

至此工具自动化部署CoMi程序完成，下一步还需要参考后续章节进行其它重要配置！

在核心服务状态面板页面，可以点击“生成报告”下载部署报告，报告中还有后续重要配置的操作说明。

工具部署后其它重要配置

工具部署CoMi核心服务之后，还需要做其它重要配置，才能在协同中使用。

一、Nginx增加CoMi配置

1、到Nginx服务器，通过修改主配置文件 vim nginx.conf 增加comi相关配置，仅需增加两块内容：

• 增加upstream统一管理AI-Manager地址
• 在协同OA的server块中增加include comi.conf;配置，让comi代理配置全部由comi.conf文件维护；如部署了智能问数，还需要增加include bi.conf;配置。

注：配置方法可以参考生成报告中的说明：

关于comi.conf和bi.conf配置文件文件：无需手动创建，如配置无误，在工具部署过程中会自动创建相关文件。

项目上只需要增加 comi start 到 comi end 区间的内容：

# comi start：增加AI-Manager的upstream配置（必须）
upstream ai_manager{
    # 这里IP端口指向AI-manager地址
    server 192.168.188.170:8181;
}
# comi end：增加AI-Manager的upstream配置

# 代理协同OA
server {
    listen 80;
    server_name  localhost;
    charset utf-8;

    # comi start:关联comi配置文件（必须）
    include comi.conf;
    # comi end:关联comi配置文件

    location / {
        proxy_pass http://seeyon_v5_cluster;
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header REMOTE-HOST $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_redirect http:// $scheme://;
        proxy_connect_timeout 300;
        proxy_read_timeout 300;
        proxy_send_timeout 300;
    }
    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   html;
    }
}

upstream seeyon_v5_cluster{
    sticky;
    server 192.168.188.169:81 max_fails=300 fail_timeout=30s;
}

Nginx配置示例截图如下（红框部分是新增comi配置）：

2、检查配置并重新加载Nginx配置

# 检查配置是否正确（示例代码见截图）
./nginx -p nginx目录 -c nginx.conf配置文件路径 -t

# 重新加载配置，使配置生效（示例代码见截图）
./nginx -p nginx目录 -c nginx.conf配置文件路径 -s reload

二、协同配置CoMi并启动

完成Nginx相关配置后，到协同服务器增加CoMi相关连接配置：修改协同OA部署目录下的 base/conf/plugin.properties 文件（若目录下没有plugin.properties就创建这个名字的文件再配置），增加与CoMi相关的三个参数配置ai.comibuilderServer、ai.managerUrl、ai.comi.apikey，相关配置在工具部署生成报表中，直接拷贝粘贴即可。配置完成后，需要重启协同OA才能生效！

注意：协同加密狗需要提前注册更新CoMi所需插件授权，所需插件详见《CoMi V2.0环境准备指导手册 (opens new window)》。

三、协同后台访问CoMiBuilder

以上完成后，通过Nginx地址访问协同 → 系统管理员 → CoMi Builder菜单，如果看到如下界面则说明前期配置正常：

如果访问CoMi Builder异常，请参考《CoMi部署配置常见异常解决方案 (opens new window)》寻找根本原因修复！

四、协同CoMi后台新增模型

CoMi初始化配置依赖相关模型，需要到协同系统后台配置默认模型，详细配置方法详见《CoMi模型配置操作手册 (opens new window)》。

必须配置LLM模型和Embedding模型，并且设置成默认模型：

五、协同初始化CoMi应用

1、在上一步相关模型配置完成后，再进行应用初始化操作：系统管理员 → CoMiBuilder → 系统管理 → 进入数据初始化页面操作：

2、提醒：必须完成上一步模型配置和默认模型设置再进行本章节操作，数据初始化依赖LLM模型和Embedding模型：

3、先初始化应用：应用列表默认只显示5条，需要通过翻页组件切换为100条，再全选所有应用列表，最后点击确定，将所有智能体应用初始化：

注：自CoMi V2.0.2版本开始，数据初始化页面交互发生了很大变化，不用再翻页选择，直接一键全选即可初始化：

初始化过程中，如遇到 依赖资源导入失败: [xxxxx智能体->BI返回数据格式错误] 提示是正常，没有部署协同驾驶舱高级版就会有此提示：

4、应用初始化完成后，再按相同操作初始化Agent和工具，确保全部数据初始化完成：

六、CoMi智能体应用授权

上一步数据初始化完成后，协同集团版用集团管理员登录后台管理页面，协同企业版用单位管理员登录后台管理页面。

进入【智能应用设置】点击【Comi应用授权】：

• 集团管理员“授权单位”，只是授权给单位管理员，再由该单位的单位管理员针对单位下人员进行授权
• “授权用户”则是直接给指定普通用户授权智能体应用使用权限，普通用户重新登录系统就能看到相关智能体应用
• 注意：可授权人员数量受购买插件时注册用户数量控制。比如申请了100注册数，则每个智能体应用只能授权100位用户。

如进入CoMi应用授权页面报错，同样参考《CoMi部署配置常见异常解决方案 (opens new window)》寻找根本原因修复。

下一步，集团管理员 → CoMi工作台，授权全集团或指定单位（如果是企业版产品线，忽略本步操作）：

下一步，单位管理员 → CoMi工作台，授权全单位或指定人员：

以上全部完成后，切换到个人空间，检查是否出现小章鱼按钮：

七、用户使用CoMi

被授权普通用户登录系统，通过右侧CoMi图标进入智能应用页面：

如未显示CoMi图标，则参考《个人空间未显示CoMi超级入口（小章鱼图标） (opens new window)》排查。

智能体页签仅显示用户被授权的智能体应用：

八、详细功能见操作手册

更详细的操作、配置、说明见《CoMi V2.0用户操作手册 (opens new window)》。

九、全文检索配置协同知识搜索（按需）

如需需要使用CoMi智能检索协同、文档、公文等数据，需要准备全文检索服务并且进行相关配置同步操作，详细手册见《CoMi V2.0全文检索协同知识检索配置手册 (opens new window)》

十、智能问数BI集成配置（按需）

如果您在部署 CoMi 的同时，也通过向导工具勾选并部署了智能问数 BI 服务（DataPulse） ，还需要进行 BI 服务自身的初始化配置。

1、 访问 BI 初始化页面： 通过浏览器访问 BI 服务的地址（Nginx 代理地址或直接 IP:端口，如 http://<BI服务器IP>:8058） 。

2、 执行初始化向导： 根据《协同驾驶舱（BI）3.0 部署手册 (opens new window)》 中的 初始化配置 章节指引，完成以下步骤 ：

1. 基础信息配置（设置 admin 密码等） 。
2. 数据仓库配置（连接 PostgreSQL 数据库） 。
3. 协同数据库配置（连接协同 OA 的业务数据库） 。
4. 协同地址配置（配置 BI 服务地址到协同 OA 后台，并获取连接密钥/信道信息填回 BI） 。

3、 验证集成： 完成初始化后，尝试在协同 OA 中访问智能问数相关功能，或直接登录 BI 后台（使用初始化时设置的 admin 密码），确认集成成功 。

工具升级CoMi版本操作

如项目上已经使用智能部署工具安装CoMi老版本，现需要使用工具对CoMi进行升级，可参考本章节操作。

1、访问老版本CoMi智能工具管理控制台，停用CoMi老版本所有服务：

2、停止智能工具老版本管理控制台服务：

# 本示例为停用CoMi V2.0版本工具
cd /data/comi-deployer-tools/Deployer-Tools-v2.0-linux-x86_64
bash shutdown.sh

3、升级前备份CoMi数据库数据！升级前备份CoMi数据库数据！升级前备份CoMi数据库数据！升级涉及SQL更新，如存在异常，无法还原数据。

4、提前下载新版本智能部署工具（工具地址见[安装包准备]）。备份智能工具旧版本程序，将其升级到新版本（如CoMi V2.0.2）程序，并且将2.0部署数据（install.db）导入2.0.2程序中：

注：新版本的智能工具提前下载并上传。

cd /data/comi-deployer-tools
# 将原2.0程序重命名（防止与后面解压的2.0.1版本程序命名过于接近）
mv Deployer-Tools-v2.0-linux-x86_64 bak-Deployer-Tools-v2.0-linux-x86_64

# 上传2.0.2版本压缩程序并解压（示例为X86工具包）
unzip Deployer-Tools-v2.0.2-linux-x86_64.zip -d /data/comi-deployer-tools/

# 将2.0部署数据install.db导入2.0.2程序中
cp bak-Deployer-Tools-v2.0-linux-x86_64/install.db Deployer-Tools-v2.0.2-linux-x86_64/

# 启动2.0.2程序
cd Deployer-Tools-v2.0.2-linux-x86_64/
bash startup.sh

5、PC客户端通过浏览器访问 http://部署工具IP:端口（默认9526） 如无法访问，则考虑部署工具服务器防火墙是否未放开端口（如默认9526）访问权限。

自CoMi V2.0.1版本开始，智能部署工具首次登录需要设置密码（密码至少8位，且包含字母、数字、特殊字符中至少两种），请妥善保存密码，方便后期维护！

6、升级到智能工具新版本并且登录后，如能看到原版本的部署记录，则说明升级和数据恢复正常：

7、提前准备好CoMi新版本的所有核心服务程序（程序地址见[安装包准备]），上传到服务器 或 客户端压缩再上传到智能部署工具：

注：新版本如有新的必须安装的服务，需要在升级时进行安装补齐。如CoMi V2.0.2新增必须安装comi server、沙箱、文件解析服务，则参考下图所示准备相关服务安装包：

进入【修改并更新环境】页面，上传或解析新版本程序：

8、依次配置CoMi核心服务，大部分核心服务只需要重新确定保存一遍，其中Qdrant和AI-Manager需要注意特别操作一下：

8-1、Qdrant服务：升级场景下，部署模式选择“跳过安装使用现有实例”：

注：自CoMi V2.0.2版本开始无此配置，无需个人勾选“跳过安装使用现有实例”，由工具自动识别是否升级跳过。

8-2、AI-Manager服务，升级场景下，需要调整两个参数：

• 当前CoMi版本：必须选择，选择后程序会走升级逻辑。 注：自CoMi V2.0.2版本开始无此配置， 由工具自动识别升级。
• 同时向量化批次数量：大多数情况可保持默认50，仅使用阿里百炼平台text-embedding-xx模型客户需要将其调整为10。

注：自CoMi V2.0.2版本开始无需设置当前CoMi版本，由工具自动识别是否升级跳过。

8-3、自CoMi V2.0.2版本开始，必须部署CoMi Server服务，需要提前准备一个空库和三方互信信息，详细配置见[CoMi Server服务配置]章节！

8-4、自CoMi V2.0.2开始，必须部署沙箱服务，并且AI-Engine服务中设置沙箱默认开启：

8-5、自CoMi V2.0.2开始，必须部署ai-document-parse文档解析服务：

9、跟全新安装部署一样：先配置好参数，再选择要部署或升级的服务，一键校验，确认无误后点击底部的“下一步”按钮：

自CoMi V2.0.2版本开始，V5产品线支持自动写入Nginx配置，详细配置说明参考 [外部依赖与集成配置（Nginx）] 章节！

下一页，环境预检查通过后，再点击底部下一步按钮：

10、最后确保服务正常部署完成，部署后可启动comi相关服务：

注：如部署出现异常，需要分析解决异常，再点击右上角“取消部署”按钮，进行重新部署。

异常说明：如遇到自动部署异常，需要分析异常服务的日志并解决后再重试，相关日志从服务器上提取，如未修改程序，日志默认存放于：

• 部署工具日志默认存放于 /data/comi-deployer-tools/Deployer-Tools-v2.0.2-linux-x86_64/logs
• ai-engine日志默认存放于 /data/Seeyon/Comi/ai-engine/logs
• ai-manager日志默认存放于 /data/Seeyon/Comi/ai-manager/logs
• qdrant日志默认存放于 /data/Seeyon/Comi/qdrant/qdrant.log
• ai-security日志默认存放于 /data/Seeyon/Comi/ai-security/logs

如果有如下提示，表示工具自动写入NG失败了，需要手动导出报告手动配置一下NG：

在服务列表检查服务启动状态：

11、登录协同系统管理员后台 → CoMiBuilder → 系统管理 → 数据初始化，对应用、Agent、工作流（可能没数据）、工具每个页签进行数据的初始化和更新操作。此步操作需要认真检查：一部分数据是初始化，一部分数据是更新，依次批量操作一下。

下图为CoMI V2.0.2数据初始化更新的操作截图：

下图是CoMi低版本的更新方式，数据初始化UI交互与CoMI V2.0.2有一定不同：

异常说明：初始化过程中可能存在一些失败，如未部署智能问数相关服务，可以忽略BI相关错误。并且产品支持后续部署智能问数后，重新初始化失败应用。

12、授权应用：新版本可能存在新的智能体应用发布，可到 集团或单位管理员 → CoMi应用授权 ，对新应用进行授权使用。

日常维护操作

日常启停CoMi服务

1、通过智能部署工具安装的CoMi，日常启停服务均可以使用此工具在线化操作，首先确定服务处于启动状态：

# 到工具程序目录(示例为X86环境)
cd /data/comi-deployer-tools/Deployer-Tools-v2.0-linux-x86_64/
# 启动工具
bash startup.sh
# 启动后等待30秒，netstate检查工具端口是否存活，存活则表示正常
netstat -ntlp | grep 9526
# 根据日志文件输出信息，实时查看日志运行情况（示例为X86工具包）
tail -f /data/comi-deployer-tools/Deployer-Tools-v2.0-linux-x86_64/logs/output.log

2、PC客户端通过浏览器访问 http://部署工具IP:端口（默认9526） ，在CoMi智能部署工作台，点击 [打开] 进入服务启停页面，在操作栏中可视化启用、停用服务即可。

查看CoMi日志

如需查看日志，可以通过CoMi智能部署工作台直接下载日志。

同样可以远程到服务器提取日志，常见服务日志存放路径如下：

• ai-engine日志默认存放于 /data/Seeyon/Comi/ai-engine/logs
• ai-manager日志默认存放于 /data/Seeyon/Comi/ai-manager/logs
• qdrant日志默认存放于 /data/Seeyon/Comi/qdrant/qdrant.log
• ai-security日志默认存放于 /data/Seeyon/Comi/ai-security/logs
• 部署工具日志默认存放于 /data/comi-deployer-tools/Deployer-Tools-v2.0.2-linux-x86_64/logs

修改CoMi配置

日常运行过程中，可能会存在调整指定服务参数的情况，可参考本章节操作。

1、通过CoMi智能部署工作台，点击“修改并更新环境”，进入修改列表页面：

2、按需修改指定服务的配置，点击确定保存：

3、修改后的服务状态变为“待校验”，需要勾选并点击一键校验，再“下一步”重新发布应用：

4、第二步进行“环境预检查”，确保所有配置通过，再到最后一步页面：

5、第三步点击“开始部署环境”，工具会重新更新发布修改的服务，发布完成后配置生效。

更新CoMi服务程序应用

日常运行过程中，CoMi某个应用的程序可能存在BUG，或者预制的智能体应用存在问题，在研发的排查下，需要更新某个服务的程序应用，可参考本章节操作：

1、首先获得研发提供的需要修复的服务程序应用，本例以X86环境下的AI-Manager服务应用更新为例：AI-Manager-linux-x86_64.zip

2、通过CoMi智能部署工作台，点击“修改并更新环境”，进入修改列表页面：

3、上传第一步已经下载好的应用（注：更新CoMi服务可以直接上传具体服务的zip压缩包，不用再按全新部署时那样外层包一个文件夹的形式上传）

4、解析上传的CoMi服务，解析成功后，对应“已安装”的服务会变成“未配置”。点击“配置”按钮，不用做任何操作，再保存一次，接着就可以右下角下一页、下一页到重新部署应用页面。

5、确认无误的前提下，直接重新部署应用（工具仅重新部署上一步勾选配置的应用），直至看到部署完成为止，随后依次启动CoMi相关服务，检查功能是否正常：

6、（本步仅更新AI-Manager服务后需要检查操作）协同OA → 系统管理员后台 → CoMi Builder → 系统管理 → 数据初始化，如看到有标红数字则表示存在更新的预制包，参考CoMi首次部署完成后的应用初始化操作，更新预制包即可：

修改Nginx内网地址操作

如果项目涉及 测试环境的comi切换连接正式OA地址 或 调整Nginx服务内网地址 （如http切换https 或 更换NG端口），除了更新AI-Manager关于NG的配置之外，还需要重新初始化应用等一系列操作，涉及操作如下：

1、修改AI-Manager服务中的Nginx内网地址， 修改后需要重新发布应用 ，修改重新发布操作参考 【修改CoMi配置】 章节：

2、修改协同OA下的配置：到协同服务器，修改协同OA部署目录下的 base/conf/plugin.properties 文件，调整 ai.comibuilderServer 参数，将其修改为新的Nginx地址，并且重启协同OA：

3、修改工具地址：CoMi 2.0执行SQL、CoMi 2.0.1可视化配置，以下3-1和3-2根据不同版本二选一操作

3-1、本功能自CoMi V2.0.1版本开始支持，如修改NG内网地址发现CoMi无法调用工具接口，需要替换基础路径：系统管理员 → 系统管理 → 数据初始化 → 工具 → 替换基础路径：

注：本步操作需要完成前面第1步和第2步后执行。

3-2、如CoMi 2.0客户（未升级到2.0.1），通过数据库SQL执行替换：

-- 在comi的数据库中执行，其中http地址需要项目根据自身情况调整（如下示例中80端口是数据库原始值，81端口是新地址的值）
update ai_tool_info set service_url = replace(service_url, 'http://192.168.188.136:80/', 'http://192.168.150.125:81/');

4、以上完成后，去工具菜单检查接口是否已经替换为NG新地址。

5、如果CoMi连接的协同OA从测试环境切换为生产环境，需要到协同OA后台重新做智能体应用授权（集团或单位管理员 → CoMi应用授权）。

6、如果测试环境使用了协同知识问答，已将测试环境的数据写入到CoMi向量库（管理员 → CoMiBuilder → 资源库 → 知识库 → 协同知识下检查是否存在测试数据），需要清理这一批测试数据： 此操作涉及清理向量库数据，需要发起技术服务支持申请单，由CoMi研发提供 delete_qdrant_collection.sh 工具。

-- 第一步，在comi的数据库中执行：协同知识问答表数据清空：
TRUNCATE TABLE ai_knowledge_source_record;
TRUNCATE TABLE ai_knowledge_source_repository;
TRUNCATE TABLE ai_knowledge_source_file_info;
TRUNCATE TABLE ai_knowledge_source_content_md5;
TRUNCATE TABLE ai_knowledge_source_chunk_info;

-- 第二步清空协同知识问答的Qdrant向量库数据：
到Comi/app/ai-manager下执行bash delete_qdrant_collection.sh  运行过程中要确认Qdrant的端口，如果没调过就保持默认

重置智能部署工具管理员登录密码（Since CoMi 2.0.1）

-- 到程序目录下运行resetpassword.sh脚本重置密码
cd /data/comi-deployer-tools/Deployer-Tools-v2.0.1-linux-x86_64
bash resetpassword.sh

-- 确认重置后，启动服务，重新访问智能部署工具系统，设置登录密码
bash startup.sh

工具卸载CoMi单个服务（since CoMi 2.0.2）

自CoMi 2.0.2版本开始，一体化安装工具支持卸载指定服务：通过核心服务状态面板，找到对应服务点击卸载：

注意卸载操作不可恢复，卸载前备份好相关关键数据！

常见问题

所有部署配置访问异常，请参考 《CoMi部署配置常见异常解决方案 (opens new window)》 手册进行排查处理。

编撰人：admin、het、hufei、wangyxyf

快速跳转

• CoMi V2.0.2智能部署工具安装升级手册
  • 前言
  • 修订记录
  • 部署工具适配说明
    • 部署工具能力
    • 部署维护范围
    • 操作系统支持
    • 商务插件准备
    • 适配协同版本
  • 依赖环境准备
    • 操作系统环境准备（必须）
    • 协同Nginx准备（必须）
    • CoMi数据库准备（必须）
    • 大模型提前准备
    • 安装包准备（必须）
  • 部署工具安装和访问
    • 部署工具运行架构图
    • 部署工具安装和运行
  • 部署工具安装CoMi步骤
    • 一、新建环境项目
    • 二、上传解析CoMi部署包
    • 三、配置CoMi核心服务
      • CoMi核心服务配置流程
      • CoMi核心服务详细配置说明
        • Qdrant向量数据库配置
        • AI-Manager管理后台服务配置
        • AI-Engine智能引擎配置
        • AI-Security安全服务配置
        • CoMi Server服务配置
        • AI-document-parse文档解析服务
        • CoMi代码执行沙箱
        • 协同驾驶舱 (智能问数 BI)配置
        • 外部依赖与集成配置 (Nginx)
    • 四、环境预检查
    • 五、自动化执行部署
    • 六、检查自动部署服务状态
  • 工具部署后其它重要配置
    • 一、Nginx增加CoMi配置
    • 二、协同配置CoMi并启动
    • 三、协同后台访问CoMiBuilder
    • 四、协同CoMi后台新增模型
    • 五、协同初始化CoMi应用
    • 六、CoMi智能体应用授权
    • 七、用户使用CoMi
    • 八、详细功能见操作手册
    • 九、全文检索配置协同知识搜索（按需）
    • 十、智能问数BI集成配置（按需）
  • 工具升级CoMi版本操作
  • 日常维护操作
    • 日常启停CoMi服务
    • 查看CoMi日志
    • 修改CoMi配置
    • 更新CoMi服务程序应用
    • 修改Nginx内网地址操作
    • 重置智能部署工具管理员登录密码（Since CoMi 2.0.1）
    • 工具卸载CoMi单个服务（since CoMi 2.0.2）
  • 常见问题