J-Jobs

Guides -J-Jobs Orchestrator v2.4 설치 가이드

J-Jobs Orchestrator 설치 가이드

최종 작성일: 2019년 7월 19일

기준 버전 : J-Jobs v2.4

Copyright ⓒ LG CNS LG CNS의 사전 승인 없이 본 내용의 전부 또는 일부에 대한 복사, 배포 사용을 금합니다.

시스템 요구사항

Overview

J-Jobs의 구성요소로는 크게 3가지가 있다. 여러가지 이유로 3-Tier 구조로 분산되어 각자의 역할을 수행하며 모든 구성요소가 있어야 정상적으로 J-Jobs가 작동된다. 구성요소별 자세한 역할은 운영자 가이드 를 참조한다.

하드웨어

J-Jobs Orchestrator 버전은 J-Job 매니저 및 서버가 설치될 관리서버와 배치 프로그램 등의 어플리케이션이 실행될 J-Job 에이전트 서버로 구성된다.

관리서버는 J-Job의 메타 데이터를 관리할 DBMS 와 J-Jobs 매니저 및 서버 어플리케이션 동작을 위해 WAS가 설치되고 이러한 어플리케이션이 동작하기 위해서는 다음과 같은 사양을 권장한다.

  • OS : linux 64 bit, Windows 64 bit

  • CPU : 4 core 이상

  • MEMORY : 4 GB 이상

  • DISK : 10 GB 이상

J-Job 에이전트가 설치될 서버는 실제 배치 등의 어플리케이션이 실행되는 영역이므로 어플리케이션의 부하량에 따라 하드웨어 사양이 결정된다. 해당 가이드에서는 J-Job 에이전트 실행만을 고려한 최소 사양을 기술한다.

  • OS : linux(32,64), Windows(32,64), AIX, HP-UX

  • CPU : 1 core 이상

  • MEMORY : 512 MB 이상

  • DISK : 500 MB 이상

소프트웨어

J-Jobs Orchestrator 버전 설치파일은 linux용과 Windows용이 제공된다.

  • Windows용 jjobs_windows_installer_x64_2.3.x.exe 약 280M bytes

  • linux 용 jjobs_linux_installer_x64_2.3.x.tar.gz 약 290M bytes

J-Jobs 실행시 필요한 설치파일에 포함된 전용 소프트웨어는 다음과 같다.

  • META DBMS - PostgreSQL 10.3

  • JVM - Open JDK 1.8

  • WAS - Tomcat 8

호환성

  • OS 호환성

    J-Jobs는 Java로 작성되어 Java가 지원되는 플랫폼인 경우 제한 없이 사용이 가능하다.

    현재 호환성 테스트된 OS 는 다음과 같다.

    • linux계열 (Redhad계열, Ubuntu 계열, Debian 계열)에서 테스트 완료 되었음

    • Windows7이상에서 테스트 완료 되었음 (Powershell 2.0 이상)

    • unix계열 (AIX, HP-UX)에서 테스트 완료 되었음

  • JVM 호환성

    • Java 1.7, Java 1.8에서 테스트 완료 되었음

    • Oracle JDK, Open JDK 호환성 테스트 완료 되었음

    • unix(AIX, HP-UX)의 경우 벤더에서 제공하는 Java를 사용하여 테스트 완료 되었음

지원 브라우저

J-Job 매니저의 웹화면은 AngularJS와 HTML5 기술로 구성되어 있다. 따라서 해당 기술로 구성된 웹페이지를 표시할 수 있는 브라우저라면 사용이 가능하며, 권장 브라우저는 Chrome이다.

Chorme latest, Firefox latest, IE11+, Edge latest, Opera latest, Safari latest

J-Jobs 설치

