第1章  引言

1.1 编写目的和范围

本说明书针对需要进行RPA企业服务器系统升级操作的运维、研发、测试人员。

第2章  安装目录说明

以下 /isearch 安装目录为例

2.1 脚本文件说明

/isearch/bin：后台服务脚本。提供有start、restart、stop、status等操作。

/isearch/bin/elasticsearch.sh：elasticsearch服务脚本。

/isearch/bin/filebeat.sh：日志传送工具服务脚本。

/isearch/bin/logstash.sh：日志采集工具服务脚本。

/isearch/bin/gomysql.sh：gomysql服务脚本。

/isearch/bin/mysql.sh：MySQL服务脚本。

/isearch/bin/redis.sh：Redis服务脚本。

/isearch/bin/nginx.sh：Nginx服务脚本。

/isearch/bin/tomcat.sh：Tomcat服务脚本。

2.2 前端文件说明

/isearch/isa/front：为前端文件路径。

2.3 配置文件说明

/isearch/isa/conf：后台服务配置目录。

/isearch/isa/conf/elasticsearch：ES服务配置目录。

/isearch/isa/conf/filebeat：日志传送工具配置目录。

/isearch/isa/conf/logstash：日志采集工具配置目录。

/isearch/isa/conf/gomysql：gomysql配置目录。

/isearch/isa/conf/mysql：MySQL数据库配置目录。

/isearch/isa/conf/nginx：Nginx配置目录。

/isearch/isa/conf/redis：Redis配置目录。

2.4 后端文件说明

/isearch/isa/data/license：license证书存放目录。

/isearch/isa/datas/tomcat：后台服务端打包文件目录。

/isearch/isa/datas/tomcat/ROOT：后台服务端编译目录。

/isearch/isa/datas/tomcat/Snapshot：快照服务编译目录。

第3章  端口说明

3.1 Tomcat端口

默认端口：9080

3.2 Redis端口

默认端口：6379

3.3 MySQL端口

默认端口：3306

3.4 Elasticsearch端口

默认端口：6200

第4章  服务说明

4.1 Tomcat服务说明

启动服务：tomcat.sh start

停止服务：tomcat.sh stop

重启服务：tomcat.sh restart

查看状态：tomcat.sh status

4.2 Nginx服务说明

启动服务：nginx.sh start

停止服务：nginx.sh stop

重启服务：nginx.sh restart

查看状态：nginx.sh status

4.3 Redis服务说明

启动服务：redis.sh start

停止服务：redis.sh stop

重启服务：redis.sh restart

查看状态：redis.sh status

4.4 MySQL服务说明

启动服务：mysql.sh start

停止服务：mysql.sh stop

重启服务：mysql.sh restart

查看状态：mysql.sh status

4.5 Elasticsearch服务说明

启动服务：elasticsearch.sh start

停止服务：elasticsearch.sh stop

重启服务：elasticsearch.sh restart

查看状态：elasticsearch.sh status

第5章  日志查看

5.1 日志目录说明

/isearch/isa/logs：服务日志存放目录。

/isearch/isa/logs/redis：Redis日志目录。

/isearch/isa/logs/nginx：Nginx日志目录。

/isearch/isa/logs/mysql：MySQL日志目录。

/isearch/isa/logs/elasticsearch：elasticsearch日志目录。

/isearch/isa/rpadoc：RPA相关目录。

/isearch/tomcat/logs：tomcat日志目录。

/isearch/elasticsearch/logs：elasticsearch日志目录。

5.2 Tomcat日志

Tomcat所有日志存放目录，安装目录下：/isearch/tomcat/logs

启动日志：/isearch/tomcat/logs/catalina.out

系统日志：/isearch/tomcat/logs/rpasys.log，有日期为历史日志，无日期为当前日志。

任务状态更新日志：/isearch/tomcat/logs/jobstatus.log

第6章  修改密码操作

6.1 加密解密操作

将utils目录整个上传到服务器。并进入到utils目录。

或者windows本机有jdk环境，可以在windows下，进入 utils目录，打开cmd创建，并进入到该目录。

加密命令【注意替换type值】

java -jar isa-pass-util-1.0.0.jar type passwd

type:

    jasypt   application配置文件里面都是这种

    rsa      kibana在T_SYS_CONFIG表kibana-kibanaPasswd 中的密码用这个加密

6.2 Redis修改密码操作

进入到安装路径下：/isearch/isa/conf/redis/redis.conf。

在redis.conf配置文件中修改：requirepass 你的密码。

重启服务：安装路径下：/isearch/bin/redis.sh restart。

6.3 MySQL修改密码操作

使用有mysql客户端的命令行输入:

mysql -hIP地址 -u用户名 -p密码

use mysql;

set password for '用户名'@'%'='新密码';

quit;

6.4 Elasticsearch修改密码操作

第一步 在 elasticsearch.yml 中添加如下配置

安装路径下：/isearch/elasticsearch/config/elasticsearch.yml

# 配置X-Pack

http.cors.enabled: true

http.cors.allow-origin: "*"

http.cors.allow-headers: Authorization

xpack.security.enabled: true

