장치 등록과 연결

장치 등록은 JelinaOS 클라우드 기능을 사용하기 위한 전제 조건입니다. 배포 환경에 따라 두 가지 경로 중 선택합니다.

경로	적합한 환경	방식
클라우드 등록	네트워크로 JelinaCloud 연결 가능	구성이 포함된 이미지를 기록하면 부팅 후 자동 등록
License 등록	오프라인 / 내부망 / 로컬 라이선스 인증 필요	수동 등록, 로컬 네트워크 등록 서버 또는 오프라인 일괄 인증

클라우드 등록(권장)

네트워크를 통해 JelinaCloud에 연결하는 배포에 적합합니다. 네트워크 연결 후 자동 등록되며 보통 30초 안에 온라인 상태가 됩니다.

참고: 장치 유형은 선택 후 변경할 수 없으므로 하드웨어와 일치하는지 확인하세요. 플릿 기본 유형과 일치하지 않으면 장치가 플릿의 시스템 업데이트를 따르지 못할 수 있습니다.

클라우드 작업의 자세한 절차는 JelinaCloud 장치의 클라우드 등록 안내를 참조하세요.

등록 후 JelinaCloud 장치 목록에서 온라인 상태를 확인하고 상세 페이지에서 장치 상태, 실행 중인 서비스와 로그를 볼 수 있습니다.

등록 키는 한 번만 사용할 수 있습니다. 등록된 장치를 삭제한 뒤 다시 등록하려면 다음이 필요합니다.

공용 네트워크에 연결할 수 없거나 라이선스 권한을 로컬에서 관리해야 하는 배포에 적합합니다. 장치는 등록 코드로 인증하며 클라우드 온라인 등록에 의존하지 않습니다.

이미지에 구성이 포함되지 않은 장치는 장치 도구로 일련번호를 설정하고 등록을 시작합니다. 일련번호는 Advantech가 제공하는 32자리 영숫자입니다.

jelina-manual-register --check       # 등록 상태 확인(0=등록됨/1=등록되지 않음/2=등록 중)
jelina-manual-register <일련번호>      # 일련번호 설정 및 등록 시작

장치 상태 명령 jelina-info --get registration.status으로도 등록 상태를 조회할 수 있습니다.

로컬 네트워크에 등록 서버를 배포하면 장치가 서버에 등록을 요청하고 인증을 완료합니다. 내부망 배포와 일괄 장치 연결에 적합합니다.

서버가 없는 환경에서는 오프라인 인증을 지원합니다.

방식	설명
오프라인 일괄 등록	허용 목록으로 여러 장치를 오프라인 등록
오프라인 서명	온라인 환경에서 등록 서명을 미리 생성하고 장치에 오프라인 적용

License로 등록한 장치는 네트워크가 복구되면 JelinaCloud와 인증 데이터를 동기화하고 클라우드 관리 기능을 계속 사용할 수 있습니다.

장치는 클라우드 구성을 보존하면서 상태 보고와 업데이트 폴링 등 네트워크 작업을 중단하는 오프라인 실행 모드를 지원합니다. 일시적인 연결 단절이나 엄격한 격리가 필요한 환경에 적합합니다. 다음 장치 명령으로 상태를 확인합니다.

jelina-offline --state    # 오프라인 모드 상태 확인

오프라인 모드 전환은 클라우드 관리 기능에 영향을 줍니다. 명확히 필요한 경우에 수행하고 복구 방법을 먼저 확인하세요.

장치가 오랫동안 온라인 상태가 되지 않나요? 네트워크 연결, 이미지 기록 시 올바른 구성 파일을 포함했는지, 장치 유형이 일치하는지 확인하세요.

장치 유형을 잘못 선택했나요? 등록 후 장치 유형은 변경할 수 없습니다. 구성을 다시 다운로드하여 이미지를 기록하고 올바른 유형으로 등록하세요.

오프라인 환경에서 장치를 어떻게 등록하나요? License 등록 경로를 사용합니다. 일련번호를 수동 설정한 뒤 로컬 네트워크 등록 서버 또는 오프라인 일괄 방식으로 인증합니다.