软件配置安装
软件配置安装
本说明书针对需要进行RPA企业服务器系统安装操作的运维、研发、测试人员。
目录文件说明
- 脚本目录:bin 为脚本存放目录。主要指企业服务器安装成功后,各应用的启动脚本文件;
- 程序包目录:com_pkg 为程序包目录。相关应用程序安装包存放位置;
- 应用配置文件:config 目录为系统各应用相关配置文件存放目录。各应用安装时和安装后,会使用该目录中对应的配置文件,对应用的配置信息进行配置;
- 初始数据目录:
- Elasticsearch索引初始化- elasticsearch 目录下,包含了 elasticsearch 需要初始化的索引配置文件信息以及别名创建信息。目前部分索引创建版本号已经为2.0。在程序代码中,使用索引时,均使用别名,方便索引的改名和数据迁移
- app应用- 后端微服务及 nacos 、xxl-job 等服务执行文件存放位置
- Mysql数据库初始化脚本- 该目录会有两种脚本,dml.sql dml 相关脚本:主要是新增、修改、删除表数据和调用并删除函数;ddl.sql ddl 相关脚本:主要是建表;修改表结构、注释;创建索引等 ddl 语句。这两个 sql 脚本,可以用于手动执行
- 前端项目- fronts 目录存放前端项目文件
- rpadoc资源文件- 该目录存放系统相关资源文件及临时数据
- 安装脚本目录:py_install 为 py 安装程序脚本文件目录。非专业人员,请勿修改该目录下文件;
- Python服务目录:pyserver 存放 python 基础项目,为java提供基础接口调用服务;
- 工具目录:
- 密码加密工具目录- 企业服务器相关应用配置文件中,一些密码配置项采用了密文保存。故对用户安装时设置的密码需要进行加密并更新到配置文件中。该工具实现从明文到密文的加密
- Python3标准库- Python-3.9.1 版本的 python3 标准库,是用于执行安装程序脚本的基本。请勿随便改动
安装方法
- 安装前注意
安装人员,在拿到安装包后,请使用安装用户,上传到 /tmp 目录。如果 linux 系统没有 /tmp 目录,请上传到一个安装用户能正常访问的目录。但不能上传到最终程序要安装的目录。之后在安装用户下进行安装。 例如:
- 如果用 root 安装,则用 root 用户上传到 /tmp 目录。并且后续安装用 root 用户
- 如果用 isearch 安装,则用 isearch 用户上传到 /tmp 目录,没有 /tmp 目录,可以放在 /home/isearch 目录下。并且后续安装用 isearch 安装。 切记避免使用 root 上传,用 isearch 安装。更要避免用root解压安装包,用 isearch 安装
注意
- Linux 依赖 gcc、gcc-c++、openssl-devel、make 依赖库环境;如果是 CentOS、EulerOS ,可以通过在线安装依赖库,安装命令: yum install -y gcc gcc-c++ openssl-devel make ;暂不支持离线安装,离线情况请安排运维提前安装 gcc、gcc-c++、openssl-devel、make 依赖库环境。
- 华为 EulerOS 如果使用root账号安装,必须把安装目录授权给isearch,否则会获无权限读取安装日志文件。
- 交互注意
在安装过程中,大部分需要注意的交互提示,程序都会进行提醒,请认证阅读安装程序打印的提示内容。
上传后解压安装目录。并进入到目录中,执行如下命令对安装脚本进行赋权:
chmod +x install.sh
chmod +x py_install/*.py
要进行程序安装,请用如下: ./install.sh -p isa1qaz2wsx 类似的命令。具体看下图所示:
注意
密码不能太简单,否则可能导致 elasticsearch 的认证授权配置不生效。
安装常见问题
- 坏的解释器
此错误主要由于安装脚本等在 Linux 下的可执行文件的文件结尾为 Windows 字符格式,需将其转换为 Linux 格式。
使用如下命令进行修复:
sed -i ‘s/\r$//‘ xxxxxxx.sh
这类启动脚本包括:
- bin 目录下所有脚本。这些脚本的文件格式错误时,会出现安装后,相关应用无法正常启动
- py_install 目录下的 py 脚本
- install.sh 文件本身
- 其他应用中相关的需要执行的脚本文件
- 安装后应用无法启动
一种情况是由于相关应用的启动脚本文件格式错误。另外的情况需要自行定位,根据相关应用的启动报错信息来判断。
- 安装后无法申请导入许可异常
检查 linux 环境是否支持 ifconfig 命令。如果不支持,请安装net-tools组件。安装方法同安装依赖包的安装方法。组件名称net-tools。
- 安装后登录验证码异常
Linux 环境 fontconfig 字体包缺失或者版本较低,建议版本2.13以及以上版本。使用如下命令:
rpm -q fontconfig # 查看服务器是否安装字体包
yum -y install fontconfig # 安装字体包
附录
Ulimit配置
- 修改配置文件limits.conf:
vi /etc/security/limits.conf
在文档最后添加如下信息:
isearch soft nproc 65536
isearch hard nproc 65536
isearch soft nofile 65536
isearch hard nofile 65536
注意
最前面的isearch为安装启动应用的用户名。如果已经有该用户配置,将最后的数值改成65536
- 修改配置文件sysctl.conf
- 使用如下命令;
vi /etc/sysctl.conf
- 在文件中增加配置项。
vm.max_map_count = 6553600
kernel.sem = 250 32000 100 128
- 修改后如下图所示;
注意
修改前检查下,是否已经有相关配置
- 执行
sysctl -p
命令,使配置立即生效;
显示信息中包含配置的配置项即可。
- 修改配置文件20-nproc.conf
vi /etc/security/limits.d/20-nproc.conf
如果文件不存在,去limits.d目录下查看是否有类似名字的文件。在配置最后增加如下配置:
isearch soft nproc 65536
如果已经有对应的isearch用户配置时,修改后面的值为65536即可。
安装依赖包
如果用户自行提供已经安装好的操作系统,可能会缺少必要的软件包,因此需要手动安装,下面指令分别为应用安装所需软件包、HA所需软件包及NFS所需软件包。如果服务器未连接互联网,则需要配置本地yum源,请参考下节。
如果服务器所在环境有公网,只是服务器本身不能联网,则在root下添加以下配置:
vi resolv.conf
nameserver 8.8.8.8
然后执行下面命令,加载依赖库
yum install -y gcc gcc-c++ openssl-devel make
如果服务器所在环境没有外网,需要如下操作:
请先上传当前操作系统版本的安装镜像至/root/目录,这里以 Centos6.5 为例,镜像名为 CentOS-6.5-x86_64-bin-DVD1.iso,以按实际情况配置,切记不要直接抄下面的代码:
- 创建ISO系统镜像挂载目录- mkdir /mnt/yum-iso
- 挂载系统镜像- mount -o loop /root/CentOS-6.5-x86_64-bin-DVD1.iso /mnt/yum-iso/
- 创建yum源目录- mkdir /yum/
- 复制镜像文件到yum源目录,使用如下命令:
cp -a /mnt/yum-iso/ /yum/
ll /yum/
ll /yum/yum-iso/
- 打开yum源配置目录- cd /etc/yum.repos.d/
- 备份yum源配置文件- tar -zcvf repo-bk.tar.gz CentOS-*
- 删除影响本地yum源文件- rm -f CentOS-Base.repo CentOS-CR.repo CentOS-Debuginfo.repo
- 配置本地yum源文件,使用如下命令:
vi CentOS-Media.repo
[c7-media]
name=CentOS-$releasever - Media
baseurl=file:///yum/yum-iso/
gpgcheck=0
enabled=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7
配置repo路径、关闭gbp校验、启用这个repo
- 清除yum源缓存- yum clean all
- 创建yum源缓存- yum makecache
- 测试使用本地yum源安装软件包- yum -y install gcc
安装检测
为检测服务器是否安装成功,可以访问服务器地址:https:// ip地址
- 用户名- admin
- 密码- is1arch-u1ba
为防止所有端口被禁用,导致页面无法访问和使用,如果对安全要求不是那么高,可以直接切换至root用户关闭防火墙:
systemctl stop firewalld.service # 关闭防火墙systemctl disable firewalld.service # 开机禁用防火墙自启命令