BeX5平台简明部署过程

优质

小牛编辑

128浏览

2023-12-01

注：详细布署请参考：BeX5安装布署

该文章主要介绍BeX5平台开发完成后，资源部署至正式环境的过程。

一、获取BeX5企业快速开发平台版本，版本自带有tomcat服务和mysql数据库。
二、将BeX5版本解压至服务器的相应目录，生成key文件，申请注册码，进行注册。（注意：平台不能放在有中文的目录下）
三、 BeX5版本数据源默认包含：system 、doc和demo。根据系统情况配置数据源，也可添加其他不同名的数据源。（system是系统库数据源必须存在，doc是文档库数据源，demo是演示库数据源）运行“配置初始化其它数据库.bat”，按提示选择即可。
四、如使用自带MySQL数据库，点击版本下的“启动MySQL数据库.bat”启动即可，默认端口为3306，用户名root，密码x5。
五、将开发环境中Biz和UI目录下的应用目录（除system、sa、portal、portal2等版本自带目录）对应复制到BeX5正式环境版本的Biz和UI目录下。
六、初次部署时，建议要对BIZ下的应用目录进行模型编译，UI下的应用目录进行源码编译。
七、资源有变更时，需要修改UIServer\WEB-INF\justep.xml中的version资源版本号，只要有变化就可以。（X5 缓存机制和资源版本号维护）
八、更新部署时，如应用目录的BIZ下有src目录需在正式环境下进行编译，如没有，则不需编译。
九、最后，删除UI目录下的.cache缓存文件。
十、点击版本下的“启动BeX5运行平台.bat”，启动平台服务即可。平台默认tomcat服务端口为8080。服务访问地址为 http://IP:8080/x5

【常见部署问题】
1） MySQL数据库服务无法正常启动。检查MySQL端口3306是否被占用。如被占用，Mysql\my.ini文件中修改端口port。

2）启动BeX5运行平台无法正常启动。确认使用的BeX5企业快速开发平台版本，如果是推广版，默认是64位jdk，需在64位服务器上运行。如需在32位上运行，需修改使用32位jdk才可以正常运行。

3）检查8080、8005、8009端口是否被占用。如被占用，apache-tomcat\conf\sever.xml文件中修改端口，如果是V3.2.1（包含V3.2.1）之后的版本，还需修改%JUSTEP_HOME%/conf/server.xml中的8080端口。如果是V3.2.1之前的版本，还需修改%JUSTEP_HOME%/runtime下BusinessServer 、DocServer 、ReportServer 、UIServer 下的justep.xml配置的8080端口也需同步修改。

4）如需修改数据源，请使用“配置初始化其它数据库.bat”工具进行配置，或者在apache-tomcat\conf\context.xml文件中修改。

5）平台默认访问地址是http://IP:8080/x5，如需修改“/x5”，需修改apache-tomcat\conf\Catalina\localhost\下的x5.xml文件名，%JUSTEP_HOME%/conf/server.xml中的<ui-server>http://localhost:8080/x5</ui-server>也需同步修改。

6）license-server的地址配置。如果是3.2.1（包含V3.2.1）之后的版本，配置在%JUSTEP_HOME%/conf/server.xml中。这个文件中已有license-server地址的配置，<license-server>http://localhost:9090/LicenseServer</license-server>默认是注释的，放开改成license-server的实际IP地址即可。如果是V3.2.1之前的版本，在%JUSTEP_HOME%/runtime下BusinessServer下的justep.xml文件中添加<license-server>的地址参数即可。