RPA 서비스 시작/중단

RPA 서비스 시작

RPA 서비스가 ipaadm, Tomcat이 ipaadm, MariaDB가 ipadb로 설치되고, 설치 폴더는 /rpa인 경우로 가정하여 설명합니다. 기동 순서를 반드시 지켜서 서비스를 시작해야 합니다.


Brity RPA v3.0.0 을 기동하려면 다음의 절차를 따르세요.

기동순서는 MariaDB → ActiveMQ → RPA Services → Tomcat 순으로 진행하며, 기동순서를 반드시 지켜서 진행하세요.


만약 최초 전체 설치 이후에 처음 기동하는 것이라면, 설치단계에서 이미 MariaDB는 기동되어 있습니다. (ps 명령어로 확인 권장)
최초 전체 설치가 아닌 운영상의 기동 절차는 아래를 따라 진행하세요.

가장 먼저 ipadb 계정으로 아래와 같이 MariaDB를 기동하세요.

(만약 ipaadm 계정으로 MariaDB가 설치된 환경이라면 su를 ipaadm 계정으로 진행하세요)

su ipadb
cd /rpa/bin
./mysql-start.sh

완료가 되더라도 프롬프트가 자동으로 떨어지지 않으니, 엔터를 한번 치고 나가서 아래와 같이 프로세스를 확인하세요.

MariaDB가 정상적으로 떴는지 프로세스를 확인하세요.

ps -ef|grep mariadb

ipaadm 계정으로 아래와 같이 ActiveMQ를 기동하세요.

su ipaadm
cd /rpa/bin
./activemq-run.sh

ActiveMQ가 정상적으로 떴는지 프로세스를 확인하세요.

ps -ef|grep activemq

ipaadm 계정으로 이어서 아래와 같이 RPA 서비스들을 기동하세요.

RPA 서비스에 대한 기동 쉘스크립트는 아래와 같이 2개가 있습니다.

N/A
- run.sh : 전체서비스를 모두 기동할 것인지 prompt를 통하여 Y/N 선택으로 제공합니다.
  - RPA 서비스들 중, 특정 서비스 하나만 argument로 지정해서 기동하는 것이 가능합니다.
  - 예시) ./run.sh core

N/A
- run-y.sh : prompt로 확인하는 과정없이 실행 즉시 전체 서비스를 모두 순차적으로 기동시킵니다.

cd /rpa/bin
./run.sh
또는 ./run-y.sh

모든 RPA 서비스들이 기동되고 나면 콘솔화면의 마지막줄에 5개 이상의 Spring Boot 로고가 보여지며 됩니다. 서비스들의 기동완료되는 시점들이 달라서 최종으로 보여지는 로고의 갯수에는 차이가 있을 수 있으나, 모든 서비스가 기동되고 나면 화면이 정지상태로 유지됩니다. 기동이 완료된 후에 프롬프트가 자동으로 뜨지 않기 때문에 Enter키를 한번 눌러줍니다.

RPA 서비스들이 모두 정상적으로 떴는지 프로세스를 확인하세요.

cd /rpa/bin
./ps-rpa.sh

아래와 같이 전체 9개의 RPA 서비스들이 프로세스로 떠있으면 정상 기동완료된 것입니다.

RPA 서비스들 중, 특정 서비스의 server.log 로그파일을 tail로 확인하고 싶은 경우에는 log.sh 쉘스크립트를 활용할 수 있습니다.

각 서비스들을 정의하는 argument는 아래와 같습니다.

N/A
- auth : auth 인증 서비스
- core : core 서비스
- comm : communication 서비스
- gateway : API gateway 서비스
- scheduler : scheduler 서비스
- tenant : tenant 서비스
- textrecognitionServer : OCR 서비스
- workflow : workflow 서비스
- batch : batch 서비스

cd /rpa/bin
./log.sh core

마지막으로, ipaadm 계정으로 이어서 아래와 같이 Tomcat을 기동하세요.

cd /rpa/bin
./tomcat-run.sh

"Tomcat started." 라고 문구가 표시되면 Tomcat이 실행된 것입니다. 아래와 같이 프로세스를 확인하세요.

ps -ef|grep tomcat

Tomcat이 내부적으로 정상적으로 에러없이 구동되고 있는지에 대한 로그 tail 확인은 아래와 같이 진행하세요.

cd /rpa/logs/admin
tail -f catalina.out

아래 포털에 정상적으로 접속되는지 확인하세요. (Chrome 또는 Edge 브라우저 이용. IE 사용금지)
- Admin Portal: https://접속IP:8080/admin
- User Portal: https://접속IP:8080/user
- Tenant Portal: https://접속IP:8080/tenant

FindID

RPA 서비스 중단

RPA 서비스가 ipaadm, Tomcat이 ipaadm, MariaDB가 ipadb로 설치되고, 설치 폴더는 /rpa인 경우로 가정하여 설명합니다. 


중단순서는 기동의 역순으로 진행합니다. 
Tomcat → RPA 서비스 → ActiveMQ → MariaDB 순으로 진행하며, 기동순서를 반드시 지켜서 진행하세요.

가장 먼저 ipaadm 계정으로 아래와 같이 Tomcat을 중단하세요.

su ipaadm
cd /rpa/bin
./tomcat-stop.sh

Tomcat이 정상적으로 중단되었는지 프로세스를 확인하세요.

ps -ef|grep tomcat

ps 명령어 결과에 grep 수행한 내용 이외에 아무것도 나타나지 않으면 정상 종료된 것입니다.

ipaadm 계정으로 이어서 아래와 같이 전체 RPA 서비스를 중단하세요.

su ipaadm
cd /rpa/bin
./stop.sh

