配置指南【文件服务器配置指南】YonBIPV3.0(R5_2312_1)高级版用友网络科技股份有限公司1配置指南用友商业创新平台版权未经用友集团的书面许可，本产品说明任何整体或部分的内容不得被复制、复印、翻译或缩减以用于任何目的。本产品说明的内容在未经通知的情形下可能会发生改变，敬请留意。请注意：本产品说明的内容并不代表用友所做的承诺。用友网络科技股份有限公司2配置指南用友商业创新平台1.框架概要文件服务器(UFS)基本功能实现文件的上传、下载、查询、预览、删除等基本文件存储操作，文件服务器（UFS）实现单据附件存储管理功能。文件服务器（UFS）支持多种存储模式，满足不同的业务场景，经典模式下包括磁盘存储、FTP存储和MongoDB存储，项目使用根据实际情况选择部署方式。2.注意事项1)YonBIPV3.0(R5_2312_1)高级版支持附件在线预览功能，点击附件即可在线预览附件内容。2)要求环境必须配置文件服务器，否则导致部分功能使用异常。如：单据附件、导入导出、后台任务、预警、报表订阅等。3)文件服务器存储模式使用后，不可再修改，否则造成已上传附件丢失无法使用。4)在线预览pdf文档性能优异，建议单据附件使用pdf格式5)文件服务器与应用服务器部署在同一个网段，通过千兆交换机互联。避免因与应用服务器频繁的附件上传下载造成网络问题3.部署说明集中部署情况是文件服务器（UFS）与YonBIPV3.0(R5_2312_1)高级版服务集成，既提供业务也提供文件服务。3.1配置界面说明文件服务器基本配置可以通过HOME/bin/sysConfig配置工具实现基本服务配置，选择对应的存储模式，填写服务器IP地址、服务器端口、元数据仓库根据存储模式，填写相关模式所使用到信息用友网络科技股份有限公司3配置指南用友商业创新平台3.2场景详细说明基于业务系统部署架构不同，分为单机、集群部署架构，不同部署架构，场景详细描述如下：附件上传、下载、删除操作均不涉及内外网配置，文件服务器地址均可配置内网地址。1)单机：文件服务器（UFS）服务器IP地址及端口配置为业务访问地址信息。2)集群环境：垂直集群：文件服务器（UFS）服务器IP地址及端口配置为业务访问地址信息水平集群：磁盘存储模式：文件服务器（UFS）服务器IP地址及端口需要选定集群中某一SERVER作为文件服务器（UFS）服务端，而其他节点相当于是文件服务器（UFS）的客户端。FTP存储与MongoDB存储模式：文件服务器（UFS）服务器IP地址及端口配置为业务访问地址信息特殊说明：水平集群磁盘存储模式：磁盘存储路径为共享磁盘，并且每台集群都能访问到存储路径，并具有读写权限情况下，服务器IP地址及端口可配置业务访问地址信息。如上业务访问地址均指内网地址4.存储模式配置4.1磁盘存储磁盘存储根据所设定存储路径，将系统产生附件，存储于指定的路径下。用友网络科技股份有限公司4配置指南用友商业创新平台存储模式：磁盘存储服务器IP地址、服务器端口根据第3节部署说明进行设置元数据仓库：指定数据源，用于存储附件相关数据（不是附件），元数据仓库指定后，不要修改，否则导致历史附件在系统中无法查到。存储路径：附件实际存放地址，路径分隔符必须是“/”，如上图附件将存储于/data/$home/fs路径，项目实施部署请根据实际情况设置具体路径，同时避免与其他路径相冲突。4.2FTP存储附件存储于指定的FTP服务器，实现附件存储管理，配置前请先搭建FTP服务。存储模式：FTP存储服务器IP地址、服务器端口根据第3节部署说明元数据仓库：指定数据源，用于存储附件相关数据（不是附件），元数据仓库指定后，不要修改，否则导致历史附用友网络科技股份有限公司5配置指南用友商业创新平台件无法使用FTP配置：填写FTP服务IP地址、端口、用户名、密码信息传输模式：binary4.3MongoDB存储MongoDB数据库附件存储，实现附件存储管理，支持单机以及副本集模式，独立部署。存储模式：MongDB存储服务器IP地址、服务器端口根据第3节部署说明元数据仓库：指定数据源，用于存储附件相关数据（不是附件），元数据仓库指定后，不要修改，否则导致历史附件无法使用MongoDB配置：勾选独立部署IP地址、端口：单机模式填写IP端口即可副本集模式IP地址通过;分割（如：10.1.1.10;10.1.1.11;10.1.1.12），端口号也通过;分割MongoDB库名称：勾选启用授权，进行权限校验填写用户名、密码用友网络科技股份有限公司6配置指南用友商业创新平台5.附件预览配置5.1内网配置当业务系统只有内网访问地址，sysConfig文件服务器配置业务系统访问地址，不需要特殊处理。5.2内外网配置当使用场景满足以下条件时，需要进行特殊配置：1）用户涉及内外网地址共用2）使用附件在线预览功能在sysconfig中完成文件服务器基础配置后，手动编辑HOME/ierp/sf/ufsconfig/ufs_net.properties配置文件各参数含义：#是否启用文件服务器内外网环境配置，设置为trueufs.config.wlan.config=true#外网访问地址协议http、httpsufs.config.wlan.protocal=#配置文件服务器所映射的外网IPufs.config.wlan.ip=#配置文件服务器所映射的外网端口ufs.config.wlan.port=#文件服务器所在内网的子网掩码ufs.config.intranet.mask=#指定的特殊的网段，来自该网段请求的URL认为内网连接，不使用该配置文件设置的地址，使用sysConfig中配置的地址，配置可以使用*进行模糊匹配（如10.10.*.*）ufs.config.intranet.case=5.3特殊场景业务系统部署架构水平集群部署，文件服务器使用磁盘存储（非共享磁盘），同时业务系统访问协议HTTPS。根据第3.2节水平集群磁盘部署说明，文件服务器需要配置集群中某一SERVER（HTTP），但是在业务系统进行附件预览时，会将请求文件服务器协议转换为HTTPS，导致找不到后端文件服务器地址，无法预览附件。用友网络科技股份有限公司7配置指南用友商业创新平台解决方案1)需要在负载均衡转发规则添加，将/fs请求转发到文件服务器地址ProxyPass/fs/http://10.10.18.60:9081/fs/ProxyPassReverse/fs/http://10.10.18.60:9081/fs/注释：10.10.18.60:9081为配置文件服务器地址，需根据实际情况修改2)修改\ierp\sf\ufsconfig\ufs_net.properties配置文件ufs.config.wlan.config=true#访问地址协议http、httpsufs.config.wlan.protocal=https#配置文件服务器所映射的外网IP/域名ufs.config.wlan.ip=#配置文件服务器所映射的端口ufs.config.wlan.port=#文件服务器所在内网的子网掩码ufs.config.intranet.mask=#指定的特殊的网段，来自该网段请求的URL认为内网连接，不使用该配置文件设置的地址，使用sysConfig中配置的地址，配置可以使用*进行模糊匹配（如10.10.*.*）ufs.config.intranet.case=注意事项：不建议使用此种配置方式，因为文件服务器存在单点故障6.系统参数配置6.1文件格式限制业务系统对附件格式做了一定限制，只有满足业务系统所设定才允许上传，否则提示“上传附件不满足格式”如上传附加不满足业务要求，请使用系统管理员系统参数设置，进行调整用友网络科技股份有限公司8配置指南用友商业创新平台参数值根据需求，设置可上传的文件类型后缀(可配置多个用"|"分割,例如:doc|ppt|mp4)6.2文件大小限制考虑项目实际情况以及附件过大对网络带宽占用，系统中对单个附件大小进行了控制，系统出场默认大小为10M，当该参数不能满足用户需求时，可动态调整使用系统管理员系统参数设置，允许单个附件最大值50M。7.文件服务器升级文件服务器升级，保持存储模式与升级前一致，并记录升级前文件服务器配置信息服务器IP地址及端口：配置为升级后业务系统访问地址（参照第4节部署说明）元数据仓库：与升级前数据库一致1)磁盘存储存储路径与升级前一致，并确保将升级前附件拷贝到新的服务器2)FTP存储配置升级前FTP存储信息3)MongoDB存储配置升级前MongoDb存储信息用友网络科技股份有限公司9配置指南用友商业创新平台用友网络科技股份有限公司YonyouNetworkTechCo.Ltd.
