1. 概述
1.1 版本
信创版帆软产品最低支持版本 | 功能变动 |
|---|---|
FineReport11.0.9 FineBI6.0.4 FineDataLink4.0.19 | - |
1.2 功能简介
帆软应用中，管理员往往会在平台设置用户、挂载目录、分配权限、设定定时调度。这些配置，均存储于配置库中。
运维平台部署的信创版FineBI中，包含一个MySQL8数据库，作为配置存储组件。
如需实现全栈信创，用户需自行准备一个数据库，并新建全新表空间，并进行参数调优、在帆软项目部署结束后，用户可将项目与该信创数据库对接，将原有配置信息迁移到该数据库中，作为配置存储组件。
注：若配置了外接数据库，请勿轻易修改外接数据库的用户名和密码，否则会导致工程启动失败。
如需修改，请参照：修改外接数据库账号密码 。
2. 准备配置库
用户需要自行准备并部署DM数据库和表空间。
帆软不提供相关资料和指导，仅对必要内容进行指明，请查阅数据库官网获取其他帮助。
2.1 数据库版本
本文列出的是帆软测试通过的环境。
本文提及的配置库，仅适用于信创版本帆软产品
本文未提及的更低版本，一般默认不支持，或存在一些漏洞，不建议使用
本文未提及的更高版本，用户可自行测试验证。如果出现问题，付费用户可联系技术支持获取帮助。技术支持联系方式：「服务平台>在线支持」
| 数据库类型 | 信创版帆软产品最低支持版本 | 数据库版本 |
|---|---|---|
| 达梦DM | FineReport11.0.9 FineBI6.0.4 FineDataLink4.0.19 | 8.0 |
2.2 服务器配置
| 配置类型 | 最低配置 | 推荐配置 | 注意事项 |
|---|---|---|---|
| 内存 | 1GB | 2GB | 内存，是指分配给配置库的内存，而非服务器的所有内存 如有条件，建议配置库独占一台服务器 如条件不足，至少确保部署配置库的服务器中，不部署帆软应用以外的任何内容，且确保分配给配置库的内存足够 |
| CPU | 4核 | 8核 | - |
| 网速 | 50Mbps | 100Mbps | 配置库和应用工程、其他组件建议在同一网段，避免网络波动等问题 配置库和应用工程、其他组件之间需要网络畅通，互相端口可访问 |
| finedb占用空间 | 1GB | 2GB | 占用空间，请结合工程使用度进行调整 建议根据推荐配置，增大1~2倍，预留足够空间 |
| 服务器磁盘空间 | 100GB | 200GB | - |
| 服务器磁盘读写速度 | 50MB/S | 100MB/S | - |
2.3 新建表空间
不同帆软工程，不可共用同一个数据库表空间作为配置库，否则数据可能会出现错乱。
因此建议在数据库中新建一个表空间，用于存储相关配置数据。
请注意并准备以下内容：
| 配置 | 说明 |
|---|---|
| 表空间名称 | 推荐使用finedb |
| 数据库用户名 | 由于一般选择用户同名模式，且达梦数据库推荐开启大小写敏感后模式名会转为纯大写，因此用户名称建议仅包含数字、大写字母，不包含其他任何特殊字符 |
| 数据库用户密码 | 配置库对接成功后，请勿轻易修改所使用的数据库用户名和密码，否则会导致工程启动失败 如需修改，详情请参见：修改外接数据库账号密码 。 |
| 数据库用户权限 | 用户需要具备 create、delete、alter、update、select、insert、index 权限 |
| 表空间存储内容 | 该表空间内不建议存放其他任何数据，包括业务数据、日志数据等 |
2.4 配置库其他要求
| 大小写敏感 | 建议达梦数据库配置case_sensitive=1 开启达梦数据库的大小写敏感，避免因数据重复识别导致写入异常 例如 Employee 和 EMPLOYEE 会被视为不同的对象 配置方法请参考达梦官方文档，帆软不提供配置指导 |
| 空字符串处理方式 | 建议达梦数据库配置compatible_mode=0 严格区分 '' 和 NULL，避免因空字符串误读导致功能使用异常 '' 视为长度为 0 的字符串，NULL 表示未知或缺失值 配置方法请参考达梦官方文档，帆软不提供配置指导 |
3. 对接准备
3.1 工程上传配置库驱动
信创类配置库，需要依赖数据库驱动，才能正常与帆软应用对接运行。
对于运维平台部署的信创版帆软项目，需要手动上传所需配置库驱动。否则项目重启后可能因读取不到配置库驱动，而无法连接配置库，导致工程访问异常。
| 1）点击下载驱动文件 | |
| 2）上传驱动到工程组件下 | 请将该驱动文件上传至信创工程的每个bi-web/fr/fdl容器外挂目录的/customlib/lib文件夹下
|
| 3）重启帆软项目 | 驱动全部放置完毕后，请使用运维平台的「维护>组件管理」功能重启全部bi-web/fr/fdl容器，并等待容器状态至 healthy，以使驱动生效
|
3.2 检查工程启动用户权限
请确保启动帆软应用的服务器用户，有帆软应用工程文件的读写权限，否则无法正确对接配置库。
3.3 准备配置库信息
| 设置项 | 说明 |
|---|---|
| 数据库类型 | 选择 dm |
| 驱动 | 无需手动修改，一般默认为dm.jdbc.driver.DmDriver |
| 数据库名称 | 填写2.3节新建的表空间的名称 只允许包含数字、字母、下划线、「-」和「.」 |
| 主机/端口 | 填写2.3节配置库所在服务器的IP和端口 |
用户名/密码 | 填写2.3节准备的数据库用户名称和密码 用户需要具备 create、delete、alter、update、select、insert、index 权限 由于一般选择用户同名模式，且达梦数据库推荐开启大小写敏感后模式名会转为纯大写，因此用户名称建议仅包含数字、大写字母，不包含其他任何特殊字符 |
| 模式 | 一般无需手动输入，在配置外接库时，正确填写完上面几项设置后，点击模式下拉框中的「点击连接数据库」，系统将自动连接该数据库并读取所有模式，选择与用户名相同的即可 优先选择和数据库用户的名字相同的模式 数据库模式名称仅支持包含数字、字母 设置了大小写敏感的达梦数据库，模式名称会自动转为大写。最新版达梦驱动对达梦数据库的模式名称校验非常严格，切勿使用不正确的模式名称连接，否则会导致连接/迁移失败。请在重启或更新工程前确保所选的模式名为大写
|
4. 配置外接数据库
支持在以下情况下接入达梦DM数据库作为外接配置库，请根据情况自行选择即可。
4.1 运维平台集群管理接入
在运维平台的「集群管理」中，可为项目接入自备的达梦DM数据库作为配置库。
4.1.1 确保运维平台版本
对于多应用项目，V2.30.0及以上版本的运维平台为项目对接配置服务时，支持直接切换。
对于多应用项目，V2.29.0及以下版本的运维平台，需要确保接入/迁移配置服务时仅存活一个应用节点。
本文以最新版运维平台的操作步骤提供指导，因此请确保当前运维平台版本在V2.30.0及以上版本。
4.1.2 配置外接配置库
1）管理员登录运维平台，选中指定项目。点击「维护>集群管理」，对「外接配置库」进行配置。
2）输入相关信息
数据库类型：选择「Dm」
驱动：无需调整，选择「dm.jdbc.driver.DmDriver」即可
数据库名称、主机、端口、用户名、密码、模式：填写3.3节准备的配置库信息即可
数据连接URL：一般无需手动修改，会由其他配置和预设参数共同组成
3）选择是否「迁移数据至要启用的数据库」
| 情况 | 新配置库情况 |
|---|---|
| 希望使用当前项目原有配置 | 1）必须勾选「迁移数据至要启用的数据库」 2）项目与该配置库对接成功后，会将工程原有配置数据，迁移到该表空间中 3）无论准备的新表空间中是否有数据，均会被清空，无法找回 |
希望使用其他项目配置 （例如将正式环境配置，拷贝一份给测试环境使用） | 1）自行将准备的配置数据上传到新表空间中 必须确保所准备的数据，对应的项目 JAR 包版本和当前项目的 JAR 包版本完全一致，否则无法使用 2）不勾选「迁移数据至要启用的数据库」 3）项目与该配置库对接成功后，会使用表空间中的数据，作为项目的配置 4）项目原有配置的对接信息，会备份到工程config目录下的db.properties.bak文件中 |
4）点击「启用数据库」，提示「迁移成功」，即代表可正常对接。
4.2 管理系统接入配置库
在帆软应用的「管理系统>管理系统>常规」中，可接入自备的数据库作为配置库。
4.2.1 确保单应用存活（多应用服务工程须完成，单应用服务工程无需）
对于多应用项目，需要确保接入/迁移配置服务时仅存活一个应用节点。
管理员登录运维平台，选中指定项目。点击「维护>组件管理」。检查是否有多个「bi-web/fr/fdl」容器存活。
如果有，请点击容器的「停止」按钮，确保将其他「bi-web/fr/fdl」容器关停至「exited」状态，仅保留一个容器存活。
注：如为非运维平台部署的项目，请参考「 关闭或重启FineBI工程」文档，关闭集群下的其他「bi/fr/fdl」应用，仅保留单个应用存活。
4.2.2 配置外接配置库
1）管理员登录帆软应用，点击「管理系统>管理系统>常规」。找到「外接数据库」，点击配置。
2）输入相关信息
数据库类型：选择「Dm」
驱动：无需调整，选择「dm.jdbc.driver.DmDriver」即可
数据库名称、主机、端口、用户名、密码、模式：填写3.3节准备的配置库信息即可
数据连接URL：一般无需手动修改，会由其他配置和预设参数共同组成
3）选择是否「迁移数据至要启用的数据库」
| 情况 | 新配置库情况 |
|---|---|
| 希望使用当前项目原有配置 | 1）必须勾选「迁移数据至要启用的数据库」 2）项目与该配置库对接成功后，会将工程原有配置数据，迁移到该表空间中 3）无论准备的新表空间中是否有数据，均会被清空，无法找回 |
希望使用其他项目配置 （例如将正式环境配置，拷贝一份给测试环境使用） | 1）自行将准备的配置数据上传到新表空间中 必须确保所准备的数据，对应的项目 JAR 包版本和当前项目的 JAR 包版本完全一致，否则无法使用 2）不勾选「迁移数据至要启用的数据库」 3）项目与该配置库对接成功后，会使用表空间中的数据，作为项目的配置 4）项目原有配置的对接信息，会备份到工程config目录下的db.properties.bak文件中 |
4）点击「启用数据库」，提示「迁移成功」，即代表可正常对接。
4.2.3 确保多应用配置同步（多应用服务工程须完成，单应用服务工程无需）
1）拷贝db.properties文件
前往唯一存活的「bi-web/fr/fdl」容器所在服务器，复制该组件外挂目录/config文件夹中的db.properties文件。
逐一粘贴到其他「bi-web/fr/fdl」容器所在服务器的组件外挂目录/config文件夹中。
注：如为非运维平台部署的项目，请将唯一存活的「bi/fr/fdl」应用目录/webroot/WEB-INF/embed文件夹中的db.properties文件，逐一拷贝到其他「bi/fr/fdl」应用目录/webroot/WEB-INF/embed文件夹中
2）停止所有应用
管理员登录运维平台，选中指定项目，点击「维护>组件管理」
请对「bi-web/fr/fdl」组件进行一键「停止」，确保所有「bi-web/fr/fdl」容器关停至「exited」状态。
注：如为非运维平台部署的项目，请参考「 关闭或重启FineBI工程」文档，关闭剩余唯一存活的「bi/fr/fdl」应用。
3）启动所有应用
管理员登录运维平台，选中指定项目，点击「维护>组件管理」。
请对「bi-web/fr/fdl」组件进行一键「启动」，确保所有「bi-web/fr/fdl」容器启动至「running」状态。
注：如为非运维平台部署的项目，请参考「 关闭或重启FineBI工程」文档，逐一重启集群下的所有「bi/fr/fdl」应用。
5. 注意事项
5.1 未放置驱动导致工程启动失败
运维平台部署的信创工程，如果使用了信创配置库，必须手动上传信创驱动到customlib/lib下（只需要操作一次），后续进行重启工程等操作，才不会影响工程使用。
否则工程重启后可能由于读取不到信创驱动，而无法连接配置库，导致工程访问异常。
具体操作步骤请参考本文 3.1 节
5.2 模式名错误导致工程启动失败
问题描述：
达梦数据库不同版本的驱动，对数据库模式的正确性要求不同。
11.5.7版本，产品内置的达梦数据库驱动更新了，如果外接配置库中使用的模式名不正确，帆软应用重启后就无法正常进入工程。
解决方案：
1）如需手动更换产品内置的达梦数据库驱动，请先检查外接配置库中的数据库模式名称
优先选择和数据库用户的名字相同的模式
数据库模式名称仅支持包含数字、字母
设置了大小写敏感的达梦数据库，模式名称会自动转为大写。请确保所选的模式名为大写，或手动调整为大写，否则会导致连接/迁移失败。
2）如已经更换重启，无法正常进入工程。
找到db.properties文件，找到hibernate.connection.url配置值，修改其中的模式名为正确值。
运维平台部署的项目：前往每个「bi-web/fr/fdl」容器所在服务器，在该组件外挂目录/config文件夹中可以找到该文件
非运维平台部署的项目：前往每个「bi/fr/fdl」应用目录/webroot/WEB-INF/embed文件夹中可以找到该文件
上一篇：外接数据库注册
