1、SSCC-FDEP 文件传输系统客户端用户手册深证通金融数据交换平台文件传输系统客户端用户手册文档版本： 1.4文档密级： 外部公开SSCC-FDEP 文件传输系统客户端用户手册文档信息文档名称 SSCC-FDEP 文件传输系统客户端用户手册说明修订历史日期 版本 修改单位 修改说明20130820 1.0 利驿飞 创建并完成初稿。20140626 1.1 分发系统 项目组 根据深交所文件收发系统的功能修订而成20150410 1.2 陈仲恒 根据深交所文件分发系统第 4 轮迭代功能修订而成20160112 1.3 陈荣安 添加、修改新版 FxTerm 的相关内容20160813 1.4 伍圣
2、寅 添加主题发布订阅的相关内容SSCC-FDEP 文件传输系统客户端用户手册第 1 页声 明欢迎用户使用深圳证券通信有限公司（以下简称“我公司” ）软件及本手册。在安装使用软件前，请用户务必仔细阅读以下声明。为保证用户软件使用的稳定性，用户可通过我公司网站获取最新发布的正式版本。在使用本软件前，用户应理解使用软件带来的风险。因此，需要用户严格按照本手册指定的运行环境和操作步骤运行和操作使用软件。因未按照用户手册说明使用而导致的任何损失，用户须自行承担。我公司拥有本软件的著作权。用户不得对本软件进行反向工程、反向汇编、反向编译等修改。非经我公司授权开发或未经我公司正式发布的其它任何由本软件衍生的
3、软件均属非法，下载、安装、使用此类软件，将可能导致不可预知的风险，由此产生的一切法律责任与纠纷自行承担，并且我公司不会对非我方直接提供的软件提供客服及技术支持。本软件经过严格的测试，但不能保证与所有的软硬件系统完全兼容。本软件也可能存在尚未发现的缺陷。如果用户发现不兼容及软件缺陷的情况，可拨打我公司技术支持电话以获得进一步技术支持。使用本软件可能会受到不可抗力、通信线路、计算机病毒、黑客攻击、操作系统不稳定、用户不当操作及非我公司因素导致的服务中断风险，用户须理解并自行承担以上风险。本手册的最终解释权归深圳证券通信有限公司所有。SSCC-FDEP 文件传输系统客户端用户手册第 2 页目 录1
4、引言 .41.1 编写目的 .41.2 系统概述 .41.3 定义 .41.4 参考资料 .42 安装指南 .52.1 安装准备 .52.1.1 运行平台及要求 .52.1.2 安装前准备信息 .62.2 安装步骤 .62.2.1 步骤 1 .72.2.2 步骤 2 .72.2.3 其它说明 .82.3 配置文件说明 .83 使用说明 .133.1 系统功能模块 .133.1.1 功能模块组成图 .133.2 用户操作流程图 .133.3 具体操作 .133.3.1 登录 .133.3.2 系统主界面介绍 .153.3.3 首页介绍 .183.3.4 文件任务管理 .193.3.5 菜单导航
5、.20SSCC-FDEP 文件传输系统客户端用户手册第 3 页3.3.6 任务操作 .203.3.7 连接与查询 .233.3.8 配置菜单 .254 常见问题集 .344.1 配置问题 .344.1.1 传输规则配置中增加或修改传输规则时，报”modify rule in ini file failed:send/recv path, or scan rule is not valid”错误？ .344.1.2 为什么发给 A 用户的文件会错发给 B 用户？ .354.1.3 如何发送两个同名但内容不一样文件给同一用户？ .354.1.4 为什么间隔扫描发送的时间会比较长？ .354.1.5
6、 为什么对方拒绝接收文件？ .354.1.6 是否可以将多个用户的收发路径设成同一目录？ .354.2 运维问题 .364.2.1 运维注意事项 .364.2.2 当按日期规则生成收发目录时，如何解决跨机器零点问题? .364.2.3 一台计算机上是否可以装多套文件传输系统客户端？ .364.2.4 发送目录下已经生成相应文件的 OK 标志文件，却不能自动发送？ .364.2.5 为什么接收目录下，有“*.szt!、.temp、.szt!mp” 此类临时文件存在？ .374.2.6 怎样设置自动发送文件？ .374.2.7 读不了 EKey 怎么办？ .374.2.8 如何修改 Ekey 密码
7、？ .374.2.9 如何修改文件传输系统的用户系统密码？ .374.2.10 日志管理功能管理哪些日志文件？ .384.3 实现原理问题 .384.3.1 接收文件放置到哪一个目录，以哪方日期为准？ .384.3.2 通过查询中枢历史收发记录下载历史文件时，接收成功后文件存放在哪？.384.3.3 程序如何实现发送上一机器日期文件的？ .394.3.4 文件传输系统对所传的文件名有规定？ .394.3.5 压缩过的文件设置了压缩方式发送不再压缩？ .394.4 其他问题 .394.4.1 为什么中枢端不提供自动压缩、解压功能？ .394.4.2 为什么文件传输系统不提供自动升级功能？ .40
8、4.4.3 客户端后台系统运行日志中搜索与任务相关的关键词？ .40SSCC-FDEP 文件传输系统客户端用户手册第 4 页5 附录 .405.1 附录 监控输出文件说明 .405.2 附录 文件加解密接口 .431引言深交所文件分发系统客户端及终端是包括客户端后台和终端 Term 两个程序。客户端后台的基本功能是：建立与中枢的链路，发送和接收来自不同连接方的各种文件和数据等；终端 Term 的基本功能是：建立与客户端后台的连接，管理和维护后台的运行，手工发送和接收文件及数据等。1.1编写目的手册编写的目的是方便平台使用用户安装和使用本平台。目标读者深交所及深证通公司的技术人员，维护运营人员。
9、1.2系统概述深交所第五版交易系统每天需要向全市场用户发布股份信息内容，该类信息文件不再从交易系统、行情系统下发，因而需要一套文件分发系统。而现有FDEP 文件传输系统在 2013 年进行了 V4 版本升级改造，系统整体架构在可靠性、安全性、稳定性、扩展性、并发性能等方面都有较大提高，经过项目评估，现有 FDEP 文件传输系统经过适应性改造能够满足深交所第五版文件分发需求。SSCC-FDEP 文件传输系统客户端用户手册第 5 页由于深交所端的文件分发功能较特殊，在现在 FDEP 文件客户端 API 基础上，为深交所定制一个客户端，简称为文件分发系统。1.3定义FDEP：金融数据交换平台；FX：
10、文件传输系统；1.4参考资料1. SSCC-FDEP 文件传输 FXAPI 用户手册.doc2. SSCC-FDEP 文件传输系统客户端文件加解密接口说明手册.doc2安装指南2.1安装准备2.1.1运行平台及要求1. 客户端和终端程序获取：可以从深圳证券通信公司网站()-下载专区- 金融数据交换平台-软件下载-SSCC-FDEP 文件传输系统相关的下载页中，下载最新版本的客户端完整安装包，其中 fxclient.exe 是客户端后台（控制台应用程序） ，FxTerm.exe 是客户端终端。表 1 是 fxclient 程序包的文件列表。表 1 fxclient 程序包序号 文件名称 说明1
11、fxclient 目录 该目录下放置的是金融数据交换平台文件传输系统客户端后台程序2 fxclient.exe 金融数据交换平台文件传输系统客户端的运行程序3 fxapi.dll fxapi 动态链接库文件3 certca.cer CA 的证书，不能修改SSCC-FDEP 文件传输系统客户端用户手册第 6 页4 inifxapi.ini 与 fxapi.dll 相关的配置文件，需要修改5 inifxclient.ini 与 fxclient.exe 相关的配置文件，需要修改6 inifxrule.ini 与传输规则相关的配置文件，通过界面终端修改7 log 目录 客户端后台运行日志存放目录8
12、ok 标记生成工具CreatFileList_win32.dll 鼠标右键菜单添加 ok 标记工具的 win32 位动态链接库文件9 ok 标记生成工具CreatFileList_x64.dll 鼠标右键菜单添加 ok 标记工具的 win64 位动态链接库文件10 ok 标记生成工具install_win32.bat 对应于 CreatFileList_win32.dll 的批处理脚本，双击即可添加 ok 标记工具到鼠标右键菜单。11 ok 标记生成工具install_x64.bat 对应于 CreatFileList_x64.dll 的批处理脚本，双击即可添加 ok 标记工具到鼠标右键菜单。
13、2. 支持的操作系统：32 位 Windows 2003，64 位 Windows2008；64 位 Linux 的 RHEL Server 6.2的操作系统，推荐 32 位 Windows 2003。终端 Term 只支持带界面的 Linux 系统。3. 硬件要求：PC Server CPU 频率 2.0GHZ 以上； 内存 2G 以上。4. 网络：从客户端 V4.0 开始，客户端连接中枢，分指令连接 7015、数据连接7016 两个端口，即用户端网络需要放开这两个端口，其中 7015 端口是长连接，7016 端口是短连接。客户端 V3.0 及更旧版本，只需开放 7015 端口；连接由客户端
14、单向发起，中枢服务器不会主动连接客户端；5. 其他：用户使用软证书文件或 Ekey 中存储的数字证书进行身份验证，因此安装客户端程序的计算机必须具有 USB 接口。2.1.2安装前准备信息生产用户需向深证通申请用户号和 Ekey；测试用户只需用户号。SSCC-FDEP 文件传输系统客户端用户手册第 7 页2.2安装步骤安装客户端完整安装包，在目标文件夹中，执行 fxclient.exe 即可启动客户端后台程序；执行 FxTerm.exe 即可启动客户端终端程序。其中客户端后台程序的启动需要 3 个前提条件：（1） 用户必须有深圳证券通信公司颁发的 Ekey 电子证书或者软加密进行登录；（2）
15、用户必须正确配置安装后的目录下 inifxapi.ini 和 inifxclient.ini 两个文件。因此需要按以下两个步骤进行操作。2.2.1步骤 1对于使用 Ekey 进行身份认证的用户，首先安装 Ekey 驱动程序，客户端后台启动前插入 Ekey，然后启动客户端后台程序。用户在 Ekey 证书因损坏等原因不能正常使用的情况下，可以向主站申请软件加密的通信方式，这时用户选择软件加密建立连接，详见 4.2.7。2.2.2步骤 2配置文件：fxapi.ini 和 fxclient.ini。对于 fxapi.ini 配置文件，用户只需配置IP 地址映射关系 即可：IpPortMap/Ip 地址
16、映射信息，转换前的地址=转换后的地址,如果无 NAT 转换或多线路接入，只需配置左边=右边/指令连接“10.10.22.158:7015“=“192.168.22.158:7015“10.10.22.159:7015“=“192.168.22.159:7015“/数据连接“10.10.22.158:7016“=“192.168.22.158:7016“SSCC-FDEP 文件传输系统客户端用户手册第 8 页“10.10.22.159:7016“=“192.168.22.159:7016“对于 fxclient.ini 配置文件，用户只需配置以下六项即可：Config“UserID“=“T000
17、1“ /用户小站号“UserPwd“=“T0001“ /用户登录中枢的密码“ListenIP“=“127.0.0.1“ /对终端 Term 的 Ip“ListenPort“=“3001“ /对终端 Term 的端口配置完毕保存后，点击 fxclient.exe 即可启动客户端后台程序；点击FxTerm.exe 即可启动客户端终端程序，对后台进行管理和监控。2.2.3其它说明终端支持与后台运行于同一台机器或各自不同机器。在 64 位 Linux 的RHEL Server 6.2 操作系统上运行终端时，为确保终端有可执行权限、配置/ 日志有读写权限，建议把读、写、可执行权限赋给终端目录及其子目录下
18、的所有文件。2.3配置文件说明fxapi.ini 配置文件简单说明如下，详见FEDPv4 文件传输 FXAPI 用户手册.doc 。ApiConfig“RecvFilePath“=“./temp/“ /临时接收目录“FetchFilePath“=“./fetch/“ /从中枢获取文件存放目录“UseFetchPath“=“1“ /使用以上定义的目录存放从中枢获取的文件“ProcessThreadNum“=“3“ /预处理线程数(并发数 )“TransferThreadNum“=“2“ /单个传输组件传输线程数(并发传输任务数)“DataLinkType“=“2“ / 数据链接类型：1-长链接(默认)，2-空闲后超时断开
