이 절차는 가동 중지 시간을 최소화하고 데이터 무결성을 유지하면서 원활한 전환을 보장하는 데 도움이 됩니다. 가능하면 항상 비운영 환경에서 먼저 테스트하십시오.
백업, 제거, 재설치 및 복원 절차
시작하기 전에 중요한 사항:
데이터베이스 백업 및 복원 단계가 가장 중요합니다. 다음 단계로 넘어가기 전에 해당 단계가 성공적으로 완료되었는지 확인하십시오.
- 모든 명령 프롬프트를 관리자 권한으로 실행하십시오.
- 이 지침은 JMP Live 온프레미스 배포의 표준 방식(JMP Pro, JMP Live 데이터베이스 설치 프로그램을 통한 PostgreSQL 데이터베이스, Keycloak 및 JMP Live 서비스 포함)을 기반으로 합니다.
- 서비스가 중단되는 유지보수 시간대에 이 작업을 예약하세요.
1단계: 준비 및 백업
1. 구성 파일을 새 폴더(예: C:\Backup)에 백업합니다.
- JMP Pool 및 JMP Live 설치 디렉터리에 있는 .env 파일을 찾아 복사합니다. 이 두 파일은 재사용됩니다.
- Keycloak .conf 파일을 백업하십시오(참고용이며, 직접 재사용할 수 없습니다).
- 중요: 인증서(certs)는 기본 프로그램 파일 폴더에 저장되지 않도록 하십시오. 프로그램 제거 시 해당 폴더의 인증서가 삭제됩니다. 필요한 경우 안전한 위치로 옮겨 놓으십시오.
2. 모든 JMP Live 서비스를 중지하십시오.
- 서비스 관리자(services.msc)를 열고 서비스를 중지하세요.
- jmppoolsvc
- 웹jmpsvc
- JMP 라이브 키클록
2단계: 데이터베이스 백업
1. 관리자 권한으로 명령 프롬프트를 엽니다.
2. Backups 폴더로 이동합니다(cd 명령어 사용).
3. 다음 데이터베이스 백업 명령을 실행하십시오.
"C:\Program Files\PostgreSQL\13\bin\pg_dump" -Fc -b -h olddbhost -U dba_webjmp -f webjmp.dump webjmp
- 명령어에서 파일 경로를 설치 환경에 맞게 업데이트하십시오.
4. 데이터베이스 크기에 따라 상당한 시간이 소요될 수 있으므로 진행 상황을 모니터링하십시오.
5. 계속 진행하기 전에 백업 파일이 있는지, 비어 있거나 손상되지 않았는지 확인하십시오.
- 이 단계는 매우 중요합니다. 백업이 실패하면 데이터 손실이 발생할 수 있기 때문입니다.
- JMP Live 데이터베이스 전체를 백업하고 복원해야 합니다. 그렇지 않으면 새 배포가 제대로 작동한다는 보장이 없습니다.
3단계: 기존 구성 요소 제거
제어판 > 프로그램 및 기능 또는 프로그램 추가/제거를 통해 다음 프로그램들을 순서에 상관없이 제거하십시오.
- JMP 라이브
- JMP 프로
- JMP 라이브 데이터베이스(PostgreSQL 인스턴스)
- 키클록
4단계: 데이터베이스 설치 및 복원
1. JMP Live 자체 압축 실행 파일에 있는 JMP Live 데이터베이스 구성 요소를 설치합니다.
2. 동일한 관리자 권한으로 실행한 명령 프롬프트와 백업 폴더를 사용하여 다음 복원 명령을 실행합니다.
"C:\Program Files\PostgreSQL\13\bin\pg_restore" -Fc -h newdbhost -U dba_webjmp -d webjmp webjmp.dump
- 명령어에서 파일 경로를 설치 환경에 맞게 업데이트하십시오.
3. 복원 작업이 성공적으로 완료되었는지 확인합니다(로그를 확인하거나 데이터베이스를 조회하십시오).
5단계: 다른 JMP Live 구성 요소를 설치합니다.
다음 순서대로 설치하십시오:
1. JMP 프로
2. 키클록
- 설치 과정에서 필요한 관리자 및 데이터베이스 설정을 입력하십시오.
- 백업해 둔 Keycloak .conf 파일을 메모장으로 열어 구성 값(예: 포트, 관리자 자격 증명, 데이터베이스 연결)을 참조하십시오.
3. JMP 라이브
- 설치 후 .env 파일을 덮어쓸 계획이라면 설치 중 표시되는 메시지가 완전히 정확할 필요는 없습니다.
- 프롬프트가 표시되면 JMP Pro 설치 경로가 올바르게 지정되었는지 확인하십시오(또는 나중에 JMP Pool .env 파일에서 업데이트하십시오. 즉, 18 → 19 참조를 변경하십시오).
6단계: 설치 후 구성
1. 서비스를 다시 중지하십시오(자동으로 시작된 경우):
- 서비스 관리자(services.msc)를 열고 서비스를 중지하세요.
- jmppoolsvc
- 웹jmpsvc
- JMP 라이브 키클록
2. 설정 파일 덮어쓰기
- JMP Pool 및 JMP Live 디렉터리에 있는 새 .env 파일을 백업해 둔 파일로 교체하십시오.
- 버전별 경로(예: JMP Pro 경로 18 → 19)를 검토하고 업데이트하십시오. 이러한 경로는 메모장에서 편집할 수 있습니다.
- 변경 사항을 저장합니다.
3. JMP Live 실행
- `C:\Program Files\JMP\JMP Live\` (또는 설치 경로)로 이동하십시오.
- `launch.cmd`를 관리자 권한으로 실행하세요.
- 두 명령 프롬프트 창이 모두 초기화될 때까지 기다린 후 닫으십시오.
4. 서비스 시작
- 서비스 관리자(services.msc)를 열고 다음 순서대로 서비스를 시작하세요.
- JMP 라이브 키클록
- 웹jmpsvc
- jmppoolsvc
7단계: 최종 확인 및 재승인
1. JMP Live 관리자 웹 인터페이스에 접속합니다.
- https://URL/admin/login
2. 관리자 계정으로 로그인하세요.
3. 관리자 탭으로 이동합니다.
4. JMP Live를 다시 인증합니다(화면의 안내에 따라 라이선스/연결 유효성 검사를 완료하십시오).
5. 주요 기능 테스트: 데스크톱 JMP Pro에서 샘플 보고서 게시, 사용자 액세스 확인, 데이터 새로 고침 확인 등.
문제가 발생할 경우:
- 서비스 상태 및 로그를 확인하십시오.
- 데이터베이스 연결 상태와 Keycloak 영역 설정을 확인하십시오.
- JMP Live 공식 설치 지침을 참조하거나 JMP 기술 지원팀에 문의하십시오.
