跳到主要内容

OpenWes 安装指南

按照以下步骤在您的系统上安装并设置 OpenWes。OpenWes 设计为易于部署,无论您是在本地开发环境中运行,还是在云环境中用于生产。

前提条件

  • Java (17+): 用于运行后端服务器应用程序。

  • MySQL (8.0+): 用作关系型数据库,用于存储仓库数据。

  • Nacos (2.0+): 服务注册和配置管理工具。

  • Redis (7.0+): 用于缓存和会话管理。

  • Node.js(18+): 用于运行客户端应用程序。

MySQL、Nacos 和 Redis 应安装在同一台机器上。 您可以使用 docker-compose 文件 通过 docker-compose 安装所有中间件(如 MySQL、Nacos 和 Redis)。

步骤

1. 克隆代码仓库:

git clone https://github.com/jingsewu/open-wes.git

2. 设置后端服务器

2.1 加载 Nacos 配置 执行脚本将 Nacos 配置加载到 MySQL 数据库中:

mysql -u root -p nacos_config < server/script/nacos_config.sql

2.2 配置主机名

编辑系统的 hosts 文件,将 Nacos 主机名(nacos.openwes.com)映射到 127.0.0.1

  • Linux: /etc/hosts

  • Windows: C:\Windows\System32\drivers\etc\hosts 在文件中添加以下行:

172.0.0.1 nacos.openwes.com

2.3 创建 OpenWes 数据库 登录 MySQL 并创建 openwes 数据库:

  create database openwes;

2.4 启动后端服务器 进入 server/server 目录并启动后端服务器:

  • WesApplication

  • GatewayApplication

  • StationApplication
    您可以使用 IDE(如 IntelliJ 或 Eclipse)或以下命令:

java -jar WesApplication.jar
java -jar GatewayApplication.jar
java -jar StationApplication.jar

3. 设置客户端

3.1 更新 Webpack 配置 重命名开发环境的 Webpack 配置文件:

mv client/build/webpack.config.example.dev.js client/build/webpack.config.dev.js

3.2 安装客户端依赖 进入客户端目录并安装所需依赖:

cd client
npm install

3.3 启动客户端 运行客户端应用程序:

npm start

客户端默认将在 http://localhost:4001 上运行。

故障排除

如果在安装过程中遇到任何问题,请检查以下内容:

  • 缺少依赖项:确保所有必需的软件(Java、MySQL、Nacos、Redis、Node.js)已正确安装和配置。

  • 主机文件问题:确保 nacos.openwes.com 指向正确的 IP 地址(127.0.0.1)。

  • 数据库问题:确保在 MySQL 中成功创建了 openwes 数据库。

如需进一步帮助,请咨询 OpenWes 社区 或在 GitHub 仓库中创建问题。