文件服务器使用手册1.文件服务器概述文件服务器的基本功能是实现文件的上传、下载、查询、删除等基本文件存储操，文件服务器在实现了基本的存储功能同时，关注如何高效、合理的管理文件。实际文件则按照应用场景的需要存储在不同的存储介质上。文件服务器存储方式包括：MongoDB存储、磁盘文件、FTP存储。UAP65已删除文档中心，仅仅保留之前版本的文件服务器功能，使用与配置更加方便快捷。2.文件服务器后台配置运行$UAP_HOME/bin/sysConfig.bat，选择“文件服务器”节点，可以看到如下的运行界面：按钮功能说明：读取：点击“读取”按钮，可以得到当前文件服务器的配置信息。保存：点击“读取”按钮后，可对文件服务器配置进行修改，若想保存修改后的配置，点击“保存”按扭即可。集群同步：在集群环境下，点击“集群同步”按钮能将配置信息同步保存至集群各个节点中。下面分别介绍三种文件存储模式：2.1.MongoDB存储1)MongoDB后台配置服务配置：服务器IP地址：文件服务器的IP地址；服务器端口：文件服务器的端口；元数据仓库：即从uap_home\ierp\bin\prop.xml中读取的数据源；启用安全访问：是否使用https协议，勾选表示使用配置https协议；MongoDB存储配置：独立部署：勾选表示MongoDB与服务器是分离部署，即不在同一台服务器上。不勾选表示MongoDB与服务器是在同一台服务器上。IP地址：mongodb所在IP端口：mongodb的端口数据存储目录：mongodb文件夹的上层目录。Mongodb仅支持windows和Linux操作系统，不支持Sparc和AIX操作系统。Linux启动mongodb时首先要给可执行权限。注：启用MongoDB需要文件服务器前台配置进行启用。见《文件服务器前台配置-MongoDB如何启用》章节。2.1.磁盘存储方式文件服务器的配置项涉及两个方面，第一个是文件服务器的服务配置。另一个是文件服务器的磁盘存储配置。如下图：服务配置项：服务器IP地址：文件服务器的IP地址；服务器端口：文件服务器的端口；元数据仓库：即从uap_home\ierp\bin\prop.xml中读取的数据源；启用安全访问：是否使用https协议，勾选表示使用配置https协议；磁盘存储配置：存储路径：上传的文件存储路径。要保证此目录在服务器上存在。以磁盘存储、FTP存储方式存储时，存储路径支持按模块存储、按时间存储。MongoDB存储时不支持。存储路径设置：修改后台配置文件\ierp\sf\ufsconfig\ufs.properties#storedirectorygenerationstrategy,thevalueis"bydate"or"bymodule"ufs.config.disk.policy=bymodule默认为bymodule，修改为bydate，修改完之后需重启服务注：磁盘存储路径仅支持本地存储，不支持网络存储。2.2.FTP存储方式访问配置：服务器IP地址：文件服务器的IP地址；服务器端口：文件服务器的端口；元数据仓库：即从uap_home\ierp\bin\prop.xml中读取的数据源；启用安全访问：是否使用https协议，勾选表示使用配置https协议；FTP配置：IP地址：FTP服务的IP地址端口号：FTP服务的端口用户名：FTP服务的用户名密码：FTP服务的密码传输模式：Binary、ascii（建议使用Binary，否则会丢失数据）3.文件服务器前台配置除在将sysConfig中可对文件服务器的三种存储方式进行配置，在文件服务器前台同样可以进行配置，前后台的配置是同步的。进入前台配置界面，请在浏览器中输入：http://IP:PORT/fs/console.html回车后出现以下页面，如下图；用户名/密码与http://IP:PORT/admin.jsp端登录时，具有超级管理员权限的用户名和密码（如root，super）当密码为空时，无法登陆，需登陆http://IP:PORT/admin.jsp修改相应用户后再登录。3.1.服务配置成功登录后，默认显示服务配置页面，如下图：前台文件服务器的三种配置方式与后台配置相同，此处不再赘述。前后台配置主要区别如下：3.1.1.测试文件服务配置信息是否正确前台配置完存储模式后，可以点击“服务配置”页签下的“测试”进行文件服务器是否能正常使用测试。如下图，点击“测试”按钮，会提示“测试通过”3.1.2.MongoDB如何启用具体操作如下：1)登录文件服务器前台http://20.10.80.194:15901/admin.jsp端登录;2)存储模式为“Mongodb存储”；3)找到存储服务状态，即mongodb的状态；4)点击“刷新”显示“服务未运行”5)点击“启动服务”显示“服务运行中”，即：Mongodb数据库已启用。在mongodb服务器能查看到进程：3.2.模块管理上传附件时，可以按不同模块对附件进行是否加密、压缩处理。例如：模块名：uapattachroot是否加密：YES是否压缩：YES访问控制：YES。如下图：字段说明：模块名：模块名称，对应BAP_FS_HEADER表中的MODULE字段值；是否加密：上传附件是否加密，如果加密，在服务器上直接打开时是加密后的文件。是否压缩：上传附件是否压缩，如果压缩，在服务器上直接打开时是压缩打包后的文件。访问控制：第三方接口调用时用。3.3.日志监控3.3.1.访问日志访问日志：记录全部操作，关注启动后，操作后，刷新时日志有相关记录信息（以时间点为准）。未启用日志监控时（不勾选“启动”时），访问日志显示效果，如下图：启用日志监控时（勾选“启动”，并点击“保存”，对附件进行操作后，点击“刷新”。），访问日志显示效果，如下图：3.3.2.执行日志执行日志：此处记录附件上传中的执行日志及异常日志，相当于后台nolog中内容，记录程序运行过程抛出的异常堆栈信息，默认查看最新的500行日志，过滤从最后往前过滤3.4.导出/导入对文件服务器中的文件进行备份、还原操作。导入、导出操作必须在文件服务上进行，即：在浏览器输入http://IP:PORT/fs/console.html地址，其中：IP和PORT必须与服务配置中的服务IP地址、服务器。否则，导入、导出将失败。如下图：3.4.1.导出文件服务器存在的文件数目比较大，总的数据量也比较大。如果一次性全部导出，会对整个系统的性能以及稳定性产生影响，因此，在导出操作时，支持按照时间段，模块的方式进行导出。开始时间/结束时间：YYYY-MM-DD00:00:00，时间从0点算起，例:开始时间：2015-06-15，结束时间：2015-06-17，导出文件时间为：2015-06-1500:00:00到2015-06-1700:00:00。所属模块：不设置时为所有文件，模块名输入正确时，该模块下文件导出；模块名输入错误时，导出文件为0个。例：所属模块输入uapattachroot，只导出该模块下上传的单据附件。导出目录：指定目录（该目录路径测试同存储路径）。例：导出模块为uapattachroot,导出路径为c:/a，则实际导出文件为xsf格式，存在c:/a/2015/6/15/uapattachroot/创建者PK/路径下。3.4.2.导入该导入只是导入到存储路径中。不删除原始单据附件导入，导入文件覆盖原始路径中导入文件。（注：删除原始单据的附件导入，该导入只是导入到存储路径中，与实际单据未建立联系，如想建立联系，需要业务自己处理）导入目录：仅支持输入文件服务器的导入文件盘符路径。不支持非文件服务器路径导入。例如：文件服务器为：20.10.130.141，将文件服务器D：\ff路径中的文件导入到文件服务器默认地址中。则导入目录中仅输入D:\ff即可。3.5.诊断保存服务配置后，需重启服务器再进行诊断，诊断通过说明文件服务器可以正常使用。诊断通过的文件服务器能否上传，下载，删除文件。如下图，点击“诊断”页签下的“诊断”按钮，提示通过3.6.版本升级版本升级：该处只针对文档中心-文件服务器的升级迁移。1)考虑到备份还原数据源已进行升级测试，可以修改数据源实际地址，但是一定要保证升级前后dataSourceName一致。若不一致，会导致UAP63/UAP631存储在文档中心和文档服务器中数据丢失。2)在保证升级前后dataSourceName一致的前提下，确保uap_Home/ierp/sf/fileserver.properties中参数配置正确且与sysconfig中配置一致。在升级过程中，会将旧的配置文件uap_Home/ierp/sf/fileserver.properties的参数配置同步到新的配置文件uap_home/ierp/sf/ufsconfig/ufs.properties中。3)升级文档中心，一定要保证升级前后dataSourceName一致，否则会升级失败。4)进入文件服务器管理控制台，点击“版本升级”页签。说明：开始时间：可不输入执行版本升级，如输入，从该时间点算起。结束时间：可不输入执行版本升级，如输入，从该时间点截止。元数据数据源：（必输项）：文档中心元数据数据源。存储数据源：（必输项）：文档中心存储数据源。注：元数据数据源包含如下三张表：a)sm_document_fileb)sm_document_categoryc)sm_document_version存储数据源包含一张表：a)sm_filestoreview5)填入元数据数据源：需要升级文档中心的账套的数据源6)填入存储数据源：需要升级文档中心的账套的数据源7)点击“升级”按钮，显示升级成功。4.文件服务器应用文件服务器主要划分为二类应用场景。一类为消息附件，另一类为单据附件。4.1.消息附件与单据附件涉及的参数1)单据附件参数：[单据附件最大值]参数默认值为10MB，上传大于10MB的附件时提示：大小超过限制不能上传！2)消息附件参数：[对发消息最大值]默认为5MB，上传大于5MB的附件时提示：消息超过5MB的限制，请修改！注：集团LOGO不受参数控制。4.2.消息附件与单据附件的应用范围1)消息附件包括：消息中心附件、流程通知、任务消息附件、消息模板附件、预警附件、审批时附件、报表订阅附件、。2)单据附件包括：业务单元-附件上传、模板管理-附件上传、集团、业务单元Logo、各领域单据附件。4.3.消息附件与单据附件的主要区别1)单据附件会再SM_PUB_FILESYSTEM表中生成一条记录，而消息附件不会在SM_PUB_FILESYSTEM表中生成记录信息。2)消息附件和单据附件在产品中的表现形式，在消息中心可以查到的附件都属于消息附件，在单据上可以查看到但在消息中心看不到的附件一般属于单据附件。5.分离部署MongoDB、磁盘、FTP三种存储模式都支持分离部署。其中：MongoDB、FTP两种存储还支持文件服务器与存储服务器的分离部署。磁盘存储方式仅支持文件服务器与存储服务器在同一台服务。文件服务器最小安装范围：仅需安装UAPServer和RIA模块。文件服务器与存储服务器在Sysconfig中的配置地址，如下图所示：下面分别对这三种类型进行介绍。5.1.MongoDB分离部署MongoDB分离部署支持三种形式：第一种：NC服务器、文件服务器、存储服务器在同一台机器。（Sysconfig中配置：三台服务器配置同一地址即可。注：MongonDB的端口号默认为：2727）第二种：NC服务器与文件和存储服务器，部署在不同两台服务器上，即文件和存储服务器在一台服务器上、NC服务器在一台服务器上。（Sysconfig中配置：NC服务配置一个地址、文件服务器与存储服务配置同一地址。注：MongonDB的端口号默认为：2727）第三种：NC服务器、文件服务器、存储服务器，分别部署在三台服务器上。（Sysconfig中配置：NC服务配置、文件服务器、存储服务分别配置不同地址。注：MongonDB的端口号默认为：2727）下面仅以第三种为例，进行举例。例如：NC服务器为：20.10.130.141端口为：8863；文件服务为：20.10.80.194端口为：15901；MogonDB存储服务器为：20.1.78.25端口号为：2727。具体部署步骤：(一)在20.10.130.141服务器Sysconfig中的配置：1．服务器信息配置，如下图：2．文件服务器配置，先选择存储模式为“MongoDB”，然后，配置文件服务地址及端口；(二)在20.10.80.194服务器Sysconfig中的配置：1．服务器信息配置（注：文件服务器需至少安装UAPServer和RIA模块），如下图：2．文件服务器配置，先选择存储模式为“MongoDB”，再配置文件服务地址及端口，然后，勾选独立部署，最后配置MongoDB的IP和端口号；（注：MongoDB存储IP地址与文件服务地址相同时，此时不勾选独立部署。IP地址与文件服务器地址配置相同并配置数据存储目录即可。）(三)重启NC服务器、文件服务器；(四)启动Mongdb存储服务器：MongoDB分离部署操作步骤：1)将WindowsMongo或LinuxMongo安装包直接放到上传附件的服务器上。如：c:\fs目录下。2)启用MongoDB：a)win下启动，请在CMD中执行下面语句：C:\fs\WindowsMongo\bin>mongod.exe--port=2727--dbpath=C:\fsb)linux下启动，请执行下面语句：#nohup./mongod--port=2727--dbpath=/home/fs/&c)进入文件服务器配置管理页面，存储模式为“MongoDB存储”，在MongoDB存储中勾选“独立部署”，IP地址处输入MongoDB服务器的IP，端口输入MongoDB服务器的端口号。d)在“存储服务状态”处，点击“刷新”，出现“服务动运中…”字样，说明MongoDB服务器连接正确；e)点击“保存”，保存服务配置信息，如果是集群环境，请点击“集群同步”按钮，将配置信息同步保存至集群各个节点中；f)重启服务器。5.2.磁盘存储分离部署磁盘存储分离部署支持二种形式：第一种：NC服务器、文件服务器、存储服务器在同一台机器。（Sysconfig中配置：三台服务器配置同一地址即可。）第二种：NC服务器与文件和存储服务器，部署在不同两台服务器上，即文件和存储服务器在一台服务器上、NC服务器在一台服务器上。（Sysconfig中配置：NC服务配置一个地址、文件服务器与存储服务配置同一地址。）下面仅以第三种为例，进行举例。例如：NC服务器为：20.10.130.141端口为：8863；文件服务为：20.10.80.194端口为：15901；磁盘存储路径为：C:/ufs（注：C:/ufs路径已在文件服务器中创建好。）具体部署步骤：(一)在20.10.130.141服务器Sysconfig中的配置：1．服务器信息配置，如下图：2．文件服务器配置，先选择存储模式为“磁盘存储”，然后，配置文件服务地址及端口；(二)在20.10.80.194服务器Sysconfig中的配置：1．服务器信息配置（注：文件服务器需至少安装UAPServer和RIA模块），如下图：2．文件服务器配置，先选择存储模式为“磁盘存储”，再配置文件服务地址及端口，然后，配置元数据仓库，最后配置磁盘存储路径；(五)重启NC服务器、文件服务器；5.3.FTP分离部署FTP分离部署支持三种形式：第一种：NC服务器、文件服务器、存储服务器在同一台机器。（Sysconfig中配置：三台服务器配置同一地址即可。）第二种：NC服务器与文件和存储服务器，部署在不同两台服务器上，即文件和存储服务器在一台服务器上、NC服务器在一台服务器上。（Sysconfig中配置：NC服务配置一个地址、文件服务器与存储服务配置同一地址）第三种：NC服务器、文件服务器、存储服务器，分别部署在三台服务器上。（Sysconfig中配置：NC服务配置、文件服务器、存储服务分别配置不同地址。）下面仅以第三种为例，进行举例。例如：NC服务器为：20.10.130.141端口为：8863；文件服务为：20.10.80.194端口为：15901；ftp存储服务器为：20.10.130.13端口号为：21(端口号默认为21)。具体部署步骤：(一)在20.10.130.141服务器Sysconfig中的配置：1．服务器信息配置，如下图：2．文件服务器配置，先选择存储模式为“FTP存储”，然后，配置文件服务地址及端口、FTP存储服务器IP、端口、用户名及密码；(二)在20.10.80.194服务器Sysconfig中的配置：1．服务器信息配置（注：文件服务器需至少安装UAPServer和RIA模块），如下图：2．文件服务器配置，先选择存储模式为“MongoDB”，再配置文件服务地址及端口，然后，勾选独立部署，最后配置MongoDB的IP和端口号；（注：MongoDB存储IP地址与文件服务地址相同时，此时不勾选独立部署。IP地址与文件服务器地址配置相同并配置数据存储目录即可。）重启NC服务器、文件服务器；6.应用举例按文件服务不同使用场景，分别以不同的文件服务器存储方式：MongoDB存储、磁盘文件、FTP存储方式，登录NC系统，打开具有附件上传功能的节点，进行附件上传操作。（注：三种存储方式在前台上传的效果相同。）6.1.消息附件6.1.1.例如1用户系统中要求消息附件最大允许上传3MB，消息附件超过最大允许上传值时，附件不允许上传。（注：单据附件最大值控制是受“单据附件最大值”参数控制。单据附件上传也较简单，不再赘述，下面仅对消息附件应用进行举例。）操作步骤：1)用系统管理员登录系统，打开【业务系统管理】-【业务系统初始化】-【系统参数设置】节点，会看“单据附件最大值”、“对发消息最大值”两个参数，修改“对发消息最大值”为3MB，如下图：2)使用普通管理员（或“系统用户”或“集团管理员”）重新登录系统后，在消息中心中新增一条超3MB的附件(附件总的大小超3MB)上传后，点击发送时，报“消息超过3MB的限制，请修改！”消息，如下图：3)在消息中心中新增一条超小3MB的附件(附件总的大小超小于3MB)上传后，点击发送时，发送成功。6.2.单据附件6.2.1.例如2文件服务器采用的是磁盘存储，用户想将附件存储到另一台服务器上。如：NC服务器为：20.10.130.141，文件服务器为：20.10.80.195.操作步骤：1)打开后台systemcofig文件或登录“http://IP地址：端口号/fs/console.html”文件服务器管理控制台，在文件服务器配置中更改为远程服务器IP地址和服务器端口，即：服务ＩＰ地址为20.10.80.195，服务器端口为：15804,如下图：2)登录到远程服务器20.10.80.195，配置远程服务配置信息，如下：其中：存储模式设为：磁盘存储；服务器ＩＰ地址：20.10.80.195；服务器端口设为：15804；元数据仓库：为当前服务器中配置的数据源；磁盘存储配置：设置为当前服务器的文件存储路径；重启NCHOME和文件服务器。即完成远程服务器存储路径的修改操作。6.2.2.例如3将63文档案中心升级到65文件服务器，详见“3.6版本升级”章节。7.附：7.1.注意事项1)要保证升级前后dataSourceName一致。2)路径分隔符，无论windows，Linux，Unix，路径统一用符号“/”作为分隔符，在路径输入框有提示3)Mongodb启动报错：首先检查mongodb文件是否存在（windows和linux服务器使用的是不同的mongodb包），其次检查是否有执行权限，最后检查进程是否已存在。4)若需要加密模块属性，则替换相应JDK的加密文件（local_policy.jar，US_export_policy.jar），否则出现异常错误。IBMJDK和SUNJDK加密包不同，需要分别替换。可在发版盘中找到这俩jar包。具体路径如下java_home\jre\lib\security5)启用安全访问时，必须在服务器信息配置中设置证书密码。如下图：7.2.文件服务器配置文件在uap_home/ierp/sf/ufsconfig/ufs.properties中。#================UFSbaseconfig==============#storagetypeofUFS.thevaluecanbesetdisk,ftpanddefaultufs.config.base.storetype=disk#ipaddressofUFSufs.config.base.host=20.10.130.141#portofUFSufs.config.base.port=8863#databaseisusedtostorefilemetadataufs.config.base.dsname=NC63_BIG0625#filePKisusedtouniquelyidentifytheuploadedfile.#thevalueisfalseoremptymeansyouwillgetarandomstringasfilePK,oppositeyouwillgetarelativepathasfilePK.ufs.config.base.filePK=false#================UFSHTTPS==============#usethehttpsprotocoltoaccesswhenthevalueistrueufs.config.access.https=false#================UFSdiskconfig==============#filestorepathondiskufs.config.disk.directory=D:/fs#storedirectorygenerationstrategy,thevalueis"bydate"or"bymodule"ufs.config.disk.policy=bymodule#================UFSftpconfig==============#ipaddressofftpserverufs.config.ftp.address=127.0.0.1#portofftpserverufs.config.ftp.port=21#loginusernameofftpserverufs.config.ftp.username=#loginpasswordofftpserverufs.config.ftp.password=#filetransfermodeofftpserver.thevalueis"binary"or"ascii",defaultis"binary"ufs.config.ftp.transmode=binary#================UFSdefaultconfig==============#standalonedeployufs.config.default.deploy=true#ipaddressofdefaultserverufs.config.default.address=20.1.78.25#portofdefaultserverufs.config.default.port=2727#directoryofdefaultserverufs.config.default.directory=C:/ufs/MongoDB#================UFSimport&exportconfig==============#importandexportdefaultdirectoryufs.config.imex.directory=d:\pppp#================UFSlogconfig==============#visitlogufs.config.log.visit=true7.3.文件上传涉及的表结构7.3.1.SM_PUB_FILESYSTEM(文档节点)SM_PUB_FILESYSTEM(文档节点)序号字段名备注数据类型主键是否为空枚举值1pk_erfilenode文件主键char是否2filename文件名称varchar3filepath文件路径varchar4filesize文件大小decimal5creator创建者6pk_doc文档主键varchar7contentdata内容image8hashidx索引int9isdoc是否文件(65支持扩展支持非文件器类型在此定义)varchar10isfolder是否文件夹varchar11lasttime最后修改时间varchar12rootpath根路径varchar13pk_parent父节点varchar7.3.2.BAP_FS_HEADER序号字段名备注数据类型主键是否为空枚举值1CREATETIME创建时间VARCHAR22CREATOR创建者VARCHAR23DRDRNUMBER4EXT_PROPSVARCHAR25EXT_TABLENAMEVARCHAR26EXT_TYPEVARCHAR27FILESIZE文件大小NUMBER8FILEVERSION文件版本NUMBER9GUIDGUIDCHAR是10LASTMODIFIER修改者VARCHAR211LASTMODIFYTIME修改时间VARCHAR212MODULEVARCHAR213NAME文件名称VARCHAR214PATH文件路径VARCHAR215TSTSCHAR7.3.3.BAP_FS_BODY序号字段名备注数据类型主键是否为空枚举值1DRDRNUMBER2FILESIZE文件大小NUMBER3FILETYPE文件类型VARCHAR24GUIDGUIDCHAR是5HEADID文件头IDVARCHAR26STOREPATH存储路径VARCHAR27TSTSCHAR8VERSION版本NUMBER7.3.4.附件上传、移动、删除操作与表之间的关系7.3.4.1.附件上传如：打开“业务单元”节点。点击“附件管理”，弹出“附件管理”窗口；点击“上传附件”按钮，在弹出“打开”窗口中选择需上传的文件。点击“打开”，将选择的文件上传到附件管理页面中，如下图：文件上传成功后，在应用服务器数据库表“SM_PUB_FILESYSTEM”生成一条新记录，如下图：在文件服务器数据表“BAP_FS_HEADER”和“BAP_FS_BODY”各生成一条记录。通过“BAP_FS_BODY”表可以查到上传附件，上传的路径。7.3.4.2.附件移动(一)在进行“移动”操作前，首先，需新增一个文件夹，具体操作如下：1)在“附件管理”窗口中，点击“新建文件夹”按钮：2)在弹出的“新建文件夹”窗口中输入文件名“文件夹1”，点击“确定”。3)新增“文件夹1”成功，如下图：(二)选中刚上传的附件，点击“移动”，弹出“移动”窗口。在移动窗口中选择“全部/文件夹1”，点击“确定”成功将文件移动到“文件夹1”下。在应用服务器数据库表“SM_PUB_FILESYSTEM”中可查看到文件路径已改到“文件夹1”下。7.3.4.3.附件删除在“附件管理”窗口中，选中刚上传的文件点击“删除”，弹出“确认删除”窗口，点击“确定”。此时，在到应用服务器数据库表“SM_PUB_FILESYSTEM”中可查看删除的文件，已查不到。同样，到文件服务器数据表“BAP_FS_HEADER”和“BAP_FS_BODY”查看删除的文件，也已查不到。
