Windows系统部署手册 - 3D场景发布平台

10/15/2024

# 部署准备工作

# 1.依赖环境

准备好服务器,可以复用已有中间件基础软件,没有也没关系,下面流程有安装步骤说明。

环境 要求
操作系统 Windows 10及以上x64位操作系统
jdk 1.8
mysql 5.7+
redis 5+
nginx 1.24+

# 2.下载部署文件

请单击网盘下载 (opens new window)进行下载部署文件, 并拷贝文件到目标电脑的D:\目录中(我们已D盘为例,其他盘时下面教程中路径自行修改);

压缩包文件名 内部目录名 内容
mars3d-studio-日期.zip mars3d-studio 后端服务,启停脚本,数据库脚本文件
html-日期.zip html Web前端网页包
deps-window.zip deps 基础环境软件参考配置,包括nginx、mysql、jdk、redis等

# 安装步骤说明

# 1.解压“mars3d-studio-日期.zip”

mars3d-studio-日期.zip放在D:/下,右击压缩包解压至当前文件夹,解压后目录为D:/mars3d-studio/

image

# 2.解压“html-日期.zip” 和 “deps-window.zip”

html-日期.zipdeps-window.zip放在D:/mars3d-studio/目录下,解压至当前文件夹,解压后目录为D:/mars3d-studio/html/D:/mars3d-studio/deps/

image

# 3.核对目录结构

调整后的目录结构为:

D:/mars3d-studio
 ├─ api    (后端服务文件)
    ├─ config
      └─ application-prod.yml  # 后端配置文件
    ├─ lib
    └─ coffee-admin.jar
 ├─ bin
   ├─ start.bat       # 启动服务
   ├─ stop.bat        # 停止服务
 ├─ data
   ├─ init_data.sql  # 数据库初始化脚本
   ├─ gap  # 上传目录
 ├─ logs   
 ├─ html  #对应html-日期.zip,Web前端网页包
   ├─ favicon.ico
   └─ index.html
 └─ deps   #对应deps-window.zip
   ├─ nginx
     ├─ logs
     ├─ nginx.exe
   ├─ gdal
   ├─ jdk
   ├─ mysql
   └─ redis 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

# 4.安装 MySQL 数据库

D:/mars3d-studio/data/init_data.sql文件覆盖至D:/mars3d-studio/deps/mysql/init_data.sql

image

双击mysql_install.bat,未出现错误提示,等待安装完成即可!

image

如果本地已有Mysql可以复用,使用D:/mars3d-studio/data/init_data.sql脚本创建好数据库即可。

# 5.安装 Redis 服务

双击D:/mars3d-studio/deps/redis/redis_install.bat, 等待安装完成即可!

image

# 6.修改Java后端配置

记事本或编辑工具打开D:/mars3d-studio/api/config/application-prod.yml文件,根据实际部署目录复用本地基础软件时按需修改配置。

#仅节选了关键配置
spring:
  datasource:
    dynamic:
      datasource:
        master:
          url: jdbc:mysql://127.0.0.1:3306/mars3d-studio-pro?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai&useSSL=false&autoReconnect=true&allowPublicKeyRetrieval=true
          username: root
          password: 123456
  redis:
    host: 127.0.0.1
    port: 6379
    database: 0
    password: 123456
app:
  demoEnabled: false
  uploadDir: C:/mars3d-studio/data/gap # 上传目录,根据实际情况进行调整 D:/mars3d-studio/data/gap
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

其中关键配置信息:

  • app.uploadDir 【重要】上传临时目录,需要核对实际安装路径修改
  • spring.datasource.dynamic.datasource MySQL数据库链接
  • spring.redis Redis链接
  • spring.file-storage 文件上传配置(支持本地/minio 等)

# 7.修改Nginx服务配置

代码编辑工具(请勿用记事本)打开D:\mars3d-studio\deps\nginx\conf\host\m80.conf文件, 其中关键配置如下:

 # 前端页面
 location / {
    root   D:/mars3d-studio/html; #【关键】根据实际安装路径进行调整
    index  index.html index.htm;
    try_files $uri $uri/ /index.html;
 }

 # 后端api
 location ^~/api/ {
    proxy_pass http://localhost:2800;
    proxy_http_version 1.1;
    proxy_set_header Host $http_host;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "Upgrade";
    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;
 }

 # 静态资源
 location /gap/ {
    include nginx_cors;  #允许跨域配置
    root D:/mars3d-studio/data;  #【关键】根据实际安装路径进行调整
    expires 7d;
 }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

其中的root D:/mars3d-studio/htmlroot D:/mars3d-studio/data配置,需要根据实际部署路径进行修改后保存。

如果是复用自己的nginx服务,将当前关键配置拷贝进去后独立端口访问即可,其中的include nginx_cors配置需要拷贝部署包中的D:/mars3d-studio/deps/nginx/conf/nginx_cors文件到自己nginx安装目录的conf子目录下。

# 启动平台

# 1.启动服务

双击D:/mars3d-studio/bin/start.bat, 等待几秒即可;

image

# 2.访问系统

打开浏览器访问http://127.0.0.1,输入超级管理员账号 root/123456进行登录(建议首次进入后修改密码并创建普通用户帐号)。

image

# 平台授权

首次启动时免费试用一个月,会提示License试用验证通过;后续联系我们进行授权,需提供程序生成的clientCode机器码(在启动的Java后端控制台有打印,或者单击登录页面下面下侧的问号小图标)。

# 停止平台

# 停止服务

双击D:/mars3d-studio/bin/stop.bat停止服务

# 更新平台

首先停止服务,停止后下载最新的离线包,没有特殊说明时,可以只用覆盖下面2个目录

  1. 更新后端服务: “mars3d-studio-日期.zip” 中的/api/lib/目录,解压后拷贝覆盖到/mars3d-studio/api/lib/目录中(注意别覆盖\mars3d-studio\api\config\配置文件);
  2. 更新前端页面: “html-日期.zip”压缩包全部解压覆盖到/mars3d-sudio/html/目录。

更新完成后启动服务。

# 部署中常见问题

查看部署中常见问题

最后更新: 10/21/2024, 11:32:56 AM