本文将为大家介绍如何在Windows系统中安装知行之桥EDI系统跨平台版本的常见报错以及解决方案。如下图所示:
在知行软件官网的导航栏中点击 下载 按钮,即可看到知行之桥EDI系统不同版本的下载选项,点击右侧跨平台版本,选择 Windows 安装包(.exe),下载跨平台版本的知行之桥EDI系统,获取30天的免费试用。
跨平台版本捆绑了一个基于 Eclipse Jetty 构建的Web服务器,以支持简单的跨平台部署。这个独立的Web服务器是通过运行 arc.jar 文件,位于安装目录中。
Java -jar arc.jar
知行之桥已预先配置为可在任何环境中立即工作。但是如果需要自定义此Web服务器的配置,可以生成arc.properties 文件,位于 arc.jar 文件旁。创建后,可以根据特定部署需求修改此配置文件。
在Windows中,知行之桥默认安装为服务。要访问该应用程序,首先必须确保该服务正在运行。服务运行后,可以通过打开网络浏览器并在URL字段中输入http://localhost:8080/ 来访问知行之桥管理控制台。
报错1
下载知行之桥EDI系统跨平台版本后,需要使用命令:java -jar arc.jar 启动系统。这里需要先定位至知行之桥的安装目录下,然后在使用上述启动命令,否则将会报错: Errors:Unable to access jarfile arc.jar,如下所示:
报错2
知行之桥的跨平台版本与基于 Jetty 构建的 web 服务器绑定在一起,因此无需任何外部服务器配置即可运行。此外,该安装包括一个. WAR文件,可以部署到任何Java servlet容器,如 Apache Tomcat, Eclipse Jetty,或者IBM WebSphere。
内置 Jetty 服务器要求服务器上安装 JDK 11 或更高版本。部署到外部 Java servlet 则需要 Servlet 3.0 (Jetty 8+、Tomcat 7+、JBoss EAP 6/7、Glassfish 3、WebLogic 12+、WebSphere 8+等)。
因此在安装知行之桥EDI系统的时候,需要检查当前的java版本,可通过如下命令查询:java -version。用户也可以使用知行之桥EDI系统内置的jre,路径如下:
知行之桥的安装路径 -> jre -> jdk-17.0.5+8 -> bin
如何使用知行之桥EDI系统内置的jre
在 cmd 中通过命令 where java 即可显示当前环境变量中配置的java路径,现需要用知行之桥EDI系统内置的jre所在路径替换掉现有路径。位置如下:
控制面板 -> 系统与安全 -> 系统 -> 高级系统设置 -> 环境变量
需要将JAVA_HOME的值换成知行之桥EDI系统安装目录 -> jre -> jdk-17.0.5+8文件夹的路径,或者需要将 CDATA_JAVA_PATH 置顶并确认值为知行之桥EDI系统安装目录 -> jre -> jdk-17.0.5+8文件夹。
报错3
启动知行之桥EDI系统之后,在功能端口中看到如下报错:
Failed to start database ‘C:\ProgramData\ArcESB\db\app_transactions’ with class loader WebAppClassLoader{Arc}@3c87521,see the next exception for details.
如果出现以上报错很大可能是用户当前有多个实例同时使用同一db,例如用户此前已经下载了其他版本的知行之桥EDI系统,则可能会出现上述报错。需要给这些实例各自配置一个app.directory。
知行之桥2024版本中配置app.directory
如果用户下载了知行之桥EDI系统的最新版本,在对嵌入式 Jetty 服务器进行任何自定义之前,必须创建 arc.properties 文件。在arc.jar所在的安装目录下执行以下命令:
java -jar arc.jar -GenerateProperties
这将在安装目录中创建 arc.properties 文件。用户需要在这个文件中为当前知行之桥配置专属的app.directory,如下图所示:
知行之桥2023版本及更早版本中配置app.directory
知行之桥2023版本及更早版本中配置app.directory需要在软件的安装目录下找到www_services文件夹,打开Web.Config文件,修改此文件末尾处关于AppDirectory的设置,在value处配置一个自定义的路径。如下所示:
以上便是知行之桥EDI系统跨平台版本在安装部署过程中能够可能会遇到的问题以及相应的解决方案。详细的安装过程可以点击查看下载页面中的操作视频
了解更多 EDI 信息,请参阅: EDI 是什么?