南粤智能柜台信创改造项目软件安装手册
广州南粤银行
广州南天电脑系统有限公司
2022年11月
文档修订信息
版本 | 修正章节 | 日期 | 作者 | 变更记录 |
V2.0.0.0 | 全部 | 2022/11/04 | 冯莉 | 创建 |
目录
南粤智能柜台信创改造项目软件安装手册............................................................................. 1
1. 应用预安装环境配置...................................................................................................... 4
1.1. 系统基本配置........................................................................................................................................... 4
1.2. 字体安装.................................................................................................................................................... 4
1.3. JDK安装.................................................................................................................................................... 4
1.3.1. 准备JDK包.................................................................................................................................... 4
1.3.2. 配置环境变量................................................................................................................................. 5
1.4. 各厂商通用处理....................................................................................................................................... 6
1.4.1. 备份原应用日志（若需要）....................................................................................................... 6
1.4.2. 安装SP............................................................................................................................................ 9
1.4.3. 安装设备接口服务........................................................................................................................ 9
1.4.4. 检查应用安装所需目录................................................................................................................ 9
1.4.5. 开放应用需要的端口.................................................................................................................... 9
1.4.6. 设置自动登录............................................................................................................................... 11
1.5. 各厂商特殊处理.................................................................................................................................... 12
2. 应用安装.................................................................................................................... 12
2.1. 解压安装包............................................................................................................................................. 12
2.2. 授予修改时间权限................................................................................................................................ 14
3. 应用配置.................................................................................................................... 14
3.1. 终端参数配置......................................................................................................................................... 15
3.2. 应用参数配置......................................................................................................................................... 16
3.3. 通讯参数配置......................................................................................................................................... 17
3.4. PBOC参数配置..................................................................................................................................... 17
4. 应用退出.................................................................................................................... 19
5. 应用卸载.................................................................................................................... 19
6. 终端应用的目录和文件................................................................................................. 19
硬件配置：
CPU：Phytium, FT-2000/4，四核，主频2.6～3.0GHz；
内存：DDR4，8G以上；
硬盘：128G以上固态硬盘
软件配置：
统信：
桌面操作系统：
版本号：20；
版本：专业版；
类型：64位；
STM信创应用涉及字体：
中文：思源黑体（可免费商用）
安装方法：
将相关的字体文件，放到以下目录：
/usr/share/fonts/
需要root用户权限，可能需要输入root用户密码
JDK包由厂商自行准备！ JDK务必选择1.8及以上版本
将JDK包放入任意路径，这里演示放在了主目录下
1.进入系统盘/etc这个文件夹
2.在终端输入命令行sudo vim profile ，并输入密码
3.进入后在文件末尾加入形如下图的两句配置项
说明：上图中的红色背景的命令为JDK包的bin路径和JDK路径
（生产以实际路径为准，截图仅供参考）
注意！长城的设备需要注释下面代码
通过编辑OpenJDK的accessibility.properties文件
sudo
vim /etc/java-8-openjdk/accessibility.properties
注释掉下面一行
assistive_technologies=org.GNOME.Accessibility.AtkWrapper
l 操作员装机要求：
需要熟悉linux基本操作命令和vi编辑器的使用。
l 系统检查:
用户名是 nyxcstm
（如果是第一次安装STM信创应用，则略过该步骤）
对于非第一次安装应用（即由于发生不可抗力导致需要重装应用的情况），需要备份原应用的一些信息；
提供以下两种方式进行数据备份：
方式一：进入应用目录直接拷贝应用日志及数据库文件
1、日志备份：进入应用目录（/home/nyxcstm/nantian/）,找到NTLOG文件夹，拷贝该文件。（nyxcstm是用户名，生产以实际用户名为准）
2、数据库文件备份：进入应用数据库目录（/home/nyxcstm/nantian/rdp3.1/NtMainProcess/classes/），找到数据库文件NtData.db，拷贝该文件。（nyxcstm是用户名，生产以实际用户名为准）
完成后保留该日志文件夹与数据库文件，一直到重新完整安装应用后，再放至应用目录下。
方式二：通过以下脚本操作
进入应用目录（/home/nyxcstm/nantian/），找到cp_before_uninstall.sh
双击执行，弹出框如下
点击运行，执行完成后将在用户目录（/home/nyxcstm/）生成压缩包（命名：NT_DATA_BACKUP.zip）
完成后保留该文件（在确保文件及所在路径不损害不丢失的情况下，可以不用另外保存），一直到重新完整安装应用后，进入应用目录（/home/nyxcstm/nantian/），找到move_after_reinstall.sh，
双击执行，完成操作。
按照厂商提供的SP安装包及安装文档，完成SP的安装。
按照厂商提供的设备接口服务安装包及安装文档，完成设备接口服务的安装。
1、用户目录：/home/nyxcstm/
2、用户桌面目录：/home/nyxcstm/Desktop/
3、用户开机自启动目录：/home/nyxcstm/.config/autostart/
4、开始菜单目录：/usr/share/applications/
以上目录必须存在，如果不存在，需要手动创建目录。
终端通讯监听需要打开设备上的端口9000（代理监听端口，接收V端参数下发）、18802（C端监听端口）、7678（代理监听端口，接收V端远程指令），18080（设备接口服务），18081（组件接口服务），8081（密码键盘监听端口），在防火墙开启的情况下，可能阻止本地监听，导致升级不成功，所以安装时务必开放端口或者关闭防火墙。
1.4.5.1. 检测端口是否被其他程序占用
检测步骤如下：
1. 在应用关闭的情况下，点击开始菜单-终端，打开一个终端窗口；
图表 1开始-终端
2. 输入命令netstat -lnt |
grep 18801,查看端口，查看有没有相应记录，如果没有记录会显示如下:
说明：上图中的红色背景的命令为需要输入的命令。
3.同样的方法，检查18802、18803、18080和18081，8081是否被占用。
1.4.5.2. 检测端口是否成功开启
检测步骤如下：
1.在应用开启的情况下，点击开始菜单-终端，打开一个终端窗口；
2.输入命令netstat -lnt |
grep 18081, 查看端口，查看有没有相应记录，记录的状态为“LISTEN”。
说明：上图中的红色背景的命令为需要输入的命令。
统信系统：
点击开始菜单－控制中心－账户，打开账户窗口：
勾选：自动登录
暂无
手动解压XCSTMSetup2.0.0.0.zip压缩包，获取安装包文件：STMC_XC_Release_2.0.0.0.zip、rdpInstall.sh。
安装包文件STMC_XC_Release_2.0.0.0.zip和rdpInstall.sh；
把文件放到/home/nyxcstm/ 目录下,选择开始菜单->终端，打开一个终端窗口，在终端窗口中输入cd 命令回到主目录，并用pwd命令确认，然后用命令sh执行rdpInstall.sh进行安装。
说明：上图中的红色背景的命令为需要输入的命令；
涉及使用 sudo 命令可能需要输入密码，请提前联系设备厂商获取密码。
安装参考下图：
图表 6pwd命令确认，然后用命令sh执行rdpInstall.sh进行安装
图表 7输入设备厂商提供的密码
图表 8点击“允许”（麒麟系统没有此提示）
图表 9提示安装成功
检查开机启动项是否已有"rdp.desktop"，命令：cd .config/autostart回车；ls，回车。
图表 10检查开机启动项是否已有"rdp.desktop"
执行指令cd /etc/sudoers.d,检查/etc/sudoers.d目录下是否有文件“sudoers_rdp”
说明：上图中的红色背景的命令为需要输入的命令；
安装完成后，需先对应用进行配置：双击运行桌面“南天rdp配置工具”快捷图标，将会启动参数配置。
图表 11桌面"南天rdp配置工具"快捷图标
3.1. 终端参数配置
图表 12终端参数配置
终端参数配置说明如下：
终端参数设置项 | |
终端参数配置项 -终端参数配置 | 变量 | 值 | 描述 | |
DeviceNo | | ** 设备号 | |
注：值必须按照实际情况填写，可参考已投产设备参数配置；
3.2.应用参数配置
图表 13应用参数配置
终端参数配置说明如下：
终端参数设置项 |
终端参数配置项 -应用参数配置 | 变量 | 值 | 描述 |
CamType | | ** 请从以下机型中选择: GRG-广电运通,GWI-长城，INSPUR-浪潮 |
WaitDvcTime | | ** 等待SP启动时间，单位毫秒 |
注：值必须按照实际情况填写，可参考已投产设备参数配置；
3.3.通讯参数配置
图表 14通讯参数配置
终端参数配置说明如下：
终端参数设置项 |
终端参数配置项 -通讯参数配置 | 变量 | 值 | 描述 |
HostIP | 198.198.32.222 | ** 前置IP |
HostPort | 6088 | ** 前置端口 |
MonitorIP | 198.198.32.221 | ** 监控IP |
注：值必须按照实际情况填写，可参考已投产设备参数配置；
该页全部参数，安装包已经默认设置成生产环境的配置信息；
图表15 PBOC参数配置
终端参数设置项 |
终端参数配置项 -PBOC参数配置 | 变量 | 值 | 描述 |
ICCLOpen | | **是否要启用非接IC卡交易，1为启用,0为不启用 |
ICProtocol | 默认 | **IC卡通讯协议 |
ICTimeOut | 默认 | **IC卡通讯超时时间 |
ICPSEName | 默认 | **支付系统目录文件名 |
ICAIDList | 默认 | **AID列表 |
ICCreditDebitAID | 默认 | **借记/贷记应用 |
ICDebitAID | 默认 | **借记应用 |
ICCreditAID | 默认 | **贷记应用 |
ICQuasiCreditAID | 默认 | **准贷记应用 |
ICECAID | 默认 | **电子现金应用 |
ICCountyCode | 默认 | **国家代码 |
ICDA | 默认 | **是否要做脱机数据认证 |
ICDDA | 默认 | **是否需要做动态认证,1为需要,0为不需要 |
ICSDA | 默认 | **是否需要做静态 |
ICCDA | 默认 | **是否要做CDA |
ICTerAppVer | 默认 | **终端版本号 |
注：值必须按照实际情况填写，可参考已投产设备参数配置；
l 以上步骤完成之后重启操作系统，应用会自动启动。
l 应用启动成功后进入正常对外服务界面，此时可进行非现金类交易，待机界面如下图所示：
方法：
进入维护->用管理员用户登录->选择系统管理->关闭应用；
方法：
在用户目录下执行以下指令，卸载应用
cd
nantian(进入nantian目录) ； pwd（检查路径）
ls（显示指定工作目录下的内容）； sh rdpUninstall.sh（执行卸载）
/home/nyxcstm/nantian/ | |
rdpstart.sh | 启动脚本 |
rdp3.1/ | RDP应用目录 |
rdp3.1/NtMainProcess | RDP组件服务 |
NTAgent | RDP代理目录 |
NTLOG/ | 日志目录 |
NTLOG/NtTraceLog/bak | 应用日志备份 |
NTLOG/NtTraceLog/trace | 当天应用日志 |
NTLOG/NtTraceLog/update | 终端应用版本升级日志 |
NTLOG/ NTAgentLog / | 代理日志目录 |
