RPA Orchestrator 업그레이드

업그레이드 사전 체크

업그레이드 진행 하기 위한 사전 준비 사항으로 설치 패키지 준비와 기존 서비스의 백업이 필수 입니다. (아래의 사전 체크 과정은 sudo 권한이 있는 ipaadm 계정으로 진행 가능)

설치 패키지 다운로드

SAMSUNG SDS Support Portal을 통해 설치 패키지를 다운로드하세요.
Support Portal 가입 및 설치 패키지 다운로드 방법은 Brityrpa.ai의 [문의하기]를 통해 문의하세요.
설치 패키지의 크기는 약 1.7 GB입니다.

업그레이드 가능 버전 확인

사용중인 버전이 2.0.1 이상 버전인 경우 3.0.0 으로 업그레이드가 가능합니다.

1.6.X 버전을 사용중인 경우 2.0.1 으로 먼저 업그레이드 한 후 3.0.0 업그레이드를 해야 합니다.

업그레이드 사전 백업

어플리케이션 백업

디스크가 충분하다면 /rpa 폴더를 통으로 백업하면 좋습니다.
- 디스크 남은 용량 확인
 df -h

- /rpa 디렉토리 용량 확인 (오래걸림)
 du -sh /rpa

- /rpa 디렉토리 풀 백업 방법
 cp -r /rpa /rpa_bak
어플리케이션 설정 파일만 백업 할 경우 필수로 백업할 파일 입니다.
- RPA 서비스 설정 
 /rpa/properties/application.properties
 /rpa/apps/gateway/application.properties
 /rpa/apps/comm/application.properties
 /rpa/apps/textrecognitionServer/application.properties

- RPA 서비스 실행 쉘
 /rpa/apps/auth/run.sh
 /rpa/apps/comm/run.sh
 /rpa/apps/core/run.sh
 /rpa/apps/gateway/run.sh
 /rpa/apps/scheduler/run.sh
 /rpa/apps/tenant/run.sh
 /rpa/apps/textrecognition/run.sh
 /rpa/apps/workflow/run.sh

- 포털 설정
 /rpa/apps/admin/admin/WEB-INF/classes/properties/comm.properties
 /rpa/apps/admin/user/WEB-INF/classes/properties/comm.properties
 /rpa/apps/admin/tenant/WEB-INF/classes/properties/comm.properties

DBMS 백업

OSS에 대한 운영 가이드는 솔루션 기술지원 범위가 아니어서, 해당 문서에는 포함이 되어 있지 않습니다. 
백업방법 링크를 참조하세요.

https://mariadb.com/kb/en/library/backup-and-restore-overview/

https://dev.mysql.com/doc/mysql-backup-excerpt/8.0/en/backup-and-recovery.html

RPA Orchestrator 업그레이드 하기

운영중인 서비스 종료

Mariadb 서비스는 실행중이어야 업그레이드가 가능하다.
Tomcat, RPA Service, ActiveMQ 서비스를 종료한다.
- Tomcat, RPA Service, ActiveMQ 서비스를 종료한다.
cd /rpa/bin
./tomcat-stop.sh
./stop.sh
./activemq-stop.sh

- 정상적으로 종료되었는지 프로세스를 확인한다.
ps -ef|grep tomcat
./ps-rpa.sh
ps -ef|grep activemq

업그레이드 하기

MariaDB, ActiveMQ, Tomcat을 포함하여 Brity RPA를 한 대의 서버에 단일 설치된 경우에는 모든 작업이 한대의 서버에서 이루어집니다.
어플리케이션 서버가 이중화 되어 있다면 두개의 서버(AP1/AP2) 모두 업그레이드 해주어야 합니다.
MariaDB 가 다른 서버에 설치되어 있다면 MariaDB 설치 서버에서 DB 스키마 업그레이드 진행 해야 합니다.
  1. 다음과 같이 업그레이드 프로그램을 실행하세요.

cd /rpa/install
./rpa-custom-install.sh
  1. 첫화면에 등장하는 최종사용자 라이선스 동의(EULA)에서는 Y를 선택해야 설치를 진행할 수 있습니다.

  1. Mariadb 데이터베이스 1 을 선택하여 진행 합니다.

  1. 3) Update Brity RPA v3.0.0_hotfix 를 선택합니다.

  1. 1) Update Brity RPA server( v2.0.1 to v3.0.0_hotfix ) 를 선택합니다.

  1. 1) Update the RPA Service application. 를 선택합니다.

  1. 서버 환경에 맞도록 설정을 변경합니다. 설치 진행은 Y, 설정변경은 C, 홈으로 이동은 H, 종료는 E 를 입력합니다.

Redundant server 는 이중화 서버를 여부를 나타냅니다. N 또는 Y 입력

Redundant server type 은 AP1/AP2 여부를 나타냅니다. 1 또는 2 입력

  1. 설치진행 Y 를 입력하면 다음과 같이 설치 진행 되고 RPA 서비스의 메모리를 설정 할 수 있고 Update the RPA Service application. 이 종료됩니다.

  1. 이전에 수행한 1,2,3,4,5 번 절자를 다시 수행힙니다.

1. rpa-custom-install.sh 업그레이드 프로그램을 실행

2. 라이선스 동의(EULA)에서는 Y를 선택

3. Mariadb 데이터베이스 1 을 선택

4. 3) Update Brity RPA v3.0.0_hotfix 를 선택

5. 1) Update Brity RPA server( v2.0.1 to v3.0.0_hotfix ) 를 선택

  1. 2) Update the RPA web application. 를 선택합니다.

  1. 이전과 동일하게 설정을 유지합니다. 설치 진행은 Y, 설정변경은 C, 홈으로 이동은 H, 종료는 E 를 입력합니다.

  1. 설치진행 Y 를 입력하면 다음과 같이 web application 설치가 완료됩니다.

  1. DB 스키마 설치는 DBMS 가 설치된 서버에서 수행되어야 합니다. 이전에 수행한 1,2,3,4,5 번 절자를 다시 수행힙니다.

1. rpa-custom-install.sh 업그레이드 프로그램을 실행

2. 라이선스 동의(EULA)에서는 Y를 선택

3. Mariadb 데이터베이스 1 을 선택

4. 3) Update Brity RPA v3.0.0_hotfix 를 선택

5. 1) Update Brity RPA server( v2.0.1 to v3.0.0_hotfix ) 를 선택

  1. 23) Update the RPA DB schema. 를 선택합니다.

  1. 서버 환경에 맞도록 설정을 변경합니다. 설치 진행은 Y, 설정변경은 C, 홈으로 이동은 H, 종료는 E 를 입력합니다.

설치 경로에 주의 합니다. MariaDB 의 bin 폴더 입니다.

  1. 설치 진행 Y 를 입력하면 설치에 필요한 캐시 용량을 입력 받습니다. 14000 으로 설정 후 엔터를 입력 합니다.

  1. DB 스키나 설치가 완료되고 모든 업그레이드 완료 되었습니다.

  1. 백업된 설정파일을 업그레이드 된 패키지 내부의 설정파일을 확인 합니다.

/rpa/apps/gateway/application.properties, /rpa/apps/comm/application.properties,

/rpa/apps/textrecognitionServer/application.properties 파일명이 _application.properties 로 변경된 경우 다음과 같이 변경합니다.

mv _application.properties application.properties

  1. ActiveMQ, RPA 서비스, Tomcat 을 재기동하여 서버의 정상 동작을 확인힙니다.