문제 해결

자주 발생하는 문제

페어링 코드가 표시되지 않거나 작동하지 않습니다.

다음과 같은 상황에서는 페어링 코드 가 표시되지 않거나 인쇄가 되지 않을 수 있습니다.

  • IoT 시스템이 네트워크에 연결되어 있지 않습니다.

  • IoT 시스템이 이미 Odoo 데이터베이스에 연결되어 있습니다. 데이터베이스에서 연결을 해제하세요.

  • 페어링 코드 표시 시간이 만료되었습니다. IoT 박스 또는 :ref:`Windows 가상 IoT 서비스 <iot/windows_iot/restart>`를 다시 시작하여 페어링 코드를 생성하고 표시하세요.

IoT 시스템이 데이터베이스에 연결되지 않습니다

IoT 시스템이 데이터베이스에 연결될 때 재시작하는 데 몇 분이 걸릴 수 있습니다. 몇 분 후에도 나타나지 않으면:

  • IoT 시스템이 데이터베이스에 도달할 수 있고 서버가 다중 데이터베이스 환경을 사용하지 않는지 확인하세요.

  • IoT 박스 또는 :ref:`Windows 가상 IoT 서비스 <iot/windows_iot/restart>`를 다시 시작하세요.

IoT 시스템이 Odoo 데이터베이스에 연결되어 있지만 연결할 수 없습니다

IoT 시스템과 Odoo 데이터베이스를 실행하는 컴퓨터가 동일한 네트워크에 연결되어 있는지 확인하고 필요한 경우 DNS 설정을 업데이트하세요.

Windows 가상 IoT 홈페이지는 다른 장치에서 액세스할 수 없습니다.

  • 장치가 Windows 가상 IoT와 동일한 네트워크에 연결되어 있는지 확인하세요.

  • Windows 방화벽 환경설정 를 확인하세요.

Odoo 업그레이드 후 IoT 시스템이 작동하지 않음

IoT 박스 또는 :ref:`Windows 가상 IoT 서비스 <iot/windows_iot/restart>`를 다시 시작하세요.

문제가 지속되면 IoT 박스의 카드를 플래싱하여 이미지를 업데이트하거나 Windows 가상 IoT 프로그램을 제거하고 가상 IoT 패키지를 재설치하세요.

IoT 시스템의 홈페이지는 IP 주소로는 접근할 수 있지만 xxx.odoo-iot.com URL로는 접근할 수 없습니다.

문제 해결을 위해 시스템 또는 네트워크 관리자에게 문의하세요. 네트워크 관련 문제는 Odoo 지원 서비스 범위를 벗어납니다.

  • 라우터가 수동 DNS 구성을 허용하는 경우 `Google DNS <https://developers.google.com/speed/public-dns>`_를 사용하도록 설정을 업데이트하세요.

  • 라우터가 해당 기능을 지원하지 않는 경우 IoT 시스템과 연동되는 각 장치에서 DNS 설정을 직접 업데이트해야 Google DNS <https://developers.google.com/speed/public-dns> 를 사용할 수 있습니다. 개별 장치에서 DNS를 설정하는 방법에 대한 지침은 각 제조업체의 웹사이트에서 확인할 수 있습니다.

참고

  • 결제 단말기와 같은 일부 IoT 장치는 일반적으로 사용자 정의 DNS 설정으로 미리 구성되어 있으므로 DNS 변경이 필요하지 않을 수 있습니다.

  • 일부 브라우저에서 DNS와 관련된 오류 코드(예: DNS_PROBE_FINISHED_NXDOMAIN)가 표시됩니다.

The IoT system is connected and reports are assigned to a printer that cannot print

Verify that the browser is allowed to access devices on the local network.

HTTPS 인증서 생성 문제 및 오류

HTTPS 인증서가 생성되지 않음

원인이 될 수 있는 내용은 다음과 같습니다:

  • 데이터베이스가 :ref:`HTTPS 인증서 <iot/connect/https_certificate>`를 생성하기 위한 :ref:`자격 요건 <iot/https_certificate_iot/iot-eligibility>`을 충족하지 않습니다.

  • 방화벽이 HTTPS 인증서가 올바르게 생성되는 것을 방해하고 있습니다. 이 경우 인증서가 성공적으로 생성될 때까지 방화벽을 비활성화하세요.

    참고

    내장 방화벽이 있는 라우터와 같은 일부 장치는 HTTPS 인증서 생성을 방해할 수 있습니다.

오류

HTTPS 인증서생성 또는 수신 중에 문제가 발생하면 IoT 시스템의 홈페이지에 특정 오류 코드가 표시됩니다.

