업데이트 관리자로 설치하기

업데이트 관리자로 업데이트 하기

오케스트레이터 서버 기반 업데이트를 제공합니다. 
업데이트 관리자를 통하여 서버에 배포된 Pre-Built 템플릿, 커스텀 라이브러리 등 라이브러리/DLL을 업데이트 할 수 있습니다.
또한, 설치된 클라이언트 자체를, 서버에 준비된 더욱 최신 버전으로 전체 업데이트 설치할 수도 있습니다.
업데이트 관리자는 디자이너 혹은 봇에서 실행할 수 있으며, 사용자가 각 프로그램을 업데이트할 수 있도록 돕습니다.
  1. 디자이너 로그인 후, 메뉴>도움말>업데이트 관리자 를 클릭하세요.

디자이너_샘플경로

또는, 봇에서 업데이트 관리자를 실행하기 위해서는, 정보 아이콘 > 업데이트 관리자 를 클릭하세요. Attended Bot 으로 설치된 봇에서는 해당 기능을 이용할 수 없습니다. 만약 서버에 연결됨 상태인 경우, 연결을 해제하도록 사용자 메시지 창이 나타납니다.

  1. 업데이트 관리자 팝업에서 '설치 가능' 탭을 눌러, 서버에 배포된 패키지 목록을 확인하세요.

50페이지

화면 상단에는 현재 설치된 클라이언트의 버전 정보가 표시됩니다. 만약, 더 최신 버전의 클라이언트 설치 패키지가 서버에 준비되어 있다면, 해당 클라이언트의 설치를 시작할 수 있는 버튼이 나타납니다.

하단에는 설치할 수 있는 패키지 목록을 보여주는 '설치 가능' 탭과 과거에 설치한 패키지들에 대한 정보를 보여주는 '설치 이력' 탭이 존재합니다. '설치 가능' 탭에는 사용자가 설치할 수 있는 패키지의 개수가 배지 숫자를 통해 표시됩니다.

'클라이언트 설치' 패키지는 하단에 표시되는 일반 패키지 목록에서는 확인할 수 없습니다. 또한, '클라이언트 설치' 패키지는 일반 패키지와 동시에 설치할 수 없는 독립적으로 설치가 진행되어야 하는 패키지 입니다. '설치 이력' 탭에서 관리되는 이력은 일반 패키지를 대상으로 합니다.

  1. 행을 클릭하면 업데이트 패키지에 포함된 파일들의 상세 정보가 행 아래쪽에 표시됩니다.

  2. 미설치된 패키지 목록의 맨 앞에는 체크박스가 표시되고, 체크박스를 체크하세요. 하단의 설치하기 버튼이 활성화되는지를 확인하세요.

  3. 설치하기 버튼을 클릭하세요. 아래와 같은 확인 메시지가 표시됩니다.

'클라이언트 설치' 패키지의 설치를 진행하는 경우, 해당 작업을 취소할 수 없다는 사용자 경고도 나타납니다.

  1. 확인 버튼을 클릭하세요. 다음 그림의 예시처럼 다운로드가 시작되고, 진행 상황이 표시됩니다.

50페이지

  1. 다운로드가 완료되면 디자이너가 종료되고 업데이트를 시작합니다.

50페이지

  1. 업데이트가 끝나면 디자이너가 재시작됩니다.

업데이트 패키지 파일 생성하기

일반 업데이트 패키지 파일 생성하기

오케스트레이터 서버에  배포할 업데이트 패키지 파일을 생성할 수 있습니다.

1. 디자이너가 설치된 경로에서, BrityRPA_UpdatePackageGenerator.exe 파일을 관리자 권한으로 실행하세요.

2. 필수 입력 값인 패키지 명, 타입, 버전, 적용대상, 설치할 파일 들을 지정하세요. 필수 입력 값 중 누락된 항목이 존재하면, '생성하기' 버튼은 활성화되지 않습니다.

업관5

3. [Bot/Designer 설치 폴더] 항목의 마우스 우클릭메뉴에서 새 폴더 를 선택하여 하위에 폴더 구조를 만들 수 있습니다.

