深交所文件传输系统网关配置说明

指南下载链接

深交所文件传输系统网关配置说明.pdf
566.1 KB

指南正文内容

1、环境说明

深交所新一代系统中有多个运行和测试环境,其各个环境的 IP 地址、深网关号以及配置的规则均不相同,给网内用户进行文件网关配置造成困扰。
本文档针对文件网关在各个不同环境的配置进行详细说明。
深交所文件网关有三个环境:生产环境、联网测试环境和期权全真测试环境。
详细信息如下:
生产环境:生产系统,目前有配置深交所文件网关号 F000000X0001,和F000000X0002(配置点对点业务规则的网关,配置不同的业务规则,用于基金净值上传、融资融券数据报送和信用违约数据接收等业务);F000000X0003,用于成交汇总文件下发。
联网测试环境:联网测试系统,每天(周一至周日)提供测试环境,深交所文件网关号 N000000X0001(交易参考信息)、N000000X0002(配置点对点业务规则的网关,配置不同的业务规则,用于基金净值上传、融资融券数据报送和信用违约数据接收等业务),新增 N000000X0003,用于五版成交汇总文件下发。
期权全真测试环境:独立于新一代联网和全网测试系统,每个工作日(周一至周五)均提供服务,深交所文件网关号 W000000X0001(交易参考信息)和W000000X0002(配置点对点业务);其中 W000000X0002 用于用户上传合格投资者报送业务。

2、环境准备

以上 3 个环境准备工作一样,获取用户参数,下载软件,安装软件。
但安装软件后的配置稍有不同,在第三部分的参数配置中详细介绍。

2.1获取用户参数

包括以下 3 项:
1)本端网关用户网关号(UserId)、用户密码、Ekey 证书、证书密码(全网测试环境、期权全真测试环境需要 Ekey),通过纸质申请;
2)连接不同测试环境的服务器 IP 地址、端口(参考参数配置章节);
3)深交所端业务参数:深交所网关号(UserId)、业务规则(参考参数配置章节);
以上 3 项参数可从测试指南所提供方法获取。

2.2软件下载

文件网关程序可以部署在 32 位或 64 位 Windows 7/Windows 2008 上,文件网关为绿色软件,下载相应压缩包解压到本地硬盘任意目录即可。
深交所文件网关最新版本为 20170327,发布日期为 20170327,建议用户使用最新版本,旧版程序以后将不在支持。
深交所文件网关软件下载地址:
https://biz.sscc.com-->"业务指引"-->"交易结算业务指引"-->"程序下载"-->"文件网关"

2.3软件安装

文件网关程序分为后台运行程序 FxClient、前台界面终端 FxTerm 两部分。
用户根据自身的操作系统版本选择下载合适客户端软件,名称如下:
●Win32 平台 win32_20170327_SZSE.rar
●Win64 平台 win64_20170327_SZSE.rar
●Linux 平台 Linux_20170327_SZSE.rar
解压后,直接运行 fxclient/fxclient.exe,再运行 fxterm/fxterm.exe。

3、参数配置

3.1生产环境配置说明

1) 软件安装和环境配置
    绿色软件,无需安装,解压后载相应压缩包解压到本地硬盘任意目录即可。
2) 网络地址配置
    配置修改 FxClient->ini->fxapi.ini 文件,按"映射前地址:端口=映射后地址:端口"规则填写,如果网络没有做地址映射,则在配置中映射前地址和映射后地址填写相同即可,
如下所示:
(以下网络地址配置适合 Level1 用户参考)
(以下网络地址配置适合 Level2 用户参考) 
3) 认证信息配置
    生产环境的用户认证分为硬件 Ekey 认证和文件证书认证,硬件 Ekey 认证需安装硬件 Ekey;如果用户使用文件证书,需配置如下:
a、用户通过会员专区下载文件证书时,会提示输入 6 位保护口令,此口令即为文件证书的口令,如果您输入的 6 位口令为 111111,则在 fxclient.ini 文件的EkeyPwd=111111;
b、把下载的文件证书命名为文件网关号+#0(例如 F888888X0001#0.pfx)保存至网关程序 Fxlcient 的 cert 目录下,并修改 fxclient.ini 文件,把文件证书名称配置在“Ekey”字段,并正确配置证书口令,完成后配置 UserID 等,fxclient.ini
只需要配置如下项目:
配置完毕保存后,点击 fxclient.exe 即可启动客户端后台程序;
4) 监控终端配置
    进入 FxTerm 目录,点击 FxTerm.exe 即可启动客户端终端程序,输入 IP: 127.0.0.1,端口:3001;用户名密码:admin/123456,可对后台进行管理和监控,FxTerm 的用户和用户名及服务器端口在 FxClient.ini 文件中均可配置。
5) 添加连接人
    登录 FxTerm 界面->左树“菜单导航”->配置菜单->对端连接人配置,根据业务功 能 的 不 同 将 深 交 所 文 件 网 关 号 : F000000X0001 或 F000000X0002 或F000000X0003,添加为联系人;
6) 配置传输规则
A. 群发业务
    交易参考信息下发,在 FxTerm 界面->左树“菜单导航”->配置菜单->传输规则配置,点击“增加”,新增传输规则类型为“业务类型规则“,传输规则名称为“szse_marketdata ",传输 规则描述为 “生产环 境用户” ,将深交 所用户号F000000X0001 选为对接连接人,并设定文件接收和发送的路径。
B. 点对点业务
    点对点业务分为两种,包括:
(一)基金净值上传/ETF PCF 文件上传/网络投票日终回报文件接收,传输规则名称为 szse_trading_<nnnnnn>,nnnnnn 指 6 位会员编码)深交所用户号 F000000X0002;
(二)融资融券余额数据报送,信用违约数据接收,传输规则名称为 szse_riskcontrol_<nnnnnn>,nnnnnn 指 6 位会员编码),深交所用户号 F000000X0002;
无会员编码的用户,如信息系统提供商、开发商等。
传输规则为“A 公司简称_<业务类别>_B 公司简称”。
例如: szse_trading_abcd,其中 szse 是深交所的简称,abcd 是某公司的简称。
C. 成交汇总文件下发业务
    成交汇总文件下发业务,对端深交所网关号为 F000000X0003。使用文件网关收取成交汇总文件需使用新版本的文件网关程序 20170327,新版本程序可从深证通官网下载。
a) 登录 FxTerm 终端,通过“菜单导航”-> “配置菜单”-> “订阅配置”,可看到深交所发布的主题信息,发布者是 F000000X0003。 b) 双击选择主题,在“传输路径”中配置相应的接收文件路径,点击“确定”,可在“已订阅主题”中看到订阅的主题。
c) 如果测试用户不订阅主题,数据不会发送到接收端。如果偶尔需要接收,可通过“菜单导航”->“任务操作”->“下载文件”,输入查询条件(发送方 F000000X0003),选择手工下载。
7) 查看状态
在 FxTerm 界 面 -> 左 树 “ 文 件 任 务 管 理 ” 收 件 箱 中 , 可 以 看 到 深 交所F000000X0001/F000000X0002/F000000X0003 在线状态;

3.2联网测试环境配置说明

1) 软件安装和环境配置
    绿色软件,无需安装,解压后载相应压缩包解压到本地硬盘任意目录即可。
2) 网络地址配置
   配置修改 FxClient->ini->fxapi.ini 文件,按"映射前地址:端口=映射后地址:端口"规则填写,如果网络没有做地址映射,则在配置中映射前地址和映射后地址填写相同即可,如下所示:
(以下网络地址配置适合 Level1 用户参考)
(以下网络地址配置适合 Level2 用户参考) 
3) 认证信息配置
    联网测试环境用户均使用软加密,无需申请 Ekey 或者文件证书,也不需要在配置中配置该项。