IoT 시스템 홈페이지에 접속하면 자동으로 HTTPS 인증서를 확인하고, 인증서가 없을 경우 인증서 생성을 시도합니다. 오류가 표시될 경우 페이지 새로고침을 통해 문제 해결 여부를 확인합니다.

자격 증명 누락

계약 및/또는 데이터베이스 :abbr:`UUID(범용 고유 식별자)`가 IoT에서 누락되었습니다.

두 값이 모두 올바르게 구성되어 있는지 확인하세요. 업데이트하려면 IoT 박스의 또는 Windows 가상 IoT의 홈페이지에 접속하여 (톱니바퀴) 버튼을 클릭한 다음 :guilabel:`자격 증명`을 클릭하세요.

참고

  • 전체적인 요청 예외 세부 정보에 액세스하여 오류와 관련된 내용을 확인하려면 개발자 모드 활성화 를 클릭하고 IoT 앱에서 IoT 시스템 카드를 클릭한 다음 IoT 시스템 양식 에서 로그 다운로드 를 클릭합니다. IoT 시스템의 로그 파일에 기록된 로그 수준을 지정하려면 IoT 상자 관련 또는 Windows 가상 IoT 관련 홈페이지에 액세스한 후 (톱니바퀴) 버튼을 클릭한 다음 페이지 하단에 있는 로그 수준 을 클릭합니다.

  • 네트워크 관련 문제를 해결하려면 시스템 또는 네트워크 관리자에게 문의하세요. 이러한 문제는 Odoo 지원 서비스 범위를 벗어납니다.

Odoo.com에 연결할 수 없음

IoT 시스템이 <https://www.odoo.com>`_에 성공적으로 연결되었으나 예상치 못한 `HTTP 응답 (상태 코드) 을 수신했습니다.

이 문제를 해결하려면:

  1. 웹 브라우저에서 `<https://www.odoo.com>`_를 열어 웹사이트가 유지관리를 위해 일시적으로 중단되었는지 확인하세요.

  2. 유지 관리로 인해 https://www.odoo.com 이 다운된 경우 다시 시작될 때까지 대기합니다.
    웹사이트가 작동 중이면 `지원 티켓 <https://www.odoo.com/help>`_을 열고 티켓에 3자리 HTTPS 상태 코드를 포함해야 합니다.

여전히 인증서가 없나요?

IoT 시스템이https://www.odoo.com에 성공적으로 연결되었지만 서버에서HTTPS 인증서제공을 거부한 경우입니다.

IoT 시스템과 데이터베이스가 HTTPS 인증서에 대한 :ref:`자격 요건 <iot/https_certificate_iot/iot-eligibility>`을 충족하는지 확인하세요.

Odoo 지원팀에 IoT Box 액세스 권한 부여

IoT Box에 원격 액세스 권한을 부여해야 하는 경우 IoT Box의 홈페이지에서 Tailscale 토큰을 제공할 수 있습니다. 이를 통해 Odoo 지원팀이 문제 해결을 위해 IoT Box에 안전하게 액세스할 수 있습니다.

경고

공식 Odoo 지원 담당자와 같이 신뢰할 수 있는 출처의 토큰만 입력하세요. 토큰을 제공하면 IoT Box 및 전체 로컬 네트워크에 대한 액세스 권한이 부여되므로 주의해서 진행해야 합니다.

IoT Box의 홈페이지 <iot/iot-box/homepage>`에서:icon:`fa-cogs (톱니바퀴) 버튼을 클릭한 다음:guilabel:`디버깅 도구`를 클릭하세요. 팝업 창에서 Odoo 지원팀이 제공한 Tailscale 토큰을 입력하고:guilabel:`활성화`를 클릭하세요.

참고

**원격 디버그**는:doc:`IoT 박스 <../iot_box>`에서만 사용할 수 있으며:doc:`Windows 가상 IoT <../windows_iot>`에서는 사용할 수 없습니다.

IoT Box가 다운되었나요?

IoT Box가 다운된 경우에도 Odoo 지원팀에 대한 원격 액세스를 활성화할 수 있습니다. :ref:`홈페이지 <iot/iot-box/homepage>`에 표시된 유일한 필드에 키를 제공하고:guilabel:`활성화`를 클릭하기만 하면 됩니다.

원격 디버깅 비밀번호 생성 창

참고

다운된 IoT Box에서 원격 액세스를 활성화하는 기능은 v26.01.2026 이상 버전에서만 사용할 수 있습니다. IoT Box에 이 옵션이 없는 경우:ref:`최신 이미지로 IoT Box의 카드를 플래시 <iot/updating_iot/image-code>`해야 합니다.