시스템 업데이트

JelinaOS의 업데이트 체계는 시스템, 커널, 장치 에이전트 및 증분 업데이트의 네 가지 대상을 다루며, 클라우드와 로컬의 두 가지 경로를 지원합니다. A/B 이중 시스템 메커니즘을 바탕으로 모든 업데이트에서 이전 상태로 돌아갈 수 있습니다.

업데이트 대상

업데이트 대상	설명
시스템(JelinaOS)	기능 개선 및 보안 수정이 포함된 시스템 버전 업그레이드
커널	성능 및 하드웨어 지원을 개선하는 커널 버전 업데이트
장치 에이전트	장치 관리 구성 요소 업데이트
증분 업데이트	시스템 증분 패치를 빠르게 배포

업데이트 방식

클라우드 OTA(권장)

JelinaCloud에 연결한 후 플릿 또는 장치 페이지에서 업데이트를 통합 관리합니다.

클라우드에서 대상 버전(시스템 / 커널 / 에이전트)을 지정합니다.
클라우드가 정책에 따라 업데이트를 전달합니다(버전 고정 및 단계적 실행 지원).
장치가 자동으로 다운로드하여 적용하며, 업데이트 상태는 클라우드에서 실시간으로 확인할 수 있습니다.

클라우드 업데이트는 오프라인 업데이트 패키지도 지원합니다. 네트워크에 연결할 수 없는 장치를 위해 업데이트 패키지를 다운로드하여 현장에서 오프라인으로 적용할 수 있습니다. USB 드라이브 등 이동식 매체로 업데이트 패키지를 전달할 수도 있으며, 장치는 매체를 연결하면 자동으로 업데이트를 처리합니다.

로컬 OTA

클라우드 환경이 없으면 장치의 업데이트 도구를 사용합니다.

# 버전 및 업데이트 상태 확인
jelina-local-ota -g
jelina-local-ota -s
jelina-local-ota --json --status      # 구조화된 상태 출력

# 확인 대기 중인 업데이트 확인(로컬 확인 모드)
jelina-local-ota --confirmation

# 업데이트 패키지 사전 점검(적용하지 않고 파싱 및 검증만 수행)
jelina-local-ota --check <업데이트_패키지>

내용을 확인한 후 업데이트 패키지를 제출하여 적용합니다(업데이트 확인 메커니즘이 활성화된 경우 확인 대기 상태로 진입하며, 확인 후 실행됨).

jelina-local-ota <업데이트_패키지>
jelina-local-ota -c -w    # 현재 대기 중인 업데이트 승인 및 진행 상황 추적

단일 구성 요소 업데이트 패키지(.pkg)

개별 구성 요소의 업데이트 패키지(예: 장치 에이전트, 애플리케이션 구성 요소)는 설치 프로그램을 통해 적용할 수 있습니다.

jelina-instpackage --pkg-info <구성_요소_패키지.pkg>   # 패키지 정보 확인(설치하지 않음)
jelina-instpackage <구성_요소_패키지.pkg>              # 구성 요소 패키지 설치

설치 전에 패키지 출처와 체크섬을 확인하세요. 일부 구성 요소는 업데이트 후 다시 시작해야 적용됩니다.

업데이트 패키지 유형

JelinaOS는 용도와 적용 도구가 서로 다른 두 가지 업데이트 패키지 형식을 사용합니다.

패키지 유형	형식	용도	설치 도구
단일 구성 요소 패키지	`.pkg`	개별 구성 요소 업데이트(시스템/커널/장치 에이전트/애플리케이션 구성 요소 등)	`jelina-instpackage`
OTA 업데이트 패키지	`.zip`	전체 업데이트(목표 상태와 여러 구성 요소를 포함하며 장치 에이전트가 통합 오케스트레이션)	`jelina-local-ota`

설치 방식

단일 구성 요소 패키지는 대상에 따라 다른 설치 방식을 사용합니다.

방식	설명
전체 기록	대상 파티션에 기록(일반적으로 대기 중인 A/B 파티션)
압축 해제 설치	지정된 파티션, 파일 또는 디렉터리에 압축 해제
증분 설치	오버레이 계층으로 설치(즉, 증분 업데이트이며 파티션을 전환하지 않음)
실행 설치	설치 후 한 번 실행(위험도가 높으며 특정 상황에만 사용)

설치 성공이 활성화를 의미하지는 않음

설치 프로그램이 성공을 반환해도 새로운 내용이 이미 적용된 것은 아닙니다. 시스템, 커널 등의 구성 요소는 업데이트 후 다시 시작하거나 다시 마운트해야 활성화됩니다. 다시 시작한 후 실제 실행 중인 버전과 파티션을 검증한 다음 업데이트 완료를 확인하세요.

두 패키지 유형을 혼용하지 마세요

OTA 업데이트 패키지(.zip)를 단일 구성 요소 설치 프로그램에 전달하거나, 단일 구성 요소 패키지(.pkg)를 목표 상태를 우회하여 수동으로 설치해서는 안 됩니다. 구성 요소 간 업데이트 순서가 깨질 수 있습니다.
클라우드에서 다운로드한 오프라인 OTA 패키지는 jelina-local-ota를 통해 적용하세요.

업데이트 확인 방식

중요한 현장에서는 로컬 확인 후 실행하도록 업데이트를 설정할 수 있습니다.

클라우드에서 배포한 새 버전이 장치에 도착하면 먼저 저장하고 즉시 설치하지 않습니다.
현장 담당자가 확인한 후에만 업데이트 실행을 시작합니다.
장치 명령 또는 장치 화면에서 확인할 수 있습니다.
확인 전까지 장치는 현재 버전으로 계속 실행되며, 현장에 최종 결정권이 있습니다.

업데이트 절차 및 안전 보장

업데이트 패키지 다운로드 → 무결성 검증 → 대기 파티션에 쓰기 → 재부팅 후 전환 → 부팅 검증
                                                            │
                                                ✅ 성공: 계속 실행
                                                ❌ 실패: 이전 시스템으로 자동 복귀

업무를 중단하지 않는 업데이트: 다운로드와 기록이 백그라운드에서 진행되며 장치는 계속 실행됩니다.
실패 시 자동 복귀: 전환 후 검증에 실패하면 자동으로 기존 시스템으로 돌아갑니다.
버전 롤백 지원: 적용한 새 버전에 문제가 발생하면 이전 버전으로 롤백할 수 있습니다.

업데이트 상태 확인

jelina-info          # 현재 버전 및 부팅 파티션 확인
jelina-local-ota -s  # 업데이트 상태 및 대기 중인 업데이트 확인

클라우드 장치 대시보드에도 버전과 업데이트 상태가 표시됩니다.

업데이트 권장 사항

상황	권장 사항
정기 유지보수	패치 업데이트를 적시에 적용하여 보안 기준 유지
버전 업그레이드	먼저 테스트 장치에서 검증한 후 일괄 배포
규정 준수 요건이 엄격한 산업	로컬 확인 메커니즘을 활성화하고 업데이트 전 충분히 검증
대역폭이 제한된 현장	증분 업데이트 또는 오프라인 업데이트 패키지 사용