4) 修改本端 USERID,修改 fxclient.ini 文件
    修改 FxClient->ini->fxclient.ini 文件,用户只需配置以下六项:
配置完毕保存后,点击 fxclient.exe 即可启动客户端后台程序;
5) 监控终端配置
    进入 FxTerm 目录,点击 FxTerm.exe 即可启动客户端终端程序,输入 IP: 127.0.0.1,端口:3001;用户名密码:admin/123456,可对后台进行管理和监控,FxTerm 的用户和用户名及服务器端口在 FxClient.ini 文件中均可配置。
6) 添加连接人
    登录 FxTerm 界面->左树“菜单导航”->配置菜单->对端连接人配置,将深
交所文件网关号:N000000X0001,添加为联系人;
7) 配置传输规则
A. 群发业务:
交易参考信息下发,在 FxTerm 界面->左树“菜单导航”->配置菜单->传输规则
配置,点击“增加”,新增传输规则类型为“业务类型规则“,传输规则名称为
“szse_marketdata ",传输 规则描述为 “联网测 试用户 ” ,将深交 所用户 号
N000000X0001 选为对接连接人,并设定文件接收和发送的路径。
B. 点对点业务
点对点业务分为两种,包括(一)基金净值上传/ETF PCF 文件上传/网络投
票日终回报文件接收,传输规则名称为 szse_trading_<nnnnnn>,nnnnnn 指 6 位
会员编码)深交所用户号 N000000X0002;(二)融资融券余额数据报送,信用
违约数据接收,传输规则名称为 szse_riskcontrol_<nnnnnn>,nnnnnn 指 6 位会员
编码),深交所用户号 N000000X0002;
无会员编码的用户,如信息系统提供商、开发商等,传输规则为“A 公司简
称_<业务类别>_B 公司简称”,例如 szse_trading_abcd,其中 szse 是深交所的简
称,abcd 是某公司的简称。
C. 成交汇总文件下发业务
成交汇总文件下发业务,对端深交所网关号为 N000000X0003。使用文件网关收取成交汇总文件需使用新版本的文件网关程序 20170327,新版本程序可从深证通官网下载。
a) 登录 FxTerm 终端,通过“菜单导航”-> “配置菜单”-> “订阅配置”,可看到深交所发布的主题信息,发布者是 N000000X0003。 b) 双击选择主题,在“传输路径”中配置相应的接收文件路径,点击“确定”,可在“已订阅主题”中看到订阅的主题。
c) 如果测试用户不订阅主题,数据不会发送到接收端。如果偶尔需要接收,可通过“菜单导航”->“任务操作”->“下载文件”,输入查询条件(发送方 N000000X0003),选择手工下载。
8) 查看状态
    在 FxTerm 界 面 -> 左 树 “ 文 件 任 务 管 理 ” 收 件 箱 中 , 可 以 看 到 深 交所N000000X0001 或 N000000X0002 以及 N000000X0003 在线状态。

3.3期权全真测试环境配置说明

1) 软件安装和环境配置
    绿色软件,无需安装,解压后载相应压缩包解压到本地硬盘任意目录即可。
2) 网络地址配置
   配置修改 FxClient->ini->fxapi.ini 文件,按"映射前地址:端口=映射后地址:端口"规则填写。
如果网络没有做地址映射,则在配置中映射前地址和映射后地址填写相同即可,如下所示:
3) 认证信息配置
    期权全真环境用户使用软加密,无需申请 Ekey 或者文件证书,也不需要在配置中配置该项。
4) 修改本端 USERID,修改 fxclient.ini 文件、修改 FxClient->ini->fxclient.ini 文件,用户只需配置以下六项:
    配置完毕保存后,点击 fxclient.exe 即可启动客户端后台程序;
5) 监控终端配置
    进入 FxTerm 目录,点击 FxTerm.exe 即可启动客户端终端程序,输入 IP: 127.0.0.1,端口:3001;用户名密码:admin/123456,可对后台进行管理和监控。
