Torna

# 企业版介绍

企业版是基于开源版本进行开发，主要包括以下功能：

  • 对接apifox (opens new window)，推送文档时可将文档同步到apifox中
  • 支持MCP功能
  • 导出OpenAPI3，导出为OpenAPI3格式文档
  • 获取OpenAPI3 URL, 请求url可返回OpenAPI3格式文档

# 升级到企业版

版本定义：1.x表示社区开源版，2.x表示企业版

社区开源版可以平滑升级到企业版，确保数据库账号可以执行DDL语句

# 方式1：Linux服务器快速部署

创建配置文件，执行命令：

mkdir /etc/torna && wget https://gitee.com/durcframework/torna/raw/master/install/application.properties -O /etc/torna/application.properties

vim /etc/torna/application.properties修改数据库连接配置, 确保数据库账号有DDL执行权限，后续会自动执行DDL升级脚本

拉取最新版本并启动

wget https://gitee.com/durcframework/torna/raw/master/install/restart-torna.sh && sh restart-torna.sh 2.0.1

访问：http://<服务器ip>:7700

用户名：admin，密码：123456

  • 后续升级，指定新版本即可

执行命令：sh restart-torna.sh <version>，如：sh restart-torna.sh 2.0.1

# 方式2：手动部署

前往 发行版页面 (opens new window) ，下载2.x版本（1.x表示社区开源版，2.x表示企业版），解压zip

导入数据库，执行mysql.sql (opens new window)

打开application.properties配置文件，修改数据库连接配置

执行sh startup.sh启动（Windows执行startup.bat）

访问：http://localhost:7700

用户名：admin，密码：123456

# 方式3：docker运行

导入数据库，执行mysql.sql (opens new window)

下载公共镜像

docker pull registry.cn-hangzhou.aliyuncs.com/tanghc/torna:2.0.1

创建配置文件，执行命令：

mkdir /etc/torna && wget https://gitee.com/durcframework/torna/raw/master/install/application.properties -O /etc/torna/application.properties

vim /etc/torna/application.properties修改数据库连接配置

执行docker命令：

docker run --name torna --restart=always \
  -p 7700:7700 \
  -e JAVA_OPTS="-server -Xms512m -Xmx512m" \
  -v /etc/torna/application.properties:/torna/config/application.properties \
  -d registry.cn-hangzhou.aliyuncs.com/tanghc/torna:2.0.1

浏览器访问http://ip:7700，ip对应docker宿主机器ip，非docker容器ip

TIP

注意:

  • torna:latest 镜像是开源版本, 企业版需要使用 2.x 版本
  • 确保数据库账号有DDL执行权限，升级过程中会自动执行DDL语句

# 获取License

使用企业版对应的功能需要有License，申请加入QQ群，找群管理获取企业版License。

使用超级管理员账号登录Torna企业版，前往【后台管理】-【系统设置】，输入License

企业版后台

企业版后台

# 常见问题

  • 没有License会不会影响使用？

不影响社区版功能使用，企业版功能有限制

  • 启动没反应或者报错Error exists in the bytecode
Exception in thread "main" java.lang.VerifyError: Expecting a stack map frame
Exception Details:
  Location:
    cn/torna/TornaApplication.run(Lorg/springframework/boot/ApplicationArguments;)V @27: athrow
  Reason:
    Error exists in the bytecode
  Bytecode:
    0000000: b100 0000 0000 0000 a7ff f900 0000 0000
    0000010: 0000 0000 0000 0000 a7ff f3bf          
  Exception Handler Table:
    bci [1, 8] => handler: 11
  Stackmap Table:
    same_frame(@1)
    same_locals_1_stack_item_frame(@11,Object[#38])

	at java.base/java.lang.Class.getDeclaredMethods0(Native Method)
	at java.base/java.lang.Class.privateGetDeclaredMethods(Class.java:3402)
	at java.base/java.lang.Class.getDeclaredMethod(Class.java:2673)
	at org.springframework.boot.loader.MainMethodRunner.run(MainMethodRunner.java:47)
	at org.springframework.boot.loader.Launcher.launch(Launcher.java:108)
	at org.springframework.boot.loader.Launcher.launch(Launcher.java:58)
	at org.springframework.boot.loader.JarLauncher.main(JarLauncher.java:88)

添加VM参数：-javaagent:$app_name.jar

nohup java -server -javaagent:$app_name.jar -Duser.timezone=Asia/Shanghai -jar -Xms512m -Xmx512m $JAVA_OPTS $app_name.jar >/dev/null 2>&1 &

← MCP →