报文传输客户端使用手册.doc

跨境电子商务进口统一版信息化系统客户端软件使用手册第 1 页 共 21页目录1 文档概述431.1 编写目的431.2 读者对象431.3 系统概述431.4 术语定义432 运行环境533 软件安装说明533.1 Windows下安装533.1.1 基础安装533.1.1.1 解压客户端压缩包533.1.1.2 启动客户端633.1.2 注册服务733.2 Linux下安装733.2.1 基础安装733.2.1.1 解压客户端压缩包733.2.1.2 启动客户端833.2.2 注册服务934 检查安装情况935 系统登录指南1036 系统操作指南1036.1 配置管理1036.1.1 基本信息管理1036.1.1.1 跨境企业对接配置1136.1.1.2 连接协议配置1236.1.1.3 传输安全配置1336.1.2 对接配置管理1536.1.3 数据导入服务1536.2 运维管理1736.2.1 数据落地管理1736.2.2 报文异常管理1836.2.3 报文阻塞管理1937 应急处理2037.1 应急处理流程2037.2 预防措施2037.3 异常处理203文档概述1.1 编写目的主要为跨境企业提供跨境电子商务进口统一版信息化系统客户端软件正确的安装说明以及系统操作说明。 1.2 读者对象跨境企业用户、电商平台、电商企业、物流企业、支付企业、仓储企业、报关企业。1.3 系统概述跨境电子商务进口统一版信息化系统客户端软件满足跨境企业安装报文规范（跨境电子商务进口统一版信息化系统企业对接报文规范（试行）生成终端节点报文，实现订单、运单、支付单、清单等单证通过EXCEL格式文件半自动导入，转换成规范报文后自动添加IC卡 /USBKey数字签名，并提供数据发送和回执查询功能。1.4 术语定义序号缩略语名称术语全称定义说明1应用传输协议应用传输协议（Communications Protocol）是指计算机通信的共同语言。本文中泛指AS2（上行）+AS3（下行），IBMMQ，Toprow MQ(华盛信泰消息中间件)，RabbitMQ多种方式传输协议的统称。2数据传输文件数据传输文件数据传输是指在数据源和数据宿之间传输数据的过程，也称数据通信。数据是能由计算机处理的数字、字母和符号等，它是信息的一种载体，数据是信息传输的一种形式，主要指与计算机有关的信息传输。数据传输文件在本文是指用处存放数据传输数据的载体文件的泛称。3数据格式数据格式本文指数据传输文件的文件类型，主要包括XML，EXCEL数据格式。4数据格式转换数据格式转换从一种数据格式转换成另外一种数据格式的过程。5节点节点在网络拓扑中，网络任何支路的终端或网络中两个或更多支中的互连公共点。2 运行环境类别最低配置推荐配置应用服务器CPU2.0GHZ*4核3.0GHZ *8核内存4G以上8G以上硬盘500G500G以上RAID其他百兆带宽百兆带宽以上软件操作系统Linux/Unix/Windows server2003及以上版本3 软件安装说明3.1 Windows下安装3.1.1 基础安装3.1.1.1 解压客户端压缩包将跨境电子商务进口统一版信息化系统客户端软件安装压缩包“client.zip”解压至跨境企业服务器的某硬盘路径下，具体路径跨境企业可自行定义，例如：C:Data。如下图所示：3.1.1.2 启动客户端1. 执行startup.bat文件，生成ASE_License.ase授权文件，如下图所示：2. 跨境企业得到 ASE_License.ase 文件后，将该文件放置在 client 所在根目录下，重启执行startup.bat文件。如下图所示：3.1.2 注册服务以管理员方式运行installService.bat文件。如下图所示：3.2 Linux下安装3.2.1 基础安装3.2.1.1 解压客户端压缩包将跨境电子商务进口统一版信息化系统客户端软件安装压缩包“client.zip”解压至用户自身home目录路径下，例如：#tar zxvf / client.zip -C /Data 3.2.1.2 启动客户端1. 执行startup.sh文件，生成ASE_License.ase授权文件，如下图所示：2. 跨境企业得到 ASE_License.ase 文件后，将该文件放置在 client 所在根目录下，重启执行startup.sh文件。如下图所示：3.2.2 注册服务以管理员方式运行registInstall.sh文件，进行注册服务。4 检查安装情况基本情况确认跨境企业名称(填写备案跨境企业全称)传输接收编号(跨境统一版DXPID)授权申请码(填写软件首次运行生成的授权申请码)软件安装完成时间配置填写确认传输发送编号完成 未完成传输接收编号完成 未完成传输发送路径完成 未完成传输接收路径完成 未完成异常回执路径完成 未完成AS2/AS3协议配置完成 未完成IBM MQ协议配置完成 未完成Toprow MQ协议配置完成 未完成Rabbit MQ协议配置完成 未完成UEKY安全设置完成 未完成SJJ安全设置完成 未完成SVS安全设置完成 未完成授权申请完成 未完成5 系统登录指南一、 功能介绍用户在使用系统前需要先登录系统。二、 操作流程1、在浏览器中输入系统地址，输入正确密码，点击登录进入系统登录页面。如下图所示：6 系统操作指南6.1 配置管理6.1.1 基本信息管理一、 功能介绍基本信息管理包括企业对接配置、连接协议配置、传输安全配置三个模块。为跨境企业提供录入对接配置基本信息、连接配置协议信息以及传输安全配置信息。二、 操作流程1、用户在主菜单栏中选择配置管理下的基本信息管理，即可进入基本信息管理界面，如下图所示：6.1.1.1 跨境企业对接配置一、 功能介绍跨境企业能够进行对接配置基本信息录入，可进行高级选项录入包括传输接收编号、报文发送路径、报文接收路径、异常回执路径。二、 操作流程1、用户在主菜单栏中选择配置管理下的基本信息管理，即可进入基本信息管理界面，在基本信息管理界面录入跨境企业对接配置信息，如下图所示：2、跨境企业录入完成跨境企业对接配置信息后，点击高级按钮进行信息录入,如下图所示：6.1.1.2 连接协议配置一、 功能介绍连接协议配置包括AS2/AS3协议配置、IBM MQ或Toprow MQ协议配置和Rabbit MQ协议配置四个协议配置模块，用户自行选择要使用的协议进行配置。二、 操作流程1、用户在主菜单栏中选择配置管理下的基本信息管理，即可进入基本信息管理界面，在基本信息管理界面选择要使用的连接协议配置进行配置，如下图所示： AS2+AS3协议配置 IBM MQ或Toprow MQ协议配置 Rabbit MQ协议配置2、跨境企业录入完成连接协议配置信息后，需进行传输安全配置。6.1.1.3 传输安全配置一、 功能介绍传输安全配置包括IC卡/USBKEY安全配置、SJJ安全配置和SVS安全配置三个协议配置模块，用户自行选择要使用的安全方式进行配置。二、 操作流程1、用户在主菜单栏中选择配置管理下的基本信息管理，即可进入基本信息管理界面，在基本信息管理界面选择要使用的安全配置进行配置，如下图所示： IC卡/USBKey安全配置 SJJ安全配置 SVS安全配置2、跨境企业录入完成后，点击右下角保存按钮，系统将保存已填写好的基本信息。6.1.2 对接配置管理一、 功能介绍用于跨境企业当前已配置资源查询并可启动或停止当前配置资源。二、 操作流程1、用户在主菜单栏中选择配置管理下的对接配置管理，即可进入对接配置管理界面，系统根据查询条件显示资源配置信息，如下图所示：2、用户能够选择具体资源配置信息，点击全部开始按钮，全部启动当前配置资源。3、用户能够选择具体资源配置信息，点击全部停止按钮，全部停止当前配置资源。6.1.3 数据导入服务一、 功能介绍将跨境企业需发送的EXCLE文件转换成XML报文并自动添加数字签名进行传输,同时提供EXCLE模板下载。二、 操作流程1、用户在主菜单栏中选择配置管理下的数据导入服务，即可进入数据导入服务界面，如下图所示：2、在数据导入服务界面选择下载EXCLE模板。如下图所示：3、用户将EXCLE模板进行解压操作，如下图所示：4、用户填写完成EXCLE文件，点击上传按钮，将填写完成的EXCLE文件上传至系统。用户上传完成EXCLE文件，系统将跨境企业上传的EXCLE文件转换成XML文件。如下图所示：6.2 运维管理6.2.1 数据落地管理一、 功能介绍在数据落地查询模块下，能对落地数据进行查询操作。可以根据发送时间，接收时间，报文编号，报文名称等条件，清晰查看到系统传输报文。并能对正常或异常数据报文进行重发操作。二、 操作流程1、用户在主菜单栏中选择运维管理下的数据落地管理，即可进入数据落地管理界面，如下图所示：2、用户可选择正常或异常数据报文点击重发按钮进行重发操作6.2.2 报文异常管理一、 功能介绍系统异常管理分为系统异常和阻塞异常，系统管理员可以根据异常时间范围，线程名称，和异常信息等条件进行检索查询，即可清晰了解到当前系统出现的问题的原因。二、 操作流程1、用户在主菜单栏中选择运维管理下的报文异常管理，即可进入报文异常管理界面，如下图所示：6.2.3 报文阻塞管理一、 功能介绍系统异常管理分为系统异常和阻塞异常，系统管理员可以根据异常时间范围，线程名称，和异常信息等条件进行检索查询，即可清晰了解到当前系统出现的问题的原因。二、 操作流程1、用户在主菜单栏中选择运维管理下的报文阻塞管理，即可进入报文阻塞管理界面，如下图所示：7 应急处理7.1 应急处理流程具体突发问题视情况而定，可以直接联系维护人员。出现突发状况时，请及时上报。由维护人员及时修正问题，保证交换系统的稳定运行，确保用户的使用。7.2 预防措施工作范围：1、网络维护检查跨境电子商务进口统一版信息化系统客户端软件的各个组成部分的网络状况，保证网络的连接正常，网卡的使用正常。2、设备维护硬件维护：保证跨境电子商务进口统一版信息化系统客户端软件使用的各服务器的硬件环境使用正常。软件维护：保证操作系统，运行软件（IBM MQ(或Toprow MQ）及其他附属软件的运行正常。检查个服务器软件所需硬盘余量，监控磁盘空间，数据库空间，inode空间等。3、客户端维护保证参与跨境贸易相关跨境企业的传输报文跨境电子商务进口统一版信息化系统客户端软件运转正常。7.3 异常处理针对一些情况列出了如下处理方式：事件预防措施处理客户端操作系统断电安装UPS接电后系统支持自动重新启动功能，如果未启动可以人工快速介入启动相关系统，并且系统拥有重发机制，可以重发由于断电等灾难引起的未处理报文。系统日志中发现IC卡/USBKEY相关错误保证IC卡/USBKEY正常无密码错误重新插拔IC卡/USBKEY，重启客户端系统日志中发现加密机相关错误按高可用方案部署加密机恢复加密机