1. 概述编辑
NAS是一种文件级别的存储设备，通过标准网络协议（如SMB/CIFS、NFS）进行文件存取，适合需要集中管理文件、备份和共享的大型组织。
一个NAS文件系统，可以同时挂载到多个节点上，由这些节点共享访问，从而节约大量拷贝与同步成本。
在帆软集群项目中，文件服务器用于存储和共享集群中所需的文件和数据资源，以确保每个节点都可以访问并使用它们。
本文主要讲解帆软集群项目如何对接NAS，作为集群文件服务：
用户可自行准备一个NAS，并进行参数调优
在部署新项目时/项目部署好后，可将项目与该文件服务器对接
2. 准备NAS和挂载共享文件夹编辑
用户需要自行准备并部署NAS。
帆软不提供相关资料和指导，仅对必要内容进行指明，请查阅相关官网获取其他帮助。
如运维能力不足，推荐使用运维平台部署新项目时，在「文件服务」中勾选「部署MinIO」即可，无需手动部署和调优。
| 步骤 | 说明 | |
|---|---|---|
| NAS端 | ||
| 1 | 准备NAS设备 | 请根据集群规模和文件服务需求，选择合适的NAS设备，帆软不做推荐 请为NAS设备配置静态IP地址，确保帆软集群各个工程节点可以稳定访问 本示例为192.168.101.100 |
| 2 | 设置NAS网络 | 文件服务和应用工程、其他组件建议在同一网段，避免网络波动等问题 文件服务和应用工程、其他组件如处于公网环境，带宽需在10M以上 文件服务和应用工程、其他组件之间需要网络畅通，互相端口可访问 |
| 3 | NAS创建共享文件夹 | 请在NAS设备上创建共享文件夹，用于存储集群中的文件数据和备份数据。 本示例文件夹位置为/data/fanruan |
| 4 | 配置访问权限 | 请设置NAS共享文件夹的访问权限，确保各个集群节点IP对该共享文件夹有读写权限 可使用合适的文件共享协议（如 NFS、SMB/CIFS） |
| 帆软集群各个工程节点 | ||
| 1 | 创建挂载点目录 | 请在帆软集群各个工程节点上，创建挂载点目录 请确保帆软集群各个工程节点的挂载点目录位置完全相同 请确保帆软集群各个工程节点的挂载点目录，不在工程外挂目录/Tomcat目录下 本示例为/home/nas |
| 2 | 挂载NAS共享文件夹 | 请根据选择的文件共享协议使用合适的语句，在帆软集群各个工程节点的挂载点目录，挂载NAS共享文件夹 文件共享协议不同，挂载方式也不尽相同，本文以NFS协议为例演示其中一个集群节点的操作： 1）使用终端访问集群节点 2）安装NFS客户端 sudo apt-get install nfs-common 3）挂载NAS共享文件夹 语句：sudo mount -t nfs <NAS_IP>:/path/to/share /mnt/nas 示例：sudo mount -t nfs 192.168.101.100:/data/fanruan /home/nas 4）设置自动挂载 编辑/etc/fstab文件，添加自动挂载条目，以实现开机自动挂载： 语句：<NAS IP>:/path/to/share /mnt/nas nfs defaults 0 0 示例：192.168.101.100:/data/fanruan /home/nas nfs defaults 0 0 |
| 3 | 验证和测试 | 确认所有集群节点都能正确访问和操作NAS上的共享文件夹 |
3. 准备工程文件编辑
3.1 创建工程文件存储目录
上节，在NAS中已经创建了一个共享文件夹。
用户需要在该文件夹中，创建子目录，用于存储工程文件和工程备份文件。
| 步骤 | |
|---|---|
| NAS创建工程文件存储目录 | 在NAS共享文件夹（示例为/data/fanruan）中，创建一个子文件夹（推荐命名为WEB-INF），用于存储工程文件 本文示例/data/fanruan/WEB-INF |
| NAS创建工程备份文件存储目录 | 无需手动创建 备份还原文件存储路径默认为../backup 即在工程文件存储目录同级，自动生成backup文件夹，用于存储平台备份 |
| 检查集群挂载点是否生成相关目录 | 登录集群各个工程节点，查看在集群挂载点（示例为/home/nas）中，是否同步生成对应的工程文件存储目录挂载点 本文示例为/home/nas/WEB-INF |
3.2 上传文件到存储目录（按需选做）
如需在部署新项目时接入NAS作为文件服务，请勿执行本步骤！
对于已部署好的工程，如需接入/替换集群文件服务，需要先将工程文件上传到NAS共享文件夹中。
如当前工程已配置文件服务，请将原文件服务器工程存储目录下的所有文件，拷贝到NAS准备的工程存储目录。请注意文件服务器类型是否支持后端拷贝等传输细节（例如minio等S3类型，必须前端下载文件再上传）
如当前工程未配置文件服务，首次接入文件服务，请将工程某个节点下的以下文件夹拷贝到NAS
| NAS父目录下文件夹 | 工程文件 | 文件夹内容说明 |
|---|---|---|
工程存储目录（一般为WEB-INF） | /webroot/WEB-INF/assets | 存放着以下内容： 工程Excel原始文件信息 FineReport模板备份文件 驱动管理上传的驱动 通用的共享持久化目录 |
| /webroot/WEB-INF/dpworks | FineDataLink任务相关的配置文件 如不存在该文件夹，说明工程没有使用FDL相关功能，可忽略 | |
| /webroot/WEB-INF/reportlets | FineReport模板存放目录 | |
| /webroot/WEB-INF/resources | 存放工程相关的资源配置文件 | |
| /webroot/WEB-INF/schedule | 定时调度生成的文件 | |
| /webroot/WEB-INF/treasures | 云端运维生成的数据包 | |
| backup | /webroot/backup | 工程历史备份文件 |
4. 准备NAS信息编辑
| 信息 | 说明 |
|---|---|
| 路径 | 即为帆软集群各个工程节点上的挂载点目录中的工程存储目录的完整路径
本文示例为3.1节在集群挂载点中生成的工程文件存储目录：/home/nas/WEB-INF/ |
5. 集群接入文件服务编辑
支持在以下情况下接入 NAS 作为集群文件服务，请根据情况自行选择，任选其一即可。
5.1 部署新集群时接入
在「部署新项目-项目设置」时，可接入自备的 NAS 作为集群文件服务。
此情况下，请确保准备的工程存储目录文件夹中内容为空，不存在任何数据，否则无法成功对接。
1）文件服务选择「对接已有文件服务」。
2）在「文件服务」信息填写处
协议：共享外部目录
路径：填写第四章准备的/集群节点挂载点目录/工程文件存储目录/
3）点击「测试连接」，提示「测试连接成功」，即代表可正常对接。
5.2 运维平台集群管理接入
项目部署成功后，在运维平台的「集群管理」中，可为项目接入自备的NAS作为文件服务。
5.2.1 使用前提
1）请务必参考3.2节，将当前工程文件上传到准备好的NAS工程文件存储目录中。
2）根据工程版本确认是否需要安装「共享外部目录」插件
FineBI6.0.15/FineReport11.0.21及之后版本，帆软集群与NAS的对接，无需依赖插件，产品直接提供相关功能
FineBI6.0.15/FineReport11.0.21之前版本，帆软集群与NAS的对接，依赖「共享外部目录」插件，需要管理员自行安装。
5.2.2 项目对接
1）管理员登录运维平台，选中指定项目。
2）点击「维护>集群管理」，对「文件服务器」进行配置。
3）输入相关信息
协议：共享外部目录
路径：填写第四章准备的/集群节点挂载点目录/工程文件存储目录/
4）点击「保存」，提示「连接成功」，即代表可正常对接。
5.3 管理系统集群管理接入
在帆软应用的「管理系统>集群管理」中，可为项目接入自备的NAS作为文件服务。
5.3.1 使用前提
1）请务必参考3.2节，将当前工程文件上传到准备好的NAS工程文件存储目录中。
2）根据工程版本确认是否需要安装「共享外部目录」插件
FineBI6.0.15/FineReport11.0.21及之后版本，帆软集群与NAS的对接，无需依赖插件，产品直接提供相关功能
FineBI6.0.15/FineReport11.0.21之前版本，帆软集群与NAS的对接，依赖「共享外部目录」插件，需要管理员自行安装。
5.3.2 项目对接
1）管理员登录帆软应用，点击「管理系统>智能运维>集群配置」。
2）在开启了状态服务器的前提下，在文件一致设置中选择「文件服务器共享」。
3）点击「编辑」填写相关信息，点击「测试连接并保存」，提示「测试连接成功」，即代表可正常对接。
协议：共享外部目录
路径：填写第四章准备的/集群节点挂载点目录/工程文件存储目录/