업관6

4. 마우스 우클릭메뉴에서 파일 추가를 선택하면 패키지에 포함시킬 파일을 추가할 수 있습니다. 폴더 하위 파일 추가를 선택하여, 특정 폴더 아래의 전체 파일 및 폴더들을 한 번에 추가할 수도 있습니다.

업관7

5. 파일 추가가 완료되면 신규 저장 버튼을 선택하여 패키지 파일명을 지정하고 저장하세요.

업관8

6. 패키지가 성공적으로 생성되면, 신규 저장 버튼은 기존 저장 버튼으로 변경됩니다. 기존 저장를 통해 현재 수정 중인 내용을 패키지 파일에 반영할 수 있습니다. 필요한 경우 신규 저장 버튼으로 변경하여 새로운 패키지 파일을 만들 수도 있습니다.

초기화 버튼을 클릭하시면 패키지 생성 입력값을 모두 초기화 할 수 있습니다. 현재 편집 중인 내용이 모두 사라지므로 주의하여 주세요.

업관9

7. 불러오기 버튼을 클릭하시면, 이전에 생성했던 패키지 파일의 내용을 가져올 수 있습니다. 현재 편집 중인 내용이 모두 사라지므로 주의하여 주세요. 불러오기가 완료되면, 패키지 생성 버튼은 항상 기존 저장 으로 자동 변경됩니다.

업관9

8. 생성한 업데이트 패키지를 서버에 배포하여 업데이트 관리자에서 사용할 수 있도록 합니다.

패키지 파일 배포 방법은 클라이언트 설치 관리하기 를 참고하세요.

'클라이언트 설치' 타입의 업데이트 패키지를 생성하기 위해서는,

BrityRPA_Designer_Installer_v2.5.500.00907.exe 등의 클라이언트 인스톨 exe 파일을 '설치할 파일' 로 추가해야 합니다.

인스톨 exe 파일 명을 다음과 같은 규칙으로 지정해야 합니다.

. BrityRPA_Designer_Installer_v버전.exe

. BrityRPA_BOT_Installer_v버전.exe

실행 엔진 패키지 파일 생성하기

실시간 봇엔진 업데이트 기능에서 활용할 '실행 엔진' 형식의 업데이트 패키지를 생성하는 방법을 설명합니다. '실행 엔진' 업데이트 패키지는 Bot 에서만 사용될 수 있는 패키지 입니다. 실시간 봇엔진 업데이트 기능에 사용되는 '실행 엔진' 패키지의 버전은 v2.1.1 이상이어야 합니다.

'실행 엔진' 형식의 업데이트 패키지는 반드시 검증이 완료된 정상적인 봇 설치 파일을 가지고 생성되어야 합니다. 또한, '실행 엔진' 패키지는 서버에 배포되어 실시간 봇엔진 업데이트에 활용되기 시작하면, 다수 봇의 실행에 직접적인 영향을 끼치므로, 적합한 권한을 가진 관리자가 신중히 생성해야 합니다.

보안 데이터 암복호화 신규 알고리즘이 적용된 서버에 연결되어 운영되는 봇에서 실시간 봇엔진 업데이트 기능이 정상적으로 동작하기 위해서는, 2023년 6월 이후 핫픽스가 적용된 배포 본을 가지고 '실행 엔진' 패키지를 생성해야만 합니다.


