버전 및 업데이트
모든 Xisom 빌드에는 버전이 있습니다. 어떤 버전이 실행 중인지, 그리고 시스템의 모든 부분이 일치하는지 아는 것은 업데이트 후 또는 무언가가 예기치 않게 동작할 때 가장 먼저 확인해야 할 사항입니다.
정보 패널
섹션 제목: “정보 패널”설정 → 정보를 엽니다. 여기에는 실행 중인 플랫폼 버전과 함께
빌드 식별 정보가 표시됩니다. 버전은 표준 MAJOR.MINOR.PATCH 형식을
따릅니다(예: v1.5.0).
상태 엔드포인트에서 백엔드 버전을 확인할 수도 있습니다:
curl -s https://your-device-ip/api/system/health# → { "version": "v1.5.0", "commit": "...", "buildTime": "..." }버전 불일치가 의미하는 것
섹션 제목: “버전 불일치가 의미하는 것”정보 패널은 프런트엔드 버전(브라우저의 대시보드)과 백엔드 버전(실행 중인 서비스)을 모두 표시합니다. 둘이 다를 경우 패널은 불일치를 강조 표시합니다.
운영 관점에서:
- 오래된 브라우저 탭 — 가장 흔하고 무해한 원인입니다. 대시보드를 강력 새로고침(hard-refresh)하거나(또는 닫았다가 다시 열어) 현재 버전을 로드합니다.
- 부분 업데이트 — 한 서비스는 재배포되었지만 다른 서비스는 그렇지 않았습니다. 모든 부분이 동일한 버전에 도달하도록 업데이트를 다시 실행합니다. 오프라인 번들 설치 → 업데이트를 참조하세요.
확신이 서지 않을 때는 다른 동작을 문제 해결하기 전에 프런트엔드와 백엔드 버전을 일치시키세요 — 불일치는 버그처럼 보이는 증상을 설명할 수 있습니다.
업데이트 후
섹션 제목: “업데이트 후”- 설정 → 정보를 다시 엽니다.
- 프런트엔드와 백엔드 버전이 일치하는지 확인하고 예상하는 버전을 읽습니다.
- 일치하지 않으면 강력 새로고침을 합니다. 문제가 지속되면 업데이트를 다시 실행합니다.
문제가 발생하면
섹션 제목: “문제가 발생하면”- 새로고침 및 재업데이트 후에도 버전 불일치가 지속되는 경우 — 문제 해결 런북을 참조하세요.