참고로, stop.sh 쉘스크립트도 원하는 특정 RPA 서비스 하나를 argument로 지정하여 해당 서비스만 중단시키는 것이 가능합니다. (예. ./stop.sh comm)

RPA 서비스들이 정상적으로 전체 중단되었는지 프로세스를 확인하세요.

cd /rpa/bin
./ps-rpa.sh

ps-rpa.sh 실행 결과에 아무것도 나타나지 않으면 정상적으로 모든 RPA 서비스들이 중단된 것입니다.

ipaadm 계정으로 이어서 아래와 같이 ActiveMQ 를 중단하세요.

cd /rpa/bin
./activemq-stop.sh

".. TERMINATED" 라는 화면 표시를 확인한 후, ActiveMQ가 정상적으로 중단되었는지 프로세스를 확인하세요.

ps -ef|grep activemq

ps 명령어 결과에 grep 수행한 내용 이외에 아무것도 나타나지 않으면 정상 종료된 것입니다.

마지막으로 ipadb 계정으로 아래와 같이 MariaDB를 중단하세요.

(만약 ipaadm 계정으로 MariaDB가 설치된 환경이라면 su를 ipaadm 계정으로 진행하세요)

su ipadb
cd /rpa/bin
./mysql-stop.sh

MariaDB가 정상적으로 중단되었는지 프로세스를 확인하세요.

ps -ef|grep mariadb

ps 명령어 결과에 grep 수행한 내용 이외에 아무것도 나타나지 않으면 정상 종료된 것입니다.

라이선스 활성화

Tenant Portal 접속

라이선스를 등록하기 위해 Tenant Portal (https://서버아이피:8080/tenant)에 로그인하세요. 최초 설치 시 admin / superadmin!23으로 로그인할 수 있습니다.

페이지 하단  클릭하면 사용자 정보창이 표시됩니다.

About을 클릭해 "About" 팝업창에서 서버 프로세스 상태를 확인하세요. 버전이 모두 보인다면 서버 프로세스가 동작하고 있다는 것을 의미합니다.
Batch 서비스의 경우, About과 서버모니터링 항목에 표시되기까지 서버가 최초기동하고나서 수십분 소요될 수 있으니 1시간 후에 확인해보실 것을 권고합니다.

서버 상태 확인

라이선스 활성화

라이선스 > 테넌트 라이선스 관리를 클릭하세요.

"테넌트 라이선스 관리" 페이지에서 라이선스 적용을 클릭하세요.

테넌트 라이선스 관리

"라이선스 적용" 팝업창에서 라이선스 파일을 업로드하여 라이선스를 등록하세요.

라이선스 적용 팝업

미적용을 클릭하여 적용 상태로 변경하세요. 라이선스 등록에 성공하면 봇과 디자이너의 라이선스 키가 생성됩니다.

발급된 라이선스의 서버 MAC 주소가 올바르지 않은 경우 적용으로 변경되지 않습니다. 이 경우 발급된 라이선스와 실제 장비의 MAC 주소를 확인하고, 라이선스를 재발급받아야 합니다.

확인을 눌러 라이선스 적용을 완료하세요.

라이선스 등록에 성공하면 봇과 디자이너의 라이선스 키가 생성됩니다.

BASE TENANT 카드의 클릭하여 테넌트 라이선스 설정 페이지로 이동하세요.

테넌트 라이선스 관리

BASE TENANT에 설정할 라이선스를 선택하여 추가하세요.

라이선스 테넌트라이선스관리 테넌트라이선스설정

Admin Portal (https://접속IP:8080/admin)에 로그인하세요.
- ID: admin
- PW: superadmin!23
메뉴 > System > 그룹 권한 관리로 이동하세요.
사용자 그룹의 관리자 그룹 컬럼을 클릭하여 'Y'로 변경하세요.

그룹별 추가 설정에 관한 사항은 관리자 매뉴얼을 참고하세요.

메뉴 > System > 라이선스 관리로 이동하세요. 테넌트 포털에서 할당된 라이선스가 표시됩니다.

라이선스 관리 현황

봇용 Windows PC에 봇을 설치한 후 서버 IP와 라이선스 키를 입력하여 활성화하세요.
디자이너용 Windows PC에 디자이너를 설치한 후 서버 IP와 라이선스 키를 입력하여 활성화하세요.

프로세스 생성 및 실행에 관한 자세한 내용은 사용자 매뉴얼을 참고하세요.

SMTP 설정

사용자 가입, 패스워드 찾기 시 메일을 사용하도록 설정할 수 있습니다.

SMTP 서버가 준비되어 있어야 하며, RPA 서버와 SMTP 서버 간 25번 포트가 열려 있어야 합니다.

SMTP를 설정하려면 다음의 절차를 따르세요.

테넌트 포털의 System > 설정 관리를 클릭하세요.

"설정 관리" 의 왼쪽 메뉴 중, 이메일 항목을 클릭하세요.

SMTP 설정과 관련한 각 항목들에 적절한 설정값들을 입력하고 저장을 클릭하세요.

"설정 관리" 페이지에서 리스트 오른쪽 상단의 메일 연계 테스트를 클릭하세요.
"메일 연계 테스트" 팝업창에서 테스트할 발신자 이메일, 비밀번호, 수신자 이메일을 입력한 후 실행을 클릭하세요.

번호	설명
1	사용할 메일 계정을 입력합니다.
2	사용할 메일 계정의 비밀번호를 입력합니다.
3	테스트용 메일을 받을 메일 계정을 입력합니다.

테스트에 성공하면 확인을 클릭해 변경할 값들을 저장하세요. 만약, 실패한 경우에는 실패한 메시지에 따라 설정값을 조정하세요.