文件服务器中的模块，可以理解成一种命名空间 (Bucket) ，上传文件时指定模块，文件会存储到模块对应的存储路径下；下载文件时指定模块，服务器会去模块对应的存储路径下取文件下载。模块管理提供一个默认的模块—— default( 默认 ) ，上传和下载不指定模块 bucket 时，使用默认的模块配置。

默认模块的加密、压缩和访问控制属性都是不启用的， NC 通用场景下，建议采用默认设置即可，无需关心模块设置。但如果对文件安全性要求比较高，比如想对文件做加密，压缩处理时，可以通过添加一个新的模块，配置加密、压缩属性，然后上传到新增的模块即可。另外，如果通过 SDK 方式访问文件服务器，并且需要增加访问控制时，需要配置模块，并将模块的密钥作为 SDK 接口的参数使用。

4.2.6 属性介绍

1. 是否预置

是否预置属性可以取值为： Y(YES) 和 N(NO) 。 Y 代表是预置模块，一般通过数据库脚本添加预置模块。 N 代表非预置模块，通过管理控制台添加的模块都是非预置模块，预置的模块不可以删除，即使预置的模块下面没有任何文件。非预置的模块，如果下面不包含任务文件，是可以删除的。

2. 是否加密

是否加密属性可以取值为： YES 和 NO 。 YES 代表启用加密，当上传文件到该模块下时，文件内容会被加密处理，也就是说存储在文件服务器上的文件是经过加密的，一般对文件安全性要求比较高的场景，建议启用加密属性。

注：如果存储方式是 FTP 存储，则此处的加密属性不会生效，文件不会被加密处理。

是否压缩

是否压缩属性可以取值为： YES 和 NO 。 YES 代表启用压缩，上传文件到该模块下时，文件内容会被压缩处理，存储在文件服务器上的文件时压缩后的文件，一般在文件比较大时，建议启用压缩属性，可以减少文件在服务器端占用的空间。

注：如果存储方式是 FTP 存储，则此处的压缩属性不会生效，文件不会被压缩处理。

访问控制

访问控制属性可以取值为： YES 和 NO 。 YES 代表启用访问控制，启用访问控制后，服务端会对请求进行校验，包括请求参数，签名等，校验不通过，请求会被拒绝。访问控制与密钥是配合着使用的，下面会详细介绍密钥。

密钥

密钥是配合着访问控制使用的，在访问控制被启用之后，密钥会自动生成，可以通过查看连接，查看对应的密钥，密钥可更新。启用访问控制后，客户端上传、下载文件时，需传入相应模块对应的密钥，如果密钥设置不对，请求访问不会通过，上传、下载失败。

4.3 日志监控

4.3.1 访问日志

访问日志可以选择是否启用，勾选启用并保存及开启访问日志功能。启动访问日志后文件服务器会记录链接文件服务器的请求信息。请求信息主要包括：客户端 IP 、登录的用户名、操作类型、请求的 URL 、对应操作的文件内容、操作开始时间和操作结束时间。

$C:\DOCUME~1\zhangyth\LOCALS~1\Temp\SNAGHTML1269d63.PNG$

图 4-13

访问日志可以用于查看每次用户访问文件服务器的具体操作信息，在上图 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

当 UFS 功能出现异常时，可以通过执行日志来查看具体的日志信息，进而排查错误。执行日志的功能是将后台日志文件的最新内容显示在页面上，方便远程查看错误信息。执行日志中默认最多加载最新的 500 行日志内容。在加载的日志中可以通过搜索 “@UFS” 字符串来快速定位文件服务器的错误信息。执行日志默认加载的是文件服务器专有的日志文件 /nclogs/server/uapfs.log ，若该文件不存在则加载 /nclogs/server/nc-log.log 。执行日志可以按行数过滤，所输入的行数为日志文件的最后的 N 行，输入的函数需要小于 500 ，大于 500 时候只会显示最新的 500 行的内容。

图 4-15

4.4 导入/导出

为了备份文件，文件服务器提供文件的导入 / 导出支持，将文件服务器上的文件导出到指定目录，也可将指定目录的文件导入到文件服务器。

