EDI系统上线须知：保障效率与稳定的关键指南

如今，越来越多的企业选择通过知行之桥EDI平台实现自主实施，从而在业务数据交换和管理方面取得更大的控制权。然而，在EDI系统的日常运维过程中，难免会遇到各种问题。

本文将带你深入了解，如何巧妙应对EDI系统的运维挑战，解锁更为高效的自主实施体验，以确保EDI系统的稳定性和安全性。

启动与停止

EDI系统的启动与停止直接关系到业务的连续性，需要保证操作灵活而迅速。

• .net版本：设置知行之桥作为Windows服务运行，这样EDI系统会随着服务器的重启而自动启动，这个设置是安装知行之桥2023版本及更高版本默认配置了的。如果EDI系统未设置，可以点击系统托盘中的知行之桥图标，右键选择“Server Option”，勾选“Run as a Windows Service”。如果需要停止EDI服务，可以在“任务管理器中”的”服务”中找到”知行之桥”，右键停止即可。

如果不希望作为Windows服务运行，可以在知行之桥的安装目录下双击CData.Arc.exe启动。停止时，可以直接结束知行之桥进程，或者在知行之桥控制台点击退出。

• Java版本：知行之桥捆绑了一个基于Eclipse Jetty构建的Web服务器，可以直接使用java -jar arc.jar命令启动，若需停止进程可以使用命令kill -9 pid。知行之桥同样提供了一个service.sh的脚本，可以执行这个脚本设置systemd 或 init.d 服务，运行脚本后可以根据Linux版本所使用的的服务管理器来启动服务。

对于 init.d, 运行 sudo service arc start

对于 systemd, 运行 sudo systemctl start arc

如果希望停止知行之桥服务，命令为：sudo service arc stop或sudo systemctl stop arc.

扩展阅读：启动服务器

数据备份与恢复

数据是企业的重要资产，备份和恢复也是EDI系统运维中至关重要的环节。知行之桥中的数据包含：配置数据、业务数据和log数据。

• 配置数据：可从知行EDI平台自动导出（包含定制开发的代码）。可以直接点击工作流页面的端口并选择“导出端口设置”；也可通过工作流页面右下方“选择多个端口”启动多选模式导出；导出当前工作区可以在工作流面板右上角工作区字段，选择“导出工作区”；要导出多个工作区，单击蓝色标题中右侧的设置（齿轮图标），单击迁移选项卡。在此选项卡上，可以进行全局地导出和导入。

请注意导出的配置会生成.arcflow文件，可以直接导入知行之桥中。如果希望导出敏感信息，需启用以下功能，并提供密码，知行之桥会导出保存在 port.cfg 文件中的敏感信息，并使用提供的密码对其进行加密。（提醒：私钥证书密码、OFTP及SFTP/FTP密码，邮箱密码等敏感信息最好单独记录）

扩展阅读：导入导出

• 业务数据：知行之桥的应用程序目录保存应用程序使用的所有数据：配置数据、应用程序数据、日志记录数据、证书等。通常.net版本下默认路径是C:\ProgramData\CData\Arc，安装完知行之桥后，在安装目录 www 文件夹中的 Web.Config 文件可以自定义该路径，建议做好磁盘镜像，可以紧急应对服务器磁盘损坏的问题的同时，也方便后期迁移数据。

Java版本若需要修改应用程序目录，首先在arc.jar所在的安装目录下执行以下命令：java -jar arc.jar -GenerateProperties，这样就在安装目录下生成了文件arc.properties，打开该文件，修改配置：cdata.app.directory=指定的应用程序目录。

如果只希望备份与交易伙伴传输的源数据，可以在工作流的MFT连接端口（比如AS2, OFTP）之后添加File端口和Copy端口。

以上Backup_855端口用来备份已发送成功的源855报文，Backup_850端口备份接收到的源850报文，File端口的“设置”页面可以配置具体的备份目录。

• Log数据：知行之桥提供了日志数据库存储功能，默认的log数据库是SQLite和Derby，存储在知行之桥安装目录下的db文件夹，这种数据库性能较低。通常我们会建议客户配置自己的数据库来存储EDI系统的日志数据。

在.net版本，安装目录 www 文件夹中的 Web.Config 文件中可以配置log数据库的连接信息，配置之前需要去掉代码注释：

Java版本修改安装目录下的文件arc.properties，修改配置： cdata.app.db=jdbc:cdata:sql:server=localhost;database=sqlserver;user=MyUserName;password=MyPassword

迁移与升级

为了适应EDI业务的发展，有的时候需要迁移和升级当前的知行之桥EDI系统，在操作之前，我们需要进行充分的规划和测试，以确保迁移或升级过程是平稳和可控的。