예를 들어, v3.1 버전의 서버에 연결된 봇에서 v2.1.200.00629 버전의 '실행 엔진' 패키지를 사용하면, 보안 데이터를 사용하는 시나리오가 정상적으로 수행되지 않을 수 있습니다. 이 경우, v2.1.201.xxxxx 등과 같은 핫픽스를 통해 생성된 '실행 엔진' 패키지가 사용되어야 합니다.

  1. 기존 설치된 봇이 존재하면 먼저 봇을 제거한 후 다음 단계들을 진행하십시오.

  1. 이후 검증이 완료된 정상적인 봇을 PC 에 새로 설치합니다. 이때, 32비트 또는 64비트로 설치한 내용을 기억하십시오. 봇 설치가 완료된 후, 봇을 실행하지는 마십시오.

  1. 필요한 경우, 해당 봇 실행 엔진에 포함시킬 AddIn 도 인스톨러를 통해 설치하십시오. BrityRPA_AddIn_Installer_v0.0.000.00000.exe 과 같은 형식의 파일입니다. 이 인스톨러 파일도 봇 설치 파일과 마찬가지로 검증이 완료되어 정식 배포된 정상적인 설치 파일이어야 합니다.

  1. 3.1.0 버전 대의 디자이너가 설치된 경로에서, 업데이트 패키지 생성 프로그램 을 실행하고, 타입실행 엔진 으로 변경합니다. BrityRPA_UpdatePackageGenerator.exe 파일 입니다. 봇이 설치된 경로의 BrityRPA_UpdatePackageGenerator.exe 파일을 실행하지 마십시오.

  1. 설치할 파일 영역의 최초 노드에서 마우스 오른쪽 클릭으로 팝업 메뉴를 열고, 폴더 하위 파일 추가 버튼을 누릅니다.

  1. 2단계에서 PC 에 새로 깨끗이 설치한 봇의 설치 경로를 지정하고, 모든 파일들이 설치할 파일 영역에 추가될 때까지 기다립니다.

  1. 프로토콜 버전 에는 1.0 을 입력합니다. 일반적으로 이 값은 고정입니다.

  1. 실행 가능 버전 에는 이 실행 엔진 패키지로 실행할 프로세스 혹은 프로젝트들의 디자이너 버전 범위를 입력합니다. 실시간 봇엔진 업데이트 기능이 동작할 때, 이 실행 엔진 패키지는 해당 버전 범위에 속하는 디자이너에서 작성된 프로젝트들을 실행하는 데 활용되게 됩니다. 만약, 이 버전 범위를 벗어난 디자이너에서 생성된 프로젝트 등은 이 실행 엔진 패키지에서 실행 할 수 없습니다.

버전은 반드시 다음과 같은 형식을 따라야 합니다.


Major.minor.build.date


각 버전 부분은 다음과 같은 크기를 가져야 합니다.

- Major: 1 자리 정수

- minor: 1 자리 정수

- build: 3 자리 정수

- date: 5 자리 정수

예를 들어, 다음과 같은 버전 범위는 2.0.000.00101 디자이너에서 생성된 프로젝트나,  2.5.000.00202~2.6.000.00303 사이 버전의 디자이너에서 생성된 프로젝트를 나타냅니다.

  . 2.0.000.00101, 2.5.000.00202~2.6.000.00303

  1. 버전 에는 1 단계에서 설치한 봇 폴더에서 BrityRPA_BOT.exe 파일의 제품 버전을 입력합니다. 파일 탐색기에서 해당 파일의 속성 정보를 확인하면, 이 값을 알 수 있습니다.

  1. 패키지 명 에 적절한 실행 엔진 패키지의 이름을 입력합니다. 앞서 32비트 혹은 64비트로 설치한 내용과 봇 실행 파일의 버전등도 포함하면 관리에 용이합니다.

권장하는 실행 엔진 패키지의 이름 예시는 다음과 같습니다. 버전 부분은 실제 실행 엔진 패키지의 버전을 입력하십시오.

. BrityRPA_BOT_Engine_x32_v3.0.600.00607

  1. 신규 저장 버튼을 눌러, '실행 엔진' 패키지 생성을 완료합니다.

  1. 1단계로 돌아가서 64비트 용 실행 엔진을 생성하십시오. 적절한 실행 엔진 패키지의 배포 및 관리를 위해서는 32비트 및 64비트 용 실행 엔진 패키지가 각각 필요합니다. 64비트용 실행 엔진을 생성할 때는 앞 단계들에서 32비트 용으로 패키지 생성 시 입력했던 부분들은 64비트로 변경 입력하십시오.