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

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

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

启动与停止

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

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

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

edi_go_live_notice1.png

  • 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密码,邮箱密码等敏感信息最好单独记录)

edi_go_live_notice2.png

扩展阅读:导入导出

  • 业务数据:知行之桥的应用程序目录保存应用程序使用的所有数据:配置数据、应用程序数据、日志记录数据、证书等。通常.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端口。

edi_go_live_notice3.png

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

edi_go_live_notice4.png

  • 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小时停机时间,提前通知相关人员。
  • 环境迁移:前往高级设置->迁移,一键导出旧环境的所有配置。

edi_go_live_notice5.png

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

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

edi_go_live_notice6.png

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

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

邮件告警

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

edi_go_live_notice7.png

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

edi_go_live_notice8.png

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

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

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

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

证书更新

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

  • 更新自己的证书

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

edi_go_live_notice9.png

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

edi_go_live_notice10.png

  • 更新交易伙伴的证书

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

edi_go_live_notice11.png

扩展阅读:证书更新

支持与联系

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

了解更多 EDI 信息,请您通过邮件 sales@kasoftware.cn 联系我们。点击下方蓝色按钮,即可免费试用 EDI 软件。
标签: , , , , ,
文章分类 产品介绍, 帮助文档, 常见问题和回答, 操作指南, 知识库