RPA日常运维与升级操作

日常运维与升级操作 1. 中控服务启停 1）启动服务命令 如果服务停止后，需要重新启动服务，使用部署的配置文件 执行 命令 # 需要输入参数，以确定启动的范围，all所有服务，ctrl 中控，ciri，mid 中间件 ./run.sh start -f user_param.yml -s all 2）停止服务命令 部署成功后，如果需要停止所有服务，可使用部署的配置文件 执行命令 # 需要输入参数，以确定停止的范围，all所有服务，ctrl 中控，ciri，mid 中间件 ./run.sh stop -f user_param.yml -s all 3）查看服务状态命令 部署成功后，如果需要查看服务状态，可使用部署的配置文件 执行 命令 ./run.sh status -f user_param.yml 4）启停license服务 license由systemctl 控制自动重启，需要给license所在的服务器的rpa用户添加sudo权限，root用户执 行以下命令： #为rpa用户添加sudo权限，4.5版需要执行，4.6及之后版可跳过此步骤 chmod u+w /etc/sudoers echo "rpa ALL=(ALL) NOPASSWD: ALL" >> /etc/sudoers chmod u-w /etc/sudoers #启动 sudo systemctl start license #停止 sudo systemctl stop license #查看状态 sudo systemctl status license

2. 中控服务端升级 注意：在开始进行系统升级操作之前，请一定做好数据(特别数数据库数据)备份相关工作，如果现场 (含客户)缺乏相关备份脚本能力，也可参照系统数据冷备方案执行。具体见：中控数据冷备方案 同时，在升级之前还需要对整个中控系统的状态进行检查，确保中控系统各个服务的状态是正常 的，如果系统服务有异常需要先解决异常让中控恢复正常后，才可执行升级操作。 升级会根据配置文件停服务、备份docker-compose.yml文件、部署服务、起服务。 1) 升级操作 升级时先备份c3po部署目录，解压新安装包，使用上次部署时的配置文件user_param.yml，执行升级命 令 下面命令中的安装包名、安装目录路径、配置文件名称均为示例，在实际升级过程中需要根据现场 环境进行修改 # 备份原来的安装目录 cd /data mv /data/c3po-4.6.Beta c3po-4.6.Beta-bak # 解压新的安装包（示例升级到c3po-4.6.Beta.BT1） tar -zxvf Controller-installer-4.6.Beta.BT1-standalone.tar.gz # 给rpa用户授权新安装目录权限 chown -R rpa:docker c3po-4.6.Beta.BT1/ # 如果是4.3及之前的版本要升级到4.5及以后的版本，需要执行：给rpa用户sudo权限（**注意:每台机器都需要操作一下**） chmod u+w /etc/sudoers echo "rpa ALL=(ALL) NOPASSWD: ALL" >> /etc/sudoers chmod u-w /etc/sudoers # 切换为rpa用户 su rpa # COPY之前的安装配置文件 cp c3po-4.6.Beta-bak/user_param.yml c3po-4.6.Beta.BT1/ # 如果是从5.0之前的版本升级到5.0及之后的版，需要在配置文件中增加安装backup_system服务配置，否则会影响minio中录屏文件的清 host_list: - ipaddr: 172.25.128.111 username: rpa password: 1234 services: - backup_system #5.0RC之后版本需要增加此服务，用于文件备份与录屏文件清理 # 进入新的安装目录并执行升级命令 cd c3po-4.6.Beta.BT1/ ./run.sh upgrade -f user_param.yml 2）当一台服务器安装了多个产品服务时升级注意事项 A_问题触发条件 1） 在同一台服务器上，分别独立安装了不同的产品(中控/CIRI/APPS/IDP/Common Service)，也就是 在同一台服务器上部署了多个产品的服务(含部分)，比如：安装了中控的mananger服务，同时还安装部 署了CIRI。 注意：如果是一次性整合安装的则不会存在这个问题，比如用同一个安装包同时安装了中控和 CIRI。 2） 在安装时所配置的【base_dir】是相同的，比如：都是使用了默认设置base_dir: /data/cyclone。 3） 对某个产品进行了升级操作。 B_问题描述 由于目前各个产品均使用的是C3PO的部署方式，在进行系统更新升级时，升级脚本会先 对/data/cyclone/rpaplatform目录(具体)下的docker-compose.yml文件进行备份操作，然后再创建新 的docker-compose.yml文件并写入相关配置信息。因此，每次执行一次升级操作之后，新创建的 docker-compose.yml文件中只有本次执行升级产品的对应配置内容。而其他产品对应的配置内容则会 被清除，而这会影响后续对应产品的正常使用和维护。 为什么安装的时候没有问题?因为安装时采用的是创建或者追加写入docker-compose.yml的逻辑， 所以不存在这个问题。 C_解决方法 在每次执行完产品升级操作后，需要人工去将docker-compose.yml文件中的内容进行合并处理，将(升 级时所创建的)备份文件中其他产品对应的配置内容，合并到docker-compose.yml文件中。 合并docker-compose.yml内容即可，无需进行其他相关服务启停等操作。 因此也建议前场，尽可能的避免在同一台服务器上去安装部署多个产品的服务，避免出现各种异常 问题。 3）关于流程任务录屏文件存储的注意事项 产品在4.6之前的版产品是默认将流程执行的录屏文件存放在数据库的，4.6及之后的版本调整为将录屏文 件默认存放在minio中了。因此，如果是从4.6之前的版本升级到5.0RC，需要注意： 1）任务录屏文件会默认存放在minio中，如果之前是存放在数据库中的，则会导致升级后在中控上查看 不到原来的录屏文件 2）如果用户一定要求把录屏继续存放在数据库中，则可以在升级前在user_param文件加配置 screen_file_storage：“database”，或者是在升级后修改对应的配置参数(在docker-compose.yml中的 rpa_orc_serv服务下新增或修改：APP_PLUGIN_SCREEN_FILE_STORAGE = database)。 将录屏文件存放在数据库中，随着时间推移录屏的数据量越来越大的话，会影响整个数据库的性 能，因此在无特别要求的情况下强烈建议客户将录屏文件存放在minio中。 3. 重新部署中控 若重新部署服务，请先将上一次部署的服务停掉，并清理删除服务器环境等。 ./run.sh stop -f user_param.yml rm -rf /data/cyclone/rpaplatform #使用root或者sudo权限 如果是服务镜像有更新，则还需要删除旧的镜像服务 docker image rm -f (要删除的镜像ID) 如果是所有镜像都有更新，则执行下列命令： docker rmi $(docker images -aq) 最后再重新执行apply命令 ./run.sh apply -f user_param.yml 4. 其他（更新镜像、修改系统参数、环境变量和配置等） 1）更新某个服务镜像 镜像文件默认以镜像名称最后一部分命名，如镜像 nexus-docker.mycyclone.com/orchestrator/orchestrator-manager:rpa-1.0.Alpha对应文件名称 orchestrator-manager.tar，将打好的镜像文件放到c3po/package下面，执行apply部署命令。 docker save nexus-docker.mycyclone.com/orchestrator/orchestrator-manager:rpa-1.0.Alpha | gzip > orchestrator-manager.tar 2）配置APP_JAVA_OPTS相关参数 修改docker-compose.yml文件，默认在目录/data/cyclone/rpaplatform下，(具体根据参数base_dir而 定) A. 修改jvm参数 cd /data/cyclone/rpaplatform vi docker-compose.yml #修改对应服务的environment中的APP_JAVA_OPTS参数，如 - APP_JAVA_OPTS=-Dlogging.level.ROOT=INFO -Dlogging.level.robotics=INFO -Xmx512m -Xms512m ：wq #保存退出 docker-compose up -d 服务名 B. 修改参数中控文件管理，约束上传的文件后缀 服务：rpa_cs 功能：中控文件管理，约束上传的文件后缀 参数位置：APP_JAVA_OPTS 举例：-Drpa.server.file.upload.types=xlsx,xls,doc,docx,ppt,pptx,txt,zip,rar,7z,png,jpeg,jpg,pdf,tar,mrpa,mrpax #重启 docker-compose stop rpa_cs docker-compose rm -f rpa_cs docker-compose up -d rpa_cs 3）配置环境变量说明 修改docker-compose.yml文件，默认在目录/data/cyclone/rpaplatform下，(具体根据参数base_dir而 定) A. 修改配置远程访问执行器的端口 cd /data/cyclone/rpaplatform vi docker-compose.yml #修改rpa_orc_serv的environment中的APP_RC_REMOTE_CLIENT_PORT参数 rpa_orc_serv: container_name: rpa_orc_serv cpus: 4 environment: ... - APP_RC_REMOTE_CLIENT_PORT=3389 ：wq #保存退出 #重启 docker-compose stop rpa_orc_serv docker-compose rm -f rpa_orc_serv docker-compose up -d rpa_orc_serv 一定要注意yaml文件变量的正确格式填写