xpack.security.transport.ssl.enabled: true

第二步 重启elasticsearch服务

安装路径下：/bin/elasticsearch.sh restart

第三步 设置elasticsearch密码

/isearch/elasticsearch/bin/elasticsearch-setup-passwords interactive

因为需要设置 elastic，apm_system，kibana，kibana_system，logstash_system，beats_system，

remote_monitoring_user 这些用户的密码，故这个过程比较漫长，耐心设置；

第四步 修改密码

下面的示例为将elastic的密码设置为"123456"。

curl -H "Content-Type:application/json" -XPOST -u elastic 'http://127.0.0.1:6200/_xpack/security/user/elastic/_password' -d '{ "password" : "123456" }'

第五步 验证

浏览器直接访问http://127.0.0.1:6200,会出现输入用户名、密码的弹窗，输入elastic和密码后，才能看到elasticsearch信息；

第六步 kibana.yml 修改（没有忽略）

末尾增加

elasticsearch.username: "elastic"

elasticsearch.password: "123456"

6.5 后台配置文件密码修改

安装路径下：/isearch/isa/datas/tomcat/ROOT/WEB-INF/classes/application-prod.yml

注意：修改完配置需要重启Tomcat服务。

重启服务：安装路径下：/isearch/bin/tomcat.sh restart

6.5.1 MySQL密码修改

spring:

# 数据源配置

datasource:

type: com.alibaba.druid.pool.DruidDataSource

driverClassName: com.mysql.cj.jdbc.Driver

druid:

url: jdbc:mysql://ISA_CURRENT_HOST:3306/isa?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=false&allowMultiQueries=true

username: isa

password: ENC(mysql密码密文)

6.5.2 Redis密码修改

redis:

host: ISA_CURRENT_HOST

port: 6379

password: ENC(redis密码密文)

6.5.3 Elasticsearch密码修改

# Elastic配置

elastic:

clusterHost: 127.0.0.1:6200

xpackSecurityUser: ENC(elastic密码密文)

第7章  后端配置文件说明

安装路径下：/isearch/isa/datas/tomcat/ROOT/WEB-INF/classes/application-prod.yml

注意：修改完配置需要重启Tomcat服务。

重启服务：安装路径下：/isearch/bin/tomcat.sh restart

7.1 数据源配置

# 测试环境配置

spring:

 # 数据源配置

datasource:

type: com.alibaba.druid.pool.DruidDataSource

driverClassName: com.mysql.cj.jdbc.Driver

druid:

url: jdbc:mysql://ISA_CURRENT_HOST:3306/isa?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=false&allowMultiQueries=true

username: isa

password: ENC(_MYSQL_PASS_)

     # 从库数据源

     # 初始连接数

initial-size: 10

     # 最大连接池数量

max-active: 100

     # 最小连接池数量

min-idle: 10

     # 配置获取连接等待超时的时间

max-wait: 60000

     # 打开PSCache，并且指定每个连接上PSCache的大小

pool-prepared-statements: true

max-pool-prepared-statement-per-connection-size: 20

     # 配置间隔多久才进行一次检测，检测需要关闭的空闲连接，单位是毫秒

timeBetweenEvictionRunsMillis: 60000

     # 配置一个连接在池中最小生存的时间，单位是毫秒

min-evictable-idle-time-millis: 300000

validation-query: SELECT 1 FROM DUAL

test-while-idle: true

test-on-borrow: false

test-on-return: false

stat-view-servlet:

enabled: true