4.4.1 导出

导出操作，会导出文件以及相应的元数据。可以设置如下几个属性：开始时间，结束时间，所属模块，导出目录。

1) 开始时间，结束时间：在开始时间和结束时间内上传的文件。

2) 所属模块：限定文件的所属模块。

3) 导出目录：是指导出后的文件的存储目录，注意，是服务器上的目录，不是本地的。

这几个属性都不是必填项，全不填会导出所有的文件。导出的文件后缀为 .xsf 。

图 4-16

4.4.2 导入

将导出的文件，导入到服务器。只需要设置导入的目录即可，会遍历目录下所有支持的导入文件类型， .xsf 后缀。

图 4-17

4.5 版本升级

版本升级，支持将文档中心中的文件升级到文件服务器中。升级有如下几个可选项，含义如下：

开始时间：该时间节点之后的文件，会升级到文件服务器

结束时间：该时间节点之前的文件，会升级到文件服务器

元数据数据源：文档中心文件元数据存储数据源

存储数据源：文件服务器文件元数据存储数据源

图 4-18

4.6 诊断

UFS2.0 提供了诊断功能，该功能是在正确配置文件服务器的前提下用于测试文件服务器的文件上传、下载等功能是否可用。

图 4-19

通过左面的导航菜单进入诊断界面后可以看到有三项诊断功能，分别是：文件上传、文件下载和文件删除操作的测试。三项的诊断测试是顺序执行，即现上传文件，然后对该文件下载，最后将上传的文件上出，每一项的操作不管成功与否都会有详细的提示信息。

4.6.1 上传

上传过程是先生成一个文本文件，然后将该文件上传到文件服务器，文件上传成功会看到成功的提示信息，主要信息包括：文件通过 Http 还是 Https 协议进行传输的，上传到文件服务器之后存储在磁盘、 FTP 服务器还是 MongoDB ，以及文件的逻辑路径和文件的大小。

图 4-20

在文件上传过程出现错误，会给出具体的错误信息。若服务端报错会提示：“上传文件时出错，请查看日志信息 ”；若是客户端报错会给你明确的提示。

图 4-21

4.6.2 下载

只有在上传成功之后才可以进行下载操作，若下载文件成功则会看到下载的文件大小和文件的内容。下载和上传操作的是同一个文件，所以文件大小要一致。

图 4-22

同样在下载过程出错的话会给出明确的错误信息。

图 4-23

4.6.3 删除

为了避免每次诊断测试产生无用的数据记录，在上传完文件之后都对该文件进行删除操作，只有这三项测试全部通过的时候才表示文件服务器的基本服务是可用。

图 4-24

5 常见问题

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.uapattachroot.find({'_id':'55dc2e64fdba9d7fef76d799'})

 FTP存储

附件在FTP服务器上的存储目录是基于根目录的，如：

/FTP根目录 /test/ywz_0/vcy_1/1441000440010_1MBzhongwen.file

2、文件名长度过长导致附件上传失败

数据库中文件名字段 ( name ) 长度定义为 varchar(100) ，文件名的字符长度超过 100 时无法保存到数据库。

解决：

1 )保证所上传文件名的字符长度在 100 之内；

2 )将数据库 bap_fs_header 表中 name 字段长度调整为文件中文名长度× 3 ，

SQL ： alter table bap_fs_header modify (name varchar(300));

3、UAP63升级UAP65时历史附件无法查看

UAP63 和 UAP65 文件服务器定义的元数据表存在结构差异，在做升级的时候升级程序会自动处理表之间的差异。升级完成后验证数据库保证以下两点：

1 ) bap_fs_body 中 version 字段默认值为 1 ，且不存在 null 值

2 ) bap_fs_header 中历史数据的 fileVersion 字段值为 1

4、磁盘存储模式文件存储路径调整

文件服务器在应用一段时间后可能出现需要更改附件存储根目录的需求，存储路径的更改需要做以下的操作：

1)修改配置，将旧的存储路径（ C:/fs ）改为新的存储路径（ D:/fs/disk ）