步骤如下：

• 前期准备：准备好知行之桥安装包，预留1-2小时停机时间，提前通知相关人员。
• 环境迁移：前往高级设置->迁移，一键导出旧环境的所有配置。

注意：
（1）如果是从旧版本升级到新版本，需提前在本地新版本做好工作流的测试。
（2）若涉及EDI报文生成需提前记录最大的ICN#，即control number，如何在新环境设置最新的ICN#， 扩展阅读：control number 设置

• 硬件设备检查：新的服务器提前准备好，需要有固定外网IP，开通端口，持续的网络连接，足够的磁盘和内存。
• 安装部署：在新服务器安装知行之桥，设置登录用户和密码点击获取密码的复杂度要求，激活license。单击知行之桥蓝色标题中右侧的设置（齿轮图标），单击迁移选项卡，选择导入所有工作流，配置应用程序目录和日志数据库。

注意： 若需配置SSL证书，则要单独配置。操作步骤

• 检查与验证：部署完成后，启动知行之桥，浏览器访问Web界面，检查日志页面的应用程序是否有报错；检查OFTP，SFTP，Database，EmailSend/EmaileReceive等相关端口的连接是否正常；各个工作流端口的配置信息是否被正确同步；持续观察文件的处理情况。
• 保护EDI管理平台 启用IP白名单方式，限制外部访问EDI管理平台以及数据接收URL，确保数据安全。 如果数据接收URL不适合通过IP白名单方式限制，那建议使用反向代理方式，限制外部访问EDI 管理界面，只将数据接收URL暴露在公网即可。
• 通知与恢复：若知行之桥稳定运行，需通知业务部门和客户方恢复业务数据的传输。

邮件告警

为了方便监控知行之桥系统中的业务，及时收到来自EDI系统的错误提醒，建议在EDI项目上线后配置邮件通知功能。单击知行之桥蓝色标题中右侧的设置（齿轮图标），单击通知选项卡，配置以下信息：

发件人：指定发件邮箱，只能配置一个发件邮箱
收件人：指定收件邮箱，可配置多个收件箱，使用分号分隔
邮件标题：配置邮件通知默认的邮件主题
SMTP服务器：指定发送邮箱的发件服务器
认证类型：默认是Basic Auth，可根据实际情况选择
用户：发件邮箱用户
密码：用户密码
端口：默认是25端口，需要根据邮箱服务器设置的发件端口进行配置
加密类型：默认不加密，需要根据邮箱服务器的设置进行配置

配置完成后，可以点击发送测试邮件，检查是否成功。邮件通知功能主要适用于以下几种情况，可根据需要勾选。

除了手动配置邮件告警外，知行之桥还有几个自带的健康检查的邮件提醒，包括：

1.磁盘使用率，默认超过60%邮件通知
2.内存使用率，默认超过60%邮件通知
3.日志数据库数据量监控，默认存储超过10W条数据时邮件通知
4.单端口堆积文件监控，默认（Send,Sent,Received,Logs/Sent,Logs/Received任意目录下）超过5000文件时邮件通知

收到这些监控邮件时，并非是EDI系统出现了问题，仅是提醒磁盘、内存或者数据量等情况作为参考，必要时可以清理释放磁盘或者内存。点击阅读操作详解

证书更新

在与交易伙伴建立EDI传输时，通常都会配置证书，以确保建立安全可靠的电子数据交换通道。申请或购买的证书是有一定效期的，证书到期前需要及时更新才不会影响生产业务。

• 更新自己的证书

通常当自己的私钥证书即将到期时，需要提前和交易伙伴约定一个固定时间一起更新，将.cer/.p7b/.crt的公钥证书提供给交易伙伴。一般情况，在知行之桥的“个人设置”页面配置自己的私钥证书和证书密码。这里以AS2传输协议举例，如果使用OFTP协议，可以在OPTP Profile页面更新自己的证书。

如果连接了多个交易伙伴，并且针对每个交易伙伴设置了不同的私钥证书，需要在对应MFT端口的高级设置页面更换自己的证书。

• 更新交易伙伴的证书

在知行之桥MFT端口可以更新交易伙伴的公钥证书，比如使用AS2传输协议，在端口的“设置”页面的“交易伙伴证书”下配置其加密证书即可：

扩展阅读：证书更新

支持与联系

通过阅读本操作手册，相信用户可以更加熟练的管理和运维知行之桥EDI系统，如果在使用中遇到任何问题，我们随时提供电话和邮箱支持。请电话联系我们的项目经理或者发送邮件至support@kasoftware.cn。