url-pattern: /monitor/druid/*

filter:

stat:

log-slow-sql: true

slow-sql-millis: 1000

merge-sql: false

wall:

config:

multi-statement-allow: true

7.2 Redis配置

redis:

host: ISA_CURRENT_HOST

port: 6379

password: ENC(_REDIS_PASS_)

jedis:

pool:

       max-active: 8 # 连接词最大链接数

       max-wait: -1 # 连接池最大阻塞等待时间（负数代表没有限制）

       max-idle: 8 # 连接池最大空闲连接数

       min-idle: 0 # 连接池最小空闲连接数

       timeout: 10000 # 链接超时时间 （ms）,连接时间小会导致连接超时

7.3 国际化相关配置

# 国际化相关配置

messages:

encoding: UTF-8

basename: i18n/isaas

default: DEFAULT_LANG

7.4 Elasticsearch配置

# Elastic配置

elastic:

clusterHost: 127.0.0.1:6200

xpackSecurityUser: ENC(_ES_PASS_)

connectTimeout: 1000

socketTimeout: 30000

connectionRequestTimeout: 500

maxConnTotal: 30

maxConnPerRoute: 10

7.5 邮箱配置

# 邮件相关配置

email:

 # smtp邮件服务器

debug: false

 # smtp邮件服务器

smtpServer: smtp.exmail.qq.com

 # 协议

protocol: smtp

 # 端口号

smtpPort: 465

 # 发送邮箱

sendEmail:

 # 发送邮箱用户名

sendEmailName:

 # 邮箱密码

emailPassword:

 # 邮箱主题

emailTitle:

 # 非企业邮箱黑名单

blackEnterpriseEmail: .+@.*(?i)(qq|163|126|139|aistreamrpa|sohu|hotmail|aliyun|baisonmail|live|gmail|sina|dingtalk|foxmail|alibaba|uipath|kingsware|outlook|aistreamrpa|yeah|icloud|027168|chacuo|linshiyouxiang|wo|189|alibaba-inc|skyon|guerrillamail|ali-exmail|duplicall|j1robot)\.(?i)(com|cn|com\.cn|net|co\.jp|org)

7.6 文件相关配置

# 文件上传相关配置

file:

 # license文件存放路径

licensePath: ISA_BASE_HOME/isa/data/license/

 # ipkg包存放目录

ipkgPath: ISA_BASE_HOME/isa/rpadoc/ipkg/

 # ipkg解压后存放目录

ipkgDirPath: ISA_BASE_HOME/isa/rpadoc/ipkg/dirs/

 # 流程图标存放目录

iconImagePath: ISA_BASE_HOME/isa/rpadoc/icon/

 # 流程预置图标存放目录

iconPngPath: ISA_BASE_HOME/isa/rpadoc/preset/icon/

 # 自定义组件存放目录

ilibPath: ISA_BASE_HOME/isa/rpadoc/ilib/

 # 自定义组件临时目录

ilibTempPath: ISA_BASE_HOME/isa/rpadoc/ilib/temp/

 # 共享文件存放目录

shareFilePath: ISA_BASE_HOME/isa/rpadoc/share/

 # 共享文件删除目录

shareFileDeletedPath: ISA_BASE_HOME/isa/rpadoc/share/delete/

 #批量下载文件时压缩包的存放目录

fileZipPath: ISA_BASE_HOME/isa/rpadoc/share/zip/

 #运行参数配置上传文件临时目录：

fileTemp: ISA_BASE_HOME/isa/rpadoc/param/tmp/

 #运行参数配置上传文件正式目录：

fileFormal: ISA_BASE_HOME/isa/rpadoc/param/formal/

 #离线录屏文件上传临时目录

offlinePath: ISA_BASE_HOME/isa/data/sessionFiles

 #升级包上传临时文件目录

uppkgTemporaryFile: ISA_BASE_HOME/isa/tmp/uppkg/

 #升级包上传正式文件目录

uppkgFile: ISA_BASE_HOME/isa/rpadoc/uppkg/

 #tomcat文件地址

tomcatPath: ISA_BASE_HOME/tomcat/logs/

 #es日志文件地址01

esIsaPath: ISA_BASE_HOME/isa/logs/elasticsearch/

 #es日志文件地址02

esPath: ISA_BASE_HOME/elasticsearch/logs/

 #filebeat日志文件地址

filebeatPath: ISA_BASE_HOME/isa/logs/filebeat/

 # 流程图标显示url无域名前缀

imgUrl: /doc/icon/

 # 流程图标png显示url无域名前缀

imgPngUrl: /doc/preset/icon/

 # ipkg下载url无域名前缀

ipkgUrl: /doc/ipkg/

 # ipkg解压后文件显示url无域名前缀

ipkgDirUrl: /doc/ipkg/dirs/

 # 自定义组件显示下载url无域名前缀

iLibUrl: /doc/ilib/

 # 共享文件显示url无域名前缀

shareFileUrl: /doc/share/

 # 运行参数配置上传正式文件的url

fileFormalUrl: /doc/param/formal/

 # 录像文件存放路径

sessionImage: ISA_BASE_HOME/isa/rpadoc/thumbnail/

 # 下载设计器

rpaClientInstall: /doc/install/CosmicRPAInstall_kingdee.exe

7.7 服务器相关配置

#服务器相关配置

deploy-server:

 #当前服务器自身IP

 #老的RPA做法是直接配置网口,但是由于Java基于网口获取IP不准,不如直接配置

ip: ISA_CURRENT_HOST

recorder:

   #数据包最大长度 1920 X 1080 X 4

socketBodyLength: 8294400

   #录像默认存放地址,地址可在页面设置配置

socketFile: ISA_BASE_HOME/isa/data/session/

   #最大录像数

socketLimit: 300

https:

   #是否开启录屏上传

opened: true

   #录屏文件上传路径

httpPath: ISA_BASE_HOME/isa/data/session/

   #nginx上传url

httpUrl: /sessionUpload

userOrgAuthNum: 10

第8章  数据清理

8.1 Redis缓存清理

注：谨慎操作，如有需要再执行缓存清理操作。

可以用RDM桌面客户端可视化操作redis，也可以用命令行操作。

redis-cli清理redis缓存命令：

flushall：清空整个 Redis 服务器的数据(删除所有数据库的所有 key )。

flushdb：清空当前数据库中的所有 key。

8.2 解决Redis异常报错不能持久化

可以用RDM桌面客户端可视化操作redis，也可以用命令行操作。

redis-cli命令：

config set stop-writes-on-bgsave-error no

8.3 MySQL文件清理

使用有mysql客户端的命令行输入:

mysql -hIP地址 -u用户名 -p密码

reset master;

quit;