图 5-1

2)拷贝文件，将 C:/fs /* 下的所有文件拷贝到新目录 D:/fs/disk 下

3)执行 SQL 更改数据库中的数据。

update bap_fs_body set storepath=replace(storepath,' C:/fs ',' D:/fs/disk ') where storepath like ' C:/fs ';

5、独立部署文件服务器时使用HTTPS协议无法上传文件

文件服务器独立部署时需要在应用端配置 “ 服务器 IP 地址 ” 、 “ 服务器端口 ” 和 “ 是否启用安全访问 ” ，在使用 HTTPS 协议时端口配置 HTTPS 对应的端口，并勾选启用安全访问。

$C:\Users\jinfeng.PDOMAIN\AppData\Roaming\Foxmail7\Temp-4612-20150831082230\Catch.jpg$

图 5-2

配置好文件服务器附件上传依然失败请检查证书密码是否配置，默认为： yonyouserver 。

$C:\Users\jinfeng.PDOMAIN\AppData\Roaming\Foxmail7\Temp-4612-20150831082230\CatchC35B.jpg$

图 5-3

6 、文件服务器中配置MongoDB集群地址

例： MongoDB 集群环境信息如下表所示：

表 5-1

	IP 地址	端口
M aster	20.12.9.97	27017
S lave	20.12.9.87	27017
A rbiter	20.12.9.81	27017

配置文件服务器：

由于 MongoDB 是独立部署的集群，所以在文件服务器中需要勾选独立部署。 IP 地址配置 MongoDB 集群节点的 IP ，各 IP 之间用 ”;” 分割，端口配置 MongoDB 集群节点所启用的服务端口，端口之间同样用 ”;” 分割，需要保证 IP 和端口的配置顺序是对应的。

$C:\Users\jinfeng.PDOMAIN\AppData\Roaming\Foxmail7\Temp-4612-20150831082230\Catch3A4F.jpg$

图 5-4

知识库 : 文件服务器产品文档

1 系统框架

1.1 高效性

1.2 安全性

1.3 可靠存储

2 部署方案

2.1 集中部署

2.2 独立部署

3 sysConfig 配置

3.1 服务器配置

3.2 文件服务器配置

4 管理控制台

4.1 服务配置

4.1.1 默认存储配置

4.1.2 磁盘存储配置

4.1.3 FTP 存储配置

4.1.4 配置文件

4.2 模块管理

4.2.1 模块简介

4.2.2 查询模块

4.2.3 添加模块

4.2.4 修改模块

4.2.5 删除模块

4.2.6 属性介绍

4.3 日志监控

4.3.1 访问日志

4.3.2 执行日志

4.4 导入/导出

4.4.1 导出

4.4.2 导入

4.5 版本升级

4.6 诊断

4.6.1 上传

4.6.2 下载

4.6.3 删除

5 常见问题

Attachments:

知识库 : 文件服务器产品文档

1 系统 框架

1.1 高效性

1.2 安全性

1.3 可靠存储

2 部署 方案

2.1 集中 部署

2.2 独立 部署

3 sysConfig 配置

3.1 服务器配置

3.2 文件服务器配置

4 管理控制台

4.1 服务配置

4.1.1 默认 存储 配置

4.1.2 磁盘 存储配置

4.1.3 FTP 存储 配置

4.1.4 配置 文件

4.2 模块 管理

4.2.1 模块简介

4.2.2 查询模块

4.2.3 添加模块

4.2.4 修改模块

4.2.5 删除模块

4.2.6 属性介绍

4.3 日志监控

4.3.1 访问日志

4.3.2 执行日志

4.4 导入/导出

4.4.1 导出

4.4.2 导入

4.5 版本升级

4.6 诊断

4.6.1 上传

4.6.2 下载

4.6.3 删除

5 常见问题

Attachments:

1 系统框架

2 部署方案

2.1 集中部署

2.2 独立部署

4.1.1 默认存储配置

4.1.2 磁盘存储配置

4.1.3 FTP 存储配置

4.1.4 配置文件

4.2 模块管理