6) 添加连接人
    登录 FxTerm 界面->左树“菜单导航”->配置菜单->对端连接人配置,将深交所文件网关号:W000000X0001 和 W000000X0002,添加为联系人。
7) 配置传输规则
   群发业务:在 FxTerm 界面->左树“菜单导航”->配置菜单->传输规则配置,点击“增加”,新增传输规则类型为“业务类型规则”,传输规则名称为“szse_marketdata",传输规则描述为“深交所交易参考信息”,将深交所用户号                             W000000X0001 选为对接连接人,并设定文件接收和发送的路径。
   点对点业务:用户合格投资者数据报送业务配置方法,在 FxTerm 界面->左树“菜单导航”->配置菜单->传输规则配置,点击“增加”,新增传输规则类型为“业务类型规则”,传输规则名称为“szse_riskcontrol_<nnnnnn>”,nnnnnn 指6 位会员编码),深交所用户号 W000000X0002,传输规则描述 为“合格投资者数据报送业务”,将深交所用户号 W000000X0002 选为对接连接人,并设定文件接收和发送的路径。
关于期权环境点对点业务的说明:
此项业务无需单独申请变更,系统默认为券商或期货公司的第一个文件网关开通此项业务,如 xx 券商有两个文件网关
W000123X0001 和 W000123X0002,系统默认 W000123X0001 开通此项业务,用户在本端文件网关上配置好传输规则既可报送业务数据。
8) 查看状态
在 FxTerm 界 面 -> 左 树 “ 文 件 任 务 管 理 ” 收 件 箱 中 , 可 以 看 到 深 交所W000000X0001/W000000X0002 在线状态。

4、FAQ

1) 文件网关如何升级到 20170327 版本?   
可到我公司网站下载最新版本的客户端程序20170327,解压文件后Windows版本只需要替换 fxapi.dll 和 fxclient.exe,Linux 版本替换 fxclient 和 libfxapi.so 即可。程序下载地址:https://biz.sscc.com-->"业务指引"-->"交易结算业务指引"-->"程序下载"-->"文件网关"
2) 需要申请多少个文件网关?
考虑要素包括物理带宽、主备机房、多中心等,并且文件落地后可以共享,建议控制在 1-5 个,不建议超过 5 个,所申请的文件网关建议在工作日都开启使用,否则在开市期间会占用行情带宽;
3) 设置多大带宽合适?
因与交易、行情复用相同物理线路,现中枢默认设置为 512Kbit/秒,深交所并发方式下发文件,如果启用多个文件网关,会占用较大带宽;因成交汇总文
件稍大,建议用户在生产系统中申请成交汇总文件下发业务的文件网关的带宽设
置在 2m 以上,以便获得更好的用户体验。
4) 如何设置使用文件证书?
新 版 程 序 20170327 版 本 客 户 端 配 置 只 需 要 把 文 件 证 书 名 称 配 置 为fxclient.ini 文件的“Ekey”项即可。
把下载的文件证书命名为文件网关号+#0(例如 F888888X0001#0.pfx)保存至网关程序 Fxlcient 的 cert 目录下,并修改 fxclient.ini 文件;
5) 文件网关如何监控?
    a)、提供带界面的 FxTerm 程序;
    b)、输出文本的监控接口,可以较方便集成到第 3 方监控程序,打开fxclient.ini 监控选项:“StartMonitor”=“1”,可将系统状态、文件任务收发输出到文本监控接口中,文本监控接口格式参考用户手册。
6) 文件网关是否支持线路备份?
   支持,可在路由器上接多条线路,并且 NAT 转换,并且在 fxapi.ini 的[IpPortMap]段中,做多组映射:
7) 文件网关与深证通增值业务使用是否同一套?
    不是同一套,中枢服务器不同,用户所连接的 IP 地址不同,此套程序部署在交易网,与深证通增值业务另一套区分开,增值业务另一套部署在增值业务网,两套不能混用。

5、联系方式

深圳证券通信公司滨海运行组技术支持热线:0755-83182222
0 0