설치 준비

  • J-Job 매니저 및 서버가 설치될 서버가 위에 언급된 관리서버 하드웨어 사양으로 준비되어 있어야 함

  • soltech 사이트(https://soltech.lgcns.com/jjobs/downloads)에서 J-Jobs Orchestrator 버전을 설치될 OS환경에 맞는 설치파일을 다운로드 받는다.

  • J-Job 에이전트가 설치될, 즉 배치업무가 수행될 서버가 unix계열인 경우 linux용을 받아서 사용하면 된다.

  • 아래 라이선스 발급 항목에 기술된 내용으로 발급된 license 파일이 준비되어 있어야 한다.

  • 설치 환경이 Windows인 경우 J-Jobs 메타 DBMS 설치를 위해서 먼저 Visual C++ 패키지 설치가 선행되어야 한다. 아래 troubleshooting 참조

  • 설치 환경이 linux인 경우 unzip 유틸리티가 사전에 설치되어 있어야 한다.

  • J-Jobs 설치 환경이 linux이면서 J-Jobs 메타 DBMS로 PosgtreSQL 설치를 위해서 반드시 일반 계정(PostgreSQL 보안상 root로 설치가 안됨)으로 설치가 되야 한다. 따라서 J-Jobs가 설치될 일반 계정을 준비한다.

설치

설치는 Windows 버전과 linux버전으로 나눠서 설명한다.

Windows 버전 설치

다운로드 받은 jjobs_windows_installer_x64_v2.x.x.zip (soltech 보안 정책상 zip파일만 업로드 가능)압축을 풀고 jjobs_windows_installer_x64_v2.x.x.exe을 실행한다.

Step 1 - 설치옵션 선택

  • Full : 한 서버에 J-Job 매니저, 서버 및 에이전트를 모두 설치한다.
  • Only Manager : J-Job 매니저만 설치한다. 이런 경우 Step 5의 J-Job 서버 설정과 Step 6의 J-Job 에이전트 설정을 넘어간다.
  • Only Server : J-Job 서버만 설치한다. 이런 경우 Step 4의 J-Job 매니저 설정, Step 6의 J-Job 에이전트 설정은 넘어간다.
  • Only Agent : J-Job 에이전트만 설치한다. 이런 경우 Step 3 ~ 5 까지의 설정은 넘어간다.

Step 2 - Java 설정

  • Use Dadicated Java : 설치파일에 포함된 J-Jobs 전용 Java를 설치한다. (제공되는 Java는 Open JDK 1.8)

  • Browse : 이미 Java가 설치된 경우에 기 설치된 JAVA HOME경로를 선택한다. 단, Java 버전은 1.7 이상이어야 한다.

Step 3 - J-Jobs 메타 DBMS 설정

항목설명기본값
DBMS 유형J-Jobs Meta DBMS를 포함해서 설치할 경우 서버의 IP를 입력, J-Jobs Meta DBMS를 포함해서 설치하지 않을 경우(J-Job 서버 이중화등) 이미 설치된 J-Jobs Meta DBMS의 IP나 Domain Name을 입력PostgreSQL
JDBC URLJ-Jobs Meta DBMS로 접속 가능한 JDBC URL 입력7432
User IDDB 접속계정jjobs
PasswordDB 접속계정의 비밀번호jjobs1234

Step 4 - J-Job 매니저 설정

항목설명기본값
Root PasswordJ-Job 매니저의 root로 로그인 시 비밀번호 설정
Password Confirmroot 비밀번호 입력 확인
WAS 유형 선택J-Job 매니저가 구동될 수 있는 WAS(기설치 필요)의 제품 유형 선택 (LENA, Tomcat, Jeus, JBoss, WebLogic, WebSphere 중 택일)
Web Service PortDB 접속계정의 비밀번호jjobs1234
  • Use Dedicated Manager WAS : 체크할 경우, Apache Tomcat(v8)이 설치되며 J-Job 매니저가 Tomcat으로 구동된다.

Step 5 - J-Job 서버 설정

항목설명기본값
API Service PortJ-Job 서버의 서비스 포트 설정(http 웹포트)7075
Server Group / IDJ-Job 서버가 속할 서버 그룹 및 서버 ID 설정1 / 1
Server NameJ-Job 서버 명7065
  • Register the server to a windows service : 해당 체크박스에 체크시 J-Job 서버를 Windows 서비스에 등록하여 사용할 수 있다.

Step 6 - J-Job 에이전트 설정

항목설명기본값
Agent NameJ-Job 에이전트를 식별하기 위한 이름hostname
Server GroupJ-Job 에이전트가 접속하여 작업을 할당 받을 서버그룹 ID 입력1
Agent GroupJ-Job 에이전트가 접속하여 작업을 할당 받을 에이전트그룹 ID 입력0
Stratup URLJ-Job 에이전트가 실행시 초기에 필요한 기초 정보를 받아오기 위한 URL로 보통 J-Job 서버의 접속 URL 입력http://0.0.0.0:7065/jjob-server
  • Register the J-Job agent as as windows service : 해당 체크박스에 체크시 J-Job 에이전트를 Windows 서비스에 등록하여 사용할 수 있다.

Step 7 - 라이선스 동의

  • EULA를 확인 후 동의하고 다음으로 진행한다.

Step 8 - 설치경로 지정

  • J-Jobs 가 설치될 경로를 선택한다.

Linux 버전 설치

다운로드 받은 jjobs_linux_installer_x64_v2.x.x.tar.zip (soltech 보안 정책상 zip파일만 업로드 가능) 압축을 풀고 jjobs_linux_installer_x64_v2.x.x.tar.gz를 적절한 위치에 놓는다.

tar 유틸리티를 이용하여 압축을 푼다

tar xvzf jjobs_linux_installer_x64_v2.3*.tar.gz

압축을 풀면 5개의 파일이 존재한다.

  • License.txt : EULA가 명시된 파일
  • jjob_installer_linux_64_2.x.x.sh : J-Jobs 통합 설치 파일
  • jjob_manager_installer.sh : J-Job 매니저를 단독으로 설치하기 위한 스크립트 파일
  • jjob_server_installer.sh : J-Job 서버를 단독으로 설치하기 위한 스크립트 파일
  • jjob_agent_installer.sh : J-Job 에이전트를 단독으로 설치하기 위한 스크립트 파일
  • jjob_DB_installer_linux_x64.sh : J-Job 전용 Meta DBMS 설치파일

통합 설치 파일을 이용하여 J-Job Manager, Server 및 Agent를 한번에 설치할 수 있다. (아래 실행 예시 참고)

# ./jjob_installer_linux_64_2.x.x.sh --base_path /engn001/jjobs --install_kind F --install_mode I --use_oracle --jdbc_url 'jdbc:oracle:thin:@xxx.xxx.xxx.xxx:yyyy:ABCD' --dbms_user db_user --dbms_pswd db_passwd --man_web_port 8080 --svr_service_web_port 8090 --svr_cotrol_base_port 19000 --agnt_name AGNT_01 --agnt_startup_svc_port    

인스톨러 실행 시 필요한 아규먼트는 아래와 같다.

  • --base_path : J-Job 가 설치될 기본 경로
  • --install_kind : 설치 유형 (F : 전체설치 | M : Manager 단독 설치 | S : Server 단독 설치 | A : Agent 단독 설치)
  • --install_mode : 설치 모드 (I : Install | P : Patch)
  • --use_trial_db | --use_internal_db | --use_oracle | --use_posgresql | --use_mariadb : J-Jobs의 Meta DB를 위한 아래 후보 중 선택
    • use_trial_db : 테스트 목적의 H2 경량 DB 사용
    • use_internal_db : J-Jobs 설치와 함께 PosgreSQL이 함께 설치되며, 이를 J-Jobs의 Meta DB로 사용
    • use_oracle : 기존의 oracle을 J-Jobs의 Meta DB로 사용
    • use_postgresql : 기존의 PostgreSQL을 J-Jobs의 Meta DB로 사용
    • use_mariadb : MariaDB를 J-Jobs의 Meta DB로 사용
  • --jdbc_url : 상위 Meta DB 선택 시, use_oracle, use_postgresql, use_mariadb 중 하나를 선택했을 경우 접속 JDBC URL 설정
  • --dbms_user : JDBC URL로 DB에 접속할 때 사용자명
  • --dbms_pswd : JDBC URL로 DB에 접속할 때 패스워드
  • --use_dedicated_man_was | --use_jeus | --use_lena | --use_weblogic | --use_tomcat | --use_websphere : J-Job Manager(Web Application)을 기동하기 위한 WAS 제품을 아래 중 선택
    • use_dedicated_man_was : Apache Tomcat v8을 이용하여 Manager 기동
    • use_jeus : 기 설치된 Jeus 사용
    • use_lena : 기 설치된 LENA 사용
    • use_weblogic : 기 설치된 WebLogic 사용
    • use_tomcat : 기 설치된 Tomcat 사용
    • use_websphere : 기 설치된 WebSphere 사용
  • --man_webapps_path : Manager(Web Application)가 설치될 곳의 경로
  • --man_web_port : Manager 웹 서비스 Port
  • --svr_service_web_port : Server(Web Application) 웹 서비스 Port
  • --svr_cotrol_base_port : Server와 Agent 간의 통신을 위한 TCP Port
  • --agnt_name : Agent 명
  • --agnt_svr_group : Agent가 연결할 서버 그룹 설정
  • --agnt_group : Agent Group 설정
  • --agnt_startup_svc_protocol : http
  • --agnt_startup_svc_context : Agent가 Server에 접근하기 위한 Server의 Context Path (보통 jjob-server)
  • --agnt_startup_svc_domain : Agent가 Server에 접근하기 위한 Server의 서비스 IP
  • --agnt_startup_svc_port : Agent가 Server에 접근하기 위한 Server의 서비스 Port

서버추가 설치

J-Job 매니저의 관리자 -> 시스템설정 -> 서버설정 화면에서 서버를 추가 등록한다.

(운영 가이드 서버 추가 항목 참조)

Windows 환경

  • 통합 설치와 동일하게 installer 실행파일을 실행 후 Only Server를 선택한다.

  • Java 설정 후 DBMS 설정은 기 설치된 DBMS의 IP와 Port를 기술하고, 새로 추가될 Server의 설정 정보를 입력 한 뒤 설치를 완료한다.

  • J-Job 매니저의 관리자->시스템설정->서버설정에 신규로 추가된 정보를 확인하여 설치시 Port, 서버그룹ID, 서버ID를 입력한다.

  • 이후 절차는 동일

Linux 환경

# ./jjob_installer_linux_64_2.x.x.sh --base_path /engn001/jjobs --install_kind S --install_mode I --use_oracle --jdbc_url 'jdbc:oracle:thin:@xxx.xxx.xxx.xxx:yyyy:ABCD' --dbms_user db_user --dbms_pswd db_passwd --svr_group 1 --svr_id 2 --api_port 19900 --svr_service_web_port 8091 --svr_cotrol_base_port 19900 

신규 설치와 절차는 동일하나 install_kindS로 하며, 추가적인 옵션을 입력한다.

  • --svr_group : J-Job 매니저의 관리자->시스템설정->서버설정에 신규로 추가된 정보를 확인하여 서버그룹ID를 입력한다.
  • --svr_id : J-Job 매니저의 관리자->시스템설정->서버설정에 신규로 추가된 정보를 확인하여 서버ID를 입력한다.
  • --api_port : default port(7065)에서 변경되었을 경우 사용한다.

에이전트 추가 설치

Windows 환경

통합 설치와 동일하게 installer 실행파일을 실행 후 Only Agent를 선택한다.

Java 경로를 입력하고, 설치하고자 하는 에이전트의 정보를 입력한 뒤 설치를 완료한다. J-Job 서버 설치와 달리, 새로 설치한 에이전트는 매니저를 통한 별도의 등록 절차 없이 기동할 수 있다.

Linux 환경

# ./jjob_installer_linux_64_2.x.x.sh --base_path /engn001/jjobs --install_kind A --install_mode I --use_oracle --jdbc_url 'jdbc:oracle:thin:@xxx.xxx.xxx.xxx:yyyy:ABCD' --dbms_user db_user --dbms_pswd db_passwd --agnt_name AGENT_02 --agnt_svr_group 1 --agnt_group 2 --agnt_startup_svc_protocol http --agnt_startup_svc_context jjob-server --agnt_startup_svc_domain xxx.xxx.xxx.xxx --agnt_startup_svc_port 8090 

신규 설치와 절차는 동일하나 install_kindA로 하며, 추가적인 옵션을 입력한다.

  • --agnt_name : Agent 명
  • --agnt_svr_group : Agent가 연결할 서버 그룹 설정
  • --agnt_group : Agent Group 설정
  • --agnt_startup_svc_protocol : http
  • --agnt_startup_svc_context : Agent가 Server에 접근하기 위한 Server의 Context Path (보통 jjob-server)
  • --agnt_startup_svc_domain : Agent가 Server에 접근하기 위한 Server의 서비스 IP
  • --agnt_startup_svc_port : Agent가 Server에 접근하기 위한 Server의 서비스 Port

J-Job 서버 설치와 달리, 새로 설치한 에이전트는 매니저를 통한 별도의 등록 절차 없이 기동이 가능하다.

설치 확인

디렉토리 구성

  • J-Job 서버
J-Job ┌ manager(J-Job Manager) ┌ bin
 							   ├ conf
 							   ├ lib
 							   ├ logs
 							   ├ temp
 							   ├ webapss ─ jjob-manager.war
 							   └ work
      ├ server(J-Job Server)   ┌ bin 
                               ├ conf
                               ├ lib
                               ├ work
                               ├ temp
                               ├ logs
                               ├ webapps ─ jjob-server.war
                               └ work
      ├ jdk8u212-b03(J-Job 전용 Java)
      ├ start_manager.sh (start_manager.bat)
      ├ stop_manager.sh (stop_manager.bat)
      ├ start_server.sh (start_server.bat)
      └ stop_server.sh (stop_server.bat)
  • J-Job 에이전트
J-Job ┌ agent(J-Job Agent)  ┌ app ┌ classes
                                  ├ lib
                                  ├ META-INF ┌ io
                                             ├ jsl
                                             └ services
                                  └ repo
                            ├ shl
                            ├ ctrl
                            ├ fd
                            ├ jjoblib
                            ├ sitelib
                            ├ logs
                            ├ patch
                            ├ temp
                            └ logs
      ├ jdk8u212-b03(J-Job 전용 Java)
      ├ start_agent.sh (start_agent.bat)
      └ stop_agent.sh (stop_agent.bat)

포트 정보

  • J-Job 매니저
내용방향비고
Manager(Web Application)를 위한 웹 서비스 PortIN-BOUND설치 시 --man_was_port를 통해 설정
  • J-Job 서버
내용방향비고
Server(Web Application)를 위한 웹 서비스 PortIN-BOUND설치 시 --svr_service_web_port를 통해 설정
에이전트와 통신을 위한 포트로 작업요청, 로그전송,에이전트제어 용도IN-BOUND설치 시 --svr_cotrol_base_port를 통해 설정,
지정한 포트로부터 +4 범위만큼의 포트가 필요하다.
(예시: 지정 포트가 19000일 경우, 19000 ~ 19004 포트 필요)

J-Job 매니저, 서버 설치시 웹 서비스 포트번호는 반드시 설치되는 서버에서 다른 프로그램이 사용중인 다른 포트와 충돌을 피해서 설정하여야 한다.

  • J-Job 에이전트

별도의 IN-BOUND 포트 지정이 필요하지 않으며, J-Job 서버로의 단방향 통신(Server의 웹 서비스 포트, 컨트롤 포트)만 가능하면 된다.

라이선스 발급

J-Job 서버가 설치될 서버의 host명을 확인하여 확인한 host명과 관리할 작업(Job)의 수 혹은 사용 에이전트 개수를 바탕으로 선청서를 작성하여 j-jobs@lgcns.com 으로 신청한다. (향후 발급센터로 이전 예정)

J-Jobs Orchestrator License 신청서

1. 신청자 e-mail : hongildong@lgcns.com

2. 신청자 성명 : 홍길동

3. J-Jobs 서버가 설치될 서버의 호스트명 : batchap01, batchap02  (최대 2개) 

4. J-Jobs 서버가 설치될 Platform 정보 : linux (CentOS 6) 64 bit
   
5. 최대 작업 (배치프로그램) 수 : 150개

6. 에이전트 개수 : 10대

신청하여 발급받은 라이센스를 매니저를 통해 등록(운영자 가이드 참고) 할 수 있다. J-Jobs는 제품에 따라 라이센스도 다르기 때문에 반드시 Orchestrator용 라이센스를 발급 받아야 한다.

J-Jobs 시작/중지

시작

J-Jobs 설치 시, --use_internal_db 옵션으로 PosgreSQL을 함께 설치한 경우 먼저 메타 DBMS(PosgreSQL) 시작한 다음, J-Job 매니저 -> J-Job 서버 -> J-Job 에이전트 순으로 시작한다. 각 단계가 정상적으로 시작된 후 다음 단계를 진행한다.

J-Jobs 메타 DBMS 시작

  • 설치된 위치에서 start_db.sh 또는 start_db.bat을 실행한다.

J-Jobs 매니저 시작

  • 설치된 위치에서 start_manager.sh 또는 start_server.bat를 실행한다.
    • 초기 설치 후 J-Job 매니저를 최초로 시작하면 콘솔 로그에 오류가 발생하는 것을 확인할 수 있다. 이유는 메타 테이블이 아직 생성 전이고 초기 데이터가 없기 때문이다. 이는 아래 기술된 메타 테이블 설치 및 초기화 마법사를 통해 추가 설치를 진행한다.

J-Job 서버 시작

  • 설치된 위치에서 start_server.sh 또는 start_server.bat을 실행한다.

J-Job 에이전트 시작

  • 설치된 위치에서 start_agent.sh 또는 start_agent.bat을 실행한다.
  • 서버가 정상적으로 구동되지 않거나 메타 테이블 설치초기화 마법사 실행 전이면 J-Job 에이전트가 시작하지 못하고 바로 종료된다.
  • 에이전트 시작 전 J-Job 서버가 반드시 정상 상태이어야 한다.

중지

J-Jobs 전체 중지시 시작의 역순으로 처리한다.

J-Job 에이전트 -> J-Job 서버 -> J-Job 매니저, 필요할 경우 J-Jobs 메타 DBMS 순으로 중지시킨다.

J-Job 메타 DBMS 중지

  • 설치된 위치에서 stop_db.sh 또는 stop_db.bat을 실행한다.

J-Job 매니저 중지

  • 설치된 위치에서 stop_manager.sh 또는 stop_manager.bat를 실행한다.

J-Job 서버 중지

  • 설치된 위치에서 stop_server.sh 또는 stop_server.bat을 실행한다.

J-Job 에이전트 중지

  • 설치된 위치에서 stop_agent.sh 또는 stop_agent.bat을 실행한다.

상태 확인

각각의 상태는 다음과 같이 확인한다.

J-Job 메타 DBMS 상태 확인

  • 정상적으로 설치되고 구동되었다면 Windows 같은 경우 다음 그림과 같은 창과 메시지를 통해 정상 작동 상태를 확인 할 수 있다.
  • Linux 환경에서는 다음과 같은 메시지를 통해 정상 작동 상태를 확인할 수 있다.
  • 또한 DBMS가 설치된 위치(위에 기술한 디렉토리 구조)에서 engn/shl/checkstatus.sh 또는 engn/shl/checkstatus.bat 명령어를 수행하여 서버 실행 상태를 확인 할 수 있다. 정상적으로 구동된 경우 기동 메시지와 시작된 DBMS 프로세스의 PID를 반환한다.

J-Job 매니저

정상적으로 J-Job 매니저가 WAS를 통해 기동되었을 경우, J-Job Manager 접속 주소를 통해 접속이 가능한 상태이며 로그인도 정상적으로 이루어지는 것을 통해 정상 기동 상태를 확인할 수 있다.

J-Job 서버

정상적으로 J-Job 서버가 WAS를 통해 기동되었을 경우, J-Job 매니저에 접속하여 [모니터링 > 서버] 메뉴에서 Agent의 연결 여부에 따라 다음과 같이 J-Job 서버의 정상 기동 상태를 확인할 수 있다.

  • 서버가 정상 상태이며, 최소 한 대 이상의 에이전트가 정상 연결되었을 경우
  • 서버가 정상 이지만, 에이전트 연결이 없는 경우

J-Job 에이전트 상태

J-Job Manager로 접속하여 [모니터링 > 서버] 혹은 [모니터링 > 에이전트] 메뉴를 통해 에이전트의 상태를 확인한다. (자세한 내용은 운영자 가이드를 확인한다.)

메타 테이블 설치

J-Jobs 최초 설치 후, J-Jobs에서 사용하는 메타 테이블을 DBMS에 설치(생성)한다. J-Job 매니저에 접속한다.

http://192.168.0.1:7065/jjob-manager
http://[서버IP]:[서버Port]/jjob-manager

최초 설치후 시스템 관리자(root)로 로그인 하면 J-Jobs 메타 테이블이 생성되어 있지 않기에 아래 팝업과 함께 테이블 설치 화면으로 이동한다.

  • 메타 테이블 설치 : J-Jobs 에서 사용할 메타 테이블을 전체 생성(create) 한다. 설치 시 root 사용자의 비밀번호를 입력한다.
  • 로그인 화면으로 이동 : 테이블 생성 후 로그인 화면으로 이동하여 root로 로그인 후 설치/제거 메뉴에서 초기화 마법사를 이용하여 간편하게 설치작업을 수행한다.

초기화 마법사

root 사용자로 로그인하여 **[설치/제거 > 초기화 마법사]**를 통해 기초 데이터를 생성할 수 있다.

라이선스 등록, 서버 등록 및 Datasource 등록 등을 한 번에 할 수 있는 마법사 툴이다.

  • 라이선스 : Orchestrator로 발급된 정식 또는 개발 라이선스를 업로드 하고 [다음]을 클릭한다.

  • 기본 설정 : 필요한 항목에 대한 초기화 작업을 진행한다. 기본값을 유지한채 [다음]을 클릭한다.

  • 관리자 계정 : 운영 업무 관리자(Administrator) 등록을 위해 ID, 이름, 비밀번호를 등록 후 [다음]을 클릭한다.

  • JDBC URL: J-Jobs 설치시 설정한 메타 DBMS 정보의 IP, Port와 일치하는지 확인한다.
  • 사용자 이름 : J-Jobs 설치시 메타 DBMS 접속 계정으로 입력했던 값을 입력한다. 설치시 별도로 지정하지 않았다면 jjobs로 기본값이 설정된다.
  • 비밀번호 : J-Jobs 설치시 메타 DBMS 접속 비밀번호로 입력했던 값을 입력한다. 설치시 별도로 지정하지 않았다면 jjobs1234로 기본값을 입력한다.
  • 모든 설정값을 확인하고 이상이 없으면 [다음]을 클릭한다.

  • 서버 그룹 ID : 기본 서버 그룹은 J-Jobs 초기 설치시 설정했던 서버 그룹 ID와 동일한 값이 입력되어 있는 확인한다.
  • 서버 그룹 이름 : 기본 서버 그룹 이름을 식별할 수 있는 이름을 입력한다.
  • 매핑할 서버 그룹 ID: 기본 서버 그룹의 서버 그룹 ID 값이 입력되었는지 확인한다.
  • 서버 ID : 서버를 식별하기 위한 값으로 J-Job 서버 설치시 지정했던 서버 ID값과 동일한 값이 입력 되었는지 확인한다.
  • 서버 이름 : 서버를 쉽게 식별할 수 있게 이름을 입력한다.
  • 서버 호스트명 : 서버의 호스트명과 일치하는지 확인한다.
  • 서버IP : J-Job 서버 설치시 입력했던 IP와 일치하는지 확인한다.
  • 서버포트 : 웹서비스 포트로 J-Job 서버 설치시 입력했던 Port와 일치하는지 확인한다.
  • 모든 설정값을 확인하고 이상이 없으면 [다음]을 클릭한다.

  • 샘플 Job 추가 : 제공되는 샘플 Job을 생성하는 옵션이며, 확인 후 [초기화 실행하기] 를 클릭한다.

비밀번호를 입력하고 성공 팝업이 보인다면 기본 설치가 완료된 것이다.

기본 예제 실행

아래 순서로 기본 예제를 실행하여 간단한 Job 등록과 실행하여 전체적으로 설치가 정상으로 이루어는지 마지막으로 확인한다.

  • ADMINISTRATOR 권한 사용자(admin)로 로그인 하여 USER 권한의 사용자를 추가 등록한다. 운영자 가이드 > 사용자 참고
  • USER 권한 사용자로 로그인 하여 Job을 등록하고 실행한다. 사용자 가이드 > 빠르게 시작하기 참고

삭제

삭제도 설치와 동일하게 Windows 와 linux를 구분하여 기술한다.

Windows 버전 삭제

설치된 디렉토리로 이동하여 unins000.exe를 실행하면 삭제된다.

단, 삭제전 종료 절차에 따라 종료해야 정상적으로 삭제가 된다.

linux 버전 삭제

linux는 서버와 에이전트를 각각 삭제한다. 설치시 사용했던 installer를 이용하여 삭제하는 경우 --clean 옵션에 설치된 base경로를 입력하여 삭제한다.

# ./jjob_installer_linux_64_2.x.x.sh --clean /engn001/jjobs

Installer가 없는 경우에는 종료 절차에 따라 종료하고 설치된 base경로를 rm명령어로 삭제하면 된다.

Trouble Shooting

설치 후 start_db.bat 실행하였는데 창이 바로 사라지는 경우

서버 시작됨이라는 메시지가 나타나지 않고 창이 바로 사라지거나 Windows 환경에서 설치 중에 "MSVCR120.dll이 없어 프로그램을 시작할 수 없습니다." 와 같은 에러 메세지가 나타나는 경우에는 마이크로소프트에서 제공하는 Visual C++ 패키지 파일이 없어 DB가 제대로 설치되지 않았을 가능성이 높다. 이때에는 다음과 같은 절차로 DB 초기화를 진행하여 문제를 해결한다.

1. vcredist_x64.exe 설치

먼저 microsoft 홈페이지에서 Visual C++ 2013와 Visual C++ 재배포 가능 패키지 를 다운 받아서 설치한다. 설치는 간단하게 끝난다.

[Visual C++ 2013와 Visual C++ 재배포 가능 패키지]
http://download.microsoft.com/download/F/8/D/F8D970BD-4218-49B9-B515-E6F1669D228B/vcredist_x64.exe

Windows 버전에 따라 [Visual C++ 2013와 Visual C++ 재배포 가능 패키지]가 설치되지 않을 수가 있는데, 그 때에는 다른 버전 을 다운로드해서 설치해본다.

[버전별 Visual C++ 재배포 가능 패키지]
https://support.microsoft.com/ko-kr/help/2977003/the-latest-supported-visual-c-downloads

2. Powershell 버전 및 설정 확인

Powershell 버전이 2.0 이상이어야 설치가 진행되며 3.0 이상을 사용할 것을 권장한다. 버전이 안맞을 경우 설치 진행 중 아래와 같은 Method 관련 오류가 발생할 수 있다.

Powershell의 Executionpolicy 설정이 RemoteSigned 인지 확인하여 아닐 경우 변경이 필요하다.

Executionpolicy 설정이 RemoteSigned 이외의 값일 경우 아래와 같은 오류가 발생하여 설치가 불가능하다.

3. 기 설치된 DB Data 제거

[J-Jobs 설치 위치]\dbms\data 폴더가 있으면 해당 폴더를 삭제한다.

4. DB 초기화 수행

[J-Jobs 설치 위치]\dbms\engn\shl\init_db.cmd 파일을 실행하여 DB 초기화를 실행한다.

5. DB 실행

[J-Jobs 설치 위치]\start_db.bat 파일을 실행하여 DB 가 정상 실행됨을 확인한다.

linux 및 unix 에서 설치중 unzip 유틸리가 없어서 설치가 안되는 경우

yum 또는 apt-get 명령어로 unzip을 먼저 설치 후 진행한다.

unix인 경우 각 플랫폼에 맞는 설치 버전으로 unzip을 설치한다.

unix에서 설치중 tar유틸리티에서 z 옵션이 없어서 압축파일이 풀리지 않을 경우

먼저 gunzip 으로 jjobs_Orchestrator_linux_installer_x64_v2.3*.tar.gz 압축을 풀고 tar xvf 옵션으로 tar를 해제한다.

J-Jobs 실행시 정상적으로 process가 구동하지 않고 멈추는 현상이 발생할 경우

디스크 공간 및 메모리 사이즈를 확인하여 하드웨어 권장사항에 맞는 자원이 확보되었는지 확인한다.

linux에서 J-Jobs 서버 설치중 다음과 같은 오류 메시지를 발생할 경우

3. Initialize DB.
initdb: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
fail to install jjobs!!

J-Jobs 메타 DBMS인 PostgreSQL은 보안상 이유로 root로 설치할 수 없다. 따라서 일반계정을 이용하여 설치를 진행한다.