NC6.5 文件服务器操作手册

用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 YONYOU NC 6 5 文件服务器操作手册文件服务器操作手册 2015 年 12 月 版权所有 c 2015 用友网络科技股份有限公司 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 2 目录 YONYOU NC 6 5 文件服务器操作手册文件服务器操作手册 1 1 系统框架系统框架 4 1 1 高效性 4 1 2 安全性 4 1 3 可靠存储 4 2 部署方案部署方案 4 2 1 集中部署 5 2 2 独立部署 5 3 SYSCONFIG配置配置 6 3 1 服务器配置 6 3 2 文件服务器配置 6 4 管理控制台管理控制台 7 4 1 服务配置 8 4 1 1 默认存储配置 9 4 1 2 磁盘存储配置 10 4 1 3 FTP存储配置 11 4 1 4 配置文件 12 4 2 模块管理 12 4 2 1 模块简介 12 4 2 2 查询模块 13 4 2 3 添加模块 13 4 2 4 修改模块 13 4 2 5 删除模块 14 4 2 6 属性介绍 14 4 3 日志监控 15 4 3 1 访问日志 15 4 3 2 执行日志 16 4 4 导入 导出 17 4 4 1 导出 17 4 4 2 导入 18 4 5 版本升级 18 4 6 诊断 19 4 6 1 上传 19 4 6 2 下载 20 4 6 3 删除 20 5 文件服务器升级文件服务器升级 22 5 1 升级注意事项 22 5 2 升级检查 22 5 3 升级安装 23 6 文件服务器内外网配置文件服务器内外网配置 23 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 3 6 1 注意事项 23 6 2 单机环境配置 24 6 3 集群环境配置 25 7 常见问题常见问题 25 7 1 附件具体存储位置 25 7 2 磁盘存储模式文件存储路径调整 25 7 3 独立部署文件服务器时使用HTTPS协议无法上传文件 26 7 4 文件服务器中配置MONGODB集群地址 26 7 5 中间件配置多个数据源时 27 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 4 1 系统系统框架框架 文件服务器 UFS 的基本功能是实现文件的上传 下载 查询 删除等基本文件存储操作 UFS 在实现 基本存储功能的同时 关注如何高效 可靠的管理文件来满足业务的需求 其系统框架如图 1 1 所示 图 1 1 1 11 1 高效性高效性 UFS 是基于元数据来管理文件及其版本信息 同时支持扩展文件的元数据信息 方便业务系统定制查 询策略 文件的元数据信息一般存储在关系数据库中 通过元数据可以有效的定位真实的物理文件 1 21 2 安全性安全性 UFS 支持加密和压缩存储 文件的存储是否使用加密和压缩可以设置所使用 Bucket 同模块 的属性 此外 UFS 还可以对远程的访问用户进行安全校验 防止其恶意访问文件服务器 1 31 3 可靠存储可靠存储 UFS 支持多种存储模式 满足不同的业务场景 包括磁盘存储 FTP 存储和 MongoDB 存储 为了满足 文件存储的可靠性要求 默认配置为 MongoDB 存储作为文件的存储模式 2 部署部署方案方案 UFS 支持独立部署 实施人员可以将其与应用服务器一起部署 也可以分开部署 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 5 注意事项 注意事项 文件服务器与应用服务器尽量部署在同一个网段 通过千兆交换机互联 避免因为与应用 服务器频繁的数据上传下载造成网络问题 2 12 1 集中集中部署部署 集中部署情况是 UFS Server 和 NC Server 部署在相同的机器中 如图 2 1 所示 若是单机则 UFS 配 置为本地的信息即可 若是集群环境则需要选定一台机器作为 UFS 的服务端 而其他节点相当于是 UFS 的 客户端 图 2 1 2 22 2 独立独立部署部署 独立部署 图 2 2 支持以独立的文件存储集群对外提供存储服务 文件的存储支持集中存储和第三方 文件系统存储 图 2 2 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 6 3 sysConfig配置配置 3 13 1 服务器配置服务器配置 服务器配置协议类型 可选 http 和 https 两种 配置 https 需先配置 http 协议 而且需要输 入证书密码 可参考下图 图 3 1 3 23 2 文件服务器配置文件服务器配置 文件服务器配置 包括基本文件服务器的配置信息 ip 端口等 同时包括存储模式的配置 下拉框可 以选择不同的存储模式 磁盘存储 MongoDB 存储 Ftp 存储 进行配置 各模式详细配置请参看 4 1 节 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 7 图 3 2 4 管理控制台管理控制台 sysConfig 里可以配置文件服务器的配置选项 65 版本中 保留 sysConfig 配置的同时 将此功能同 步到页面的管理控制台中 使用与配置更加方便快捷 这两处的配置是一致的 UFS Web管理控制台访问地址 http IP PORT fs console html 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 8 图 4 1 登录的用户名和密码是相应 http IP PORT admin jsp具有超级管理员权限的用户名和密码 如root super 当密码为空时 无法登陆 需登陆 http IP PORT admin jsp修改相应用户密码后再登录 4 14 1 服务配置服务配置 UFS 支持三种存储配置方式 分别为默认存储 MongoDB 存储 磁盘存储和 FTP 存储 在正式使用系 统之前需要选定一种存储模式并对其正确配置 为了有更好的性能和安全性 推荐使用MongoDB存储模式 上传超大附件推荐选择 FTP 存储模式 注意事项 注意事项 1 NC65 环境必须配置文件服务器 如不配置 会导致很多功能使用报错 如 后台任务 预警 报 表订阅等等 2 文件服务器存储模式被使用后 不可再修改 否则上传的文件将无法下载 3 磁盘存储和 MongoDB 存储最大支持 60MB 文件的上传 若要支持大于 60MB 的文件请调整 Java 堆 内存大小 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 9 4 1 1 默认默认存储存储配置配置 图 4 2 服务配置 服务器 IP 地址 环境 IP 服务器端口 环境端口 元数据仓库 即从 nchome ierp bin prop xml 中读取的数据源 启用安全访问 是否使用 https 协议 MongoDB 存储配置 独立部署 IP 地址 MongoDB 所在 IP 端口 MongoDB 的端口 数据存储目录 MongoDB 文件夹的上层目录 MongoDB 仅支持 windows 和 Linux 操作系 统 不支持 Sparc 和 AIX 操作系统 存储服务状态 MongoDB 的状态 点击刷新按钮 即可看到服务是否在运行 注意事项 注意事项 1 Linux 启动 MongoDB 时首先要给可执行权限 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 10 图 4 3 2 在 MongoDB 服务器能查看到进程 图 4 4 3 可以通过搭建 MongoDB 集群环境 进一步提高文件存取效率 图 4 5 4 1 2 磁盘磁盘存储配置存储配置 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 11 图 4 6 服务配置 服务器 IP 地址 环境 IP 服务器端口 环境端口 元数据仓库 即从 nchome ierp bin prop xml 中读取的数据源 启用安全访问 是否使用 https 协议 磁盘存储配置 存储路径 上传的文件存储路径 要保证此目录在服务器上存在 4 1 3 FTPFTP存储存储配置配置 图 4 7 服务配置 服务器 IP 地址 环境 IP 服务器端口 环境端口 元数据仓库 即从 nchome ierp bin prop xml 中读取的数据源 启用安全访问 是否使用 https 协议 FTP 存储配置 IP 地址 FTP 服务的 IP 地址 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 12 端口 FTP 服务的端口 用户名 FTP 服务的用户名 密码 FTP 服务的密码 传输模式 Binary 建议使用 Binary 否则会丢失数据 配置好基本信息后可以对服务配置的 IP 和 PORT 进行链接测试 即点击页面上的测试按钮来进行测试 若测试通过则表示可以与远程文件服务器建立网络链接 图 4 8 配置好文件的各项信息后需要通过 保存 或 集群同步 将配置的信息保存到服务器上 在保存完 信息后需要重启服务才可使配置信息生效 4 1 4 配置配置文件文件 UFS 配置文件路径 nchome ierp sf ufsconfig ufs properties 配置文件内容与界面内容保持一 致 4 24 2 模块模块管理管理 4 2 1 模块简介模块简介 文件服务器中的模块 可以理解成一种命名空间 Bucket 上传文件时指定模块 文件会存储到模块 对应的存储路径下 下载文件时指定模块 服务器会去模块对应的存储路径下取文件下载 模块管理提供 一个默认的模块 default 默认 上传和下载不指定模块 bucket 时 使用默认的模块配置 默认模块的加密 压缩和访问控制属性都是不启用的 NC 通用场景下 建议采用默认设置即可 无需 关心模块设置 但如果对文件安全性要求比较高 比如想对文件做加密 压缩处理时 可以通过添加一个 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 13 新的模块 配置加密 压缩属性 然后上传到新增的模块即可 另外 如果通过 SDK 方式访问文件服务器 并且需要增加访问控制时 需要配置模块 并将模块的密钥作为 SDK 接口的参数使用 4 2 2 查询模块查询模块 点击左侧模块管理 会列出所有模块信息 图 4 9 4 2 3 添加模块添加模块 点击添加模块按钮 可以增加新的模块 模块名称不允许重复 图 4 10 4 2 4 修改模块修改模块 点击模块列表中的编辑 即可进入模块修改的页面 模块名称不支持修改 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 14 图 4 11 4 2 5 删除模块删除模块 预置的模块不可以删除 模块下已有文件时 不允许删除 图 4 12 4 2 6 属性介绍属性介绍 1 是否预置 是否预置属性可以取值为 Y YES 和 N NO Y 代表是预置模块 一般通过数据库脚本添加预置模块 N 代表非预置模块 通过管理控制台添加的模块都是非预置模块 预置的模块不可以删除 即使预置的模 块下面没有任何文件 非预置的模块 如果下面不包含任务文件 是可以删除的 2 是否加密 是否加密属性可以取值为 YES 和 NO YES 代表启用加密 当上传文件到该模块下时 文件内容会被 加密处理 也就是说存储在文件服务器上的文件是经过加密的 一般对文件安全性要求比较高的场景 建 议启用加密属性 注 如果存储方式是 FTP 存储 则此处的加密属性不会生效 文件不会被加密处理 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 15 3 是否压缩 是否压缩属性可以取值为 YES 和 NO YES 代表启用压缩 上传文件到该模块下时 文件内容会被压 缩处理 存储在文件服务器上的文件时压缩后的文件 一般在文件比较大时 建议启用压缩属性 可以减 少文件在服务器端占用的空间 注 如果存储方式是 FTP 存储 则此处的压缩属性不会生效 文件不会被压缩处理 4 访问控制 访问控制属性可以取值为 YES 和 NO YES 代表启用访问控制 启用访问控制后 服务端会对请求进 行校验 包括请求参数 签名等 校验不通过 请求会被拒绝 访问控制与密钥是配合着使用的 下面会 详细介绍密钥 5 密钥 密钥是配合着访问控制使用的 在访问控制被启用之后 密钥会自动生成 可以通过查看连接 查看 对应的密钥 密钥可更新 启用访问控制后 客户端上传 下载文件时 需传入相应模块对应的密钥 如 果密钥设置不对 请求访问不会通过 上传 下载失败 4 34 3 日志监控日志监控 4 3 1 访问日志访问日志 访问日志可以选择是否启用 勾选启用并保存及开启访问日志功能 启动访问日志后文件服务器会记 录链接文件服务器的请求信息 请求信息主要包括 客户端 IP 登录的用户名 操作类型 请求的 URL 对应操作的文件内容 操作开始时间和操作结束时间 图 4 13 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 16 访问日志可以用于查看每次用户访问文件服务器的具体操作信息 在上图 3 13 中日志信息主要是本 地上传附件到 test 模块下 访问日志记录数过多可以点击 清空 按钮进行清空数据操作 还可 以根据指定的条件刷选日志信息 图 4 14 可用的过滤条件 client 127 0 0 1 requestUser UAP operType POST requestURL fs service test files content test c7a39695 0f12 4979 a9c8 cf1e9f93e491 startTime 2015 09 25 14 03 02 endTime 2015 09 25 14 03 03 4 3 2 执行日志执行日志 当 UFS 功能出现异常时 可以通过执行日志来查看具体的日志信息 进而排查错误 执行日志的功 能是将后台日志文件的最新内容显示在页面上 方便远程查看 错误信息 执行 日志中默认最多加载最新 的 500 行日志内容 在加载的日志中可以通过搜索 UFS 字符串 来快速定位文件服务器的错误信息 执行日志默认加载的是文件服务器专有的日志文件 nclogs server uapfs log 若该文件不存在则加载 nclogs server nc log log 执行日志可以 按行数过滤 所输入的行数为日志文件的最后的 N 行 输 入的函数需要小于 500 大于 500 时候只会显示最新的 500 行的内容 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 17 图 4 15 4 44 4 导入导入 导出导出 为了备份文件 文件服务器提供文件的导入 导出支持 将文件服务器上的文件导出到指定目录 也 可将指定目录的文件导入到文件服务器 4 4 1 导出导出 导出操作 会导出文件以及相应的元数据 可以设置如下几个属性 开始时间 结束时间 所属模块 导出目录 1 开始时间 结束时间 在开始时间和结束时间内上传的文件 2 所属模块 限定文件的所属模块 3 导出目录 是指导出后的文件的存储目录 注意 是服务器上的目录 不是本地的 这几个属性都不是必填项 全不填会导出所有的文件 导出的文件后缀为 xsf 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 18 图 4 16 4 4 2 导入导入 将导出的文件 导入到服务器 只需要设置导入的目录即可 会遍历目录下所有支持的导入文件类 型 xsf 后缀 图 4 17 4 54 5 版本升级版本升级 版本升级 支持将文档中心中的文件升级到文件服务器中 升级有如下几个可选项 含义如下 开始时间 该时间节点之后的文件 会升级到文件服务器 结束时间 该时间节点之前的文件 会升级到文件服务器 元数据数据源 文档中心文件元数据存储数据源 存储数据源 文件服务器文件元数据存储数据源 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 19 图 4 18 4 64 6 诊断诊断 UFS2 0 提供了诊断功能 该功能是在正确配置文件服务器的前提下用于测试文件服务器的文件上传 下载等功能是否可用 图 4 19 通过左面的导航菜单进入诊断界面后可以看到有三项诊断功能 分别是 文件上传 文件下载和文件 删除操作的测试 三项的诊断测试是顺序执行 即现上传文件 然后对该文件下载 最后将上传的文件上 出 每一项的操作不管成功与否都会有详细的提示信息 4 6 1 上传上传 上传过程是先生成一个文本文件 然后将该文件上传到文件服务器 文件上传成功会看到成功的提示 信息 主要信息包括 文件通过 Http 还是 Https 协议进行传输的 上传到文件服务器之后存储在磁盘 FTP 服务器还是 MongoDB 以及文件的逻辑路径和文件的大小 图 4 20 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 20 在文件上传过程出现错误 会给出具体的错误信息 若服务端报错会提示 上传文件时出错 请查 看日志信息 若是客户端报错会给你明确的提示 图 4 21 4 6 2 下载下载 只有在上传成功之后才可以进行下载操作 若下载文件成功则会看到下载的文件大小和文件的内容 下载和上传操作的是同一个文件 所以文件大小要一致 图 4 22 同样在下载过程出错的话会给出明确的错误信息 图 4 23 4 6 3 删除删除 为了避免每次诊断测试产生无用的数据记录 在上传完文件之后都对该文件进行删除操作 只有这 三项测试全部通过的时候才表示文件服务器的基本服务是可用 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 21 图 4 24 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 22 5 文件文件服务器升级服务器升级 65 版本文件服务器支持 MongoDB 磁盘 FTP 三种存储模式 升级前的文档中心和文件服务器 本版 本统一使用文件服务器来代替 5 15 1 升级升级注意事项注意事项 1 65 版本要求必须配置文件服务器 2 升级前备份文档中心和文件服务器数据 包含配置的本地存储文件和 FTP 文件 3 文件服务器独立部署时 在 NC 应用服务器上可仅指定文件服务器的存储模式 IP 地址 端口号 是否启用安全访问 默认不启用 在文件服务器上需配置文件服务器的所有服务配置信息 注 如果存储模式为 FTP 存储时 NC 应用服务器和文件服务器上的 FTP 存储信息配置需保持一致 4 文件服务器独立部署时 文件服务器仅需安装 UAPServer 和智能客户端应用平台模块即可 5 文件服务器与 NC 集中部署时 则升级 NC 产品时就已装文件服务器 6 63 版本文档中心为数据库时 不支持文档中心数据源和 UAP 账套数据源独立部署的场景 5 25 2 升级升级检查检查 升级前请检查 1 升级前版本的文档中心配置为本地存储时 将升级前 nchome ierp sf documentConfig xml 文件 拷贝到 NC65 的 nchome ierp sf 下 2 请将升级前的存储目录及目录下的文件拷贝到当前服务器相同物理路径下 升级前文档中心为 FTP 或数据库时 则不需要备份 即可升级 3 如果升级前使用了文件服务器 须确保 NC65 版本 sysConfig 中文件服务器配置信息磁盘存储的 存储路径与升级前系统的文件服务器配置信息磁盘存储的存储路径相同 并且确保磁盘存储路径 下的文件与升级前磁盘路径下的文件一致 4 升级前文档中心为本地存储时 请确保升级前后的数据源名称一致 若升级前后数据源名称不一 致 那么需要将 nchome documentroot 下的目录 copy 一份到 65 代码相同路径下中 并将数据源 名改名为升级后新的数据源名称 区分大小写 5 升级前如果使用了文件服务器 升级后只能使用磁盘存储 如果未使用过文件服务器 可配置三 种存储模式的任意一种 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 23 5 35 3 升级安装升级安装 升级前适用于使用 NC6 3 含 以后 NC6 5 以前版本 升级 NC6 5 的用户 升级安装步骤 第 1 步 安装解压 NC6 5GOLD 中的产品代码到新路径 或覆盖 63 代码 第 2 步 配置 sysConfig 将升级前库配置为数据源 安全数据源 初始化安全数据源 安全数据源 可以和 NC 数据源不一致 第 3 步 配置文件服务器 进行升级前检查 具体操作配置详见 3 2 节 强调 升级前如果使用了 文件服务器 升级后只能使用磁盘存储 第 4 步 启动中间件 进入 admin jsp 页系统管理进行数据库的升级 第 5 步 升级数据库完成后提示是否升级文档中心时选择 确定 进行文档中心的升级 注 还可 到版本升级中进行升级 详见 4 5 版本升级 第 6 步 重启 NC 中间件 至止 升级安装处理完毕 6 文件服务器内外网配置文件服务器内外网配置 一般情况下 企业为了保证用户数据的安全性 都会将文件服务器部署在企业内网 但其它子公司如 果想通过互联网直接访问企业内部文件服务器 那我们就要对文件服务器做相关外网配置 关于文件服务 的外网配置内容如下 6 16 1 注意事项注意事项 1 水平集群本地磁盘存储时 文件服务器配置的内网和外网端口不应该是具有服务转发功能的端口 否则下载文件的时会出现找不到文件的情况 2 MongoDB 存储时 由于附件和元数据都集中存储 所以配置文件服务器的内外和外网端口可以是 任意的可用端口 3 FTP 存储时 由于客户端直接连 FTP 服务器上传文件 若 FTP 服务器配置在内网需要将 FTP 服务 器做内外网映射 将 FTP 服务器的外网 IP 和端口配置到文件服务器 ufs net properties 文件 中 4 文件服务与 NC 独立部署时 文件服务器的端口需单独映射外网端口 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 24 6 26 2 单机环境配置单机环境配置 例 机器 A 做了内外网隔离 文件服务部署在内网上机器 A 上 并且配置的存储模式为 FTP 存储 机 器 A 的内网 IP 地址为 192 168 1 10 端口为 9090 映射的外网 IP 地址为 202 2 52 20 端口为 9191 FTP 的内网 IP 地址为 172 16 3 54 端口为 21 映射的外网 FTP 地址为 125 35 5 209 端口为 21 具体配置如下 1 通过 sysConfig 配置文件服务器为内网的 IP 和端口 2 修改配置文件 ncHome ierp sf ufsconfig ufs net properties 外网相关参数 注 若存 储模式为磁盘存储或 MongDB 存储 FTP 参数不用配置 各参数含义为 是否启用文件服务器内外网环境配置 ufs config wlan config true 配置文件服务器所映射的外网 IP ufs config wlan ip 202 2 52 20 配置文件服务器所映射的外网端口 ufs config wlan port 9191 文件服务器所在内网的子网掩码 ufs config intranet mask 255 255 255 0 指定的特殊的网段 来自该网段的请求的 URL 为内网链接 ufs config intranet case 10 20 UFS 外网FTP配置 FTP 服务器的外网 IP ufs config ftp address 125 35 5 209 FTP 服务器的外网端口 ufs config ftp port 21 FTP 服务器登录的用户名 ufs config ftp username nctest1 FTP 服务器登录的密码 ufs config ftp password nctest1 用友网络科技股份有限公司 YONYOU NC 6 5 文件服务器操作手册 25 6 36 3 集群环境配置集群环境配置 机器 A 192 100 1 11 1010 和机器 B 192 100 1 22 2020 在内网组成 水平 垂直 集群 机器 A 为 master 机器 B 为 ncMem 外网通过 20 2 6 57 7070 访问应用服务 此环境中文件服务器需要配置在非 master 机器上 上述场景机器 B 即在 sysConfig 中文件 服务器的 IP 地址和端口配置为机器的 IP 和端口 由于内外网环境中文件服务器配置成内网的 IP 地址 和端口外网用户是无法访问的 所以需要手动修改配置文件中内外网相关的参数 参考单机环境配置 7 常见问题常见问题 7 17 1 附件具体存储位置附件具体存储位置 UFS 2 0 支持三种模式的附件存储 磁盘存储 MongoDB 存储和 FTP 存储 在不同存储模式中附件 的存储具体位置可以查询 bap fs body 表得到 查询 SQL select storepath from bap fs body 磁盘存储 附件存储在 sysConfig 中配置的 存储路径 下 如 D fs test dst 0 xko 1 1441000320817 1MBzhongwen file MongoDB 存储 附件存储在 MongoDB 数据库中 可以使用 document 的 id 查找具体的附件 BSON 格式存储 查 询 db uapattac