본문으로 건너뛰기

문제 해결

증상에서 시작하세요.

증상할 일
Start session 화면의 로봇 목록이 비어 있다납품 시 설정된 프로필이 보이지 않는 상태입니다. 지원팀에 문의하세요. 화면 설명은 기동 구성에 있습니다
s 를 눌렀는데 스택이 안 뜬다로봇 스택 기동
plem 을 켜자마자 로봇 스택과 서버가 error creating node 로 멈춘다plem update 로 최신 버전을 받으세요. 설치·업데이트가 ROS 2 통신에 필요한 커널 수신 버퍼 설정을 깔고 바로 적용합니다. 업데이트 중 could not apply net.core.rmem_max 경고가 나왔다면 sudo sysctl --system 을 실행하거나 재부팅하세요
로봇이 보호 정지로 멈춰 움직이지 않는다쓰고 있는 도구에서 복구하세요. TUI 화면은 정지와 복구, Teaching Pendant 화면은 보호 정지 풀기에 있습니다. 멈춘 이유와 ROS 2 클라이언트가 지킬 규칙은 정지·안전에 있습니다
브레이크 해제가 거부되고 로그에 [RT] SLAVE_NOT_OPERATIONAL 이 뜬다기동 직후라면 잠시 뒤 다시 해제해 보세요. 계속되면 sudo dmesg | grep -i ethercat 의 출력과 함께 지원팀에 문의하세요
드라이브가 Quick stop 등으로 멈춘 채 풀리지 않는다PLEM 명령 중에는 이를 푸는 명령이 없습니다. 스택을 끄기 전에 로봇이 실제로 멈췄는지 눈으로 확인하세요. 정지·안전 참조
웹 화면(:8080)이 안 열린다웹 화면이 안 열린다
카메라 영상이 없다ZED X Mini 카메라가 잡히지 않는다
터미널의 ros2 topic list 에 로봇이 안 보인다ros2 에서 로봇이 보이지 않는다
펜던트·Lab 대신 PLEM is locked 페이지가 뜬다, 또는 토큰이 거부된다라이선스·토큰 오류
라이선스 파일이나 plem code 기기 키를 잃었다라이선스·키를 잃었을 때
plem 이 ros_domain_id 오류를 보이며 시작하지 않는다~/.plem/settings.yaml 의 ros_domain_id 를 1–101 정수로 고치거나 그 줄을 지우세요. 화면에 파일 경로와 허용 범위가 나옵니다
그리퍼·카메라 목록이 비어 있다PLEM 환경이 잡혀 있는지, 로봇 패키지가 설치돼 있는지 확인하세요. 필요하면 plem update 를 실행하세요. 그래도 비면 지원팀에 문의하세요
업데이트한 뒤 동작이 달라졌다변경 이력을 확인하세요. 되돌리기는 없습니다(업데이트)

웹 화면이 안 열린다​

순서대로 확인하세요.

확인할 것아니면
스택이 떠 있는가. 웹 화면은 스택과 함께 뜹니다Robot Control 화면에서 s 로 기동하세요
Start session 화면에서 Teaching Pendant·Plem Lab 구성 요소를 켠 채 기동했는가. 기본값은 둘 다 켜짐입니다스택을 내리고 켠 뒤 다시 기동하세요
주소가 맞는가. 끝 슬래시(/web/, /lab/)까지 포함해야 합니다. Robot Control 화면에서 ] 를 누르면 나옵니다주소를 고치세요. 다른 컴퓨터라면 기기와 같은 네트워크인지, 8080 포트가 막혀 있지 않은지 확인하세요
기기 화면에서 직접 열 때 plem-pendant --check 가 status=ok 인가snap 버전이 아닌 Firefox, 또는 PLEM_BROWSER 로 지정한 브라우저가 있어야 합니다

모두 맞는데 안 열리면 웹 브릿지만 빠졌을 가능성이 큽니다. 기동 로그에 브릿지 관련 경고가 있으면 나머지 스택이 정상이어도 웹 화면만 안 뜹니다. 스택을 내리고 다시 기동하세요.

PLEM is locked 페이지가 뜨면 라이선스 문제입니다. 라이선스·토큰 오류를 보세요.

ZED X Mini 카메라가 잡히지 않는다​

이 카메라는 GMSL2 연결이며, 기기의 카메라 데몬 상태가 어긋나면 영상이 나오지 않습니다. 로봇 스택을 띄울 때 점검과 복구가 자동으로 실행되고, 아래 명령으로 직접 확인할 수도 있습니다. 다른 카메라를 쓴다면 로봇 스택 기동의 실패 신호 표를 보세요.

/usr/share/plem/plem-camera-recover.sh --check # 판정만 (아무것도 바꾸지 않습니다)
sudo /usr/share/plem/plem-camera-recover.sh # 필요하면 복구까지
제조사 도구의 「정상」 표시를 근거로 삼지 마세요

카메라 제조사 진단 도구가 장치를 정상으로 보고해도 이 상태를 놓칠 수 있습니다. 판정은 위 스크립트로 하세요.

충돌 회피 구성 요소(Isaac ROS)를 설치한 기기에서 영상이 없고 기동 로그에 libgxf_serialization.so: cannot open shared object file 이 있으면 sudo /usr/share/plem/setup-cumotion.sh 를 한 번 실행하세요. apt 로 직접 업그레이드한 기기에만 필요합니다. plem update 로 업데이트했다면 이미 적용돼 있습니다.

ros2 에서 로봇이 보이지 않는다​

  1. 업데이트한 뒤 처음이라면 새 터미널에서 ros2 daemon stop 을 한 번 실행하세요. 이전 설정을 기억하는 ros2 데몬이 남아 있으면 로봇이 보이지 않습니다.
  2. ~/.bashrc 등에 ROS_DOMAIN_ID·CYCLONEDDS_URI·RMW_IMPLEMENTATION 을 export 한 줄이 있으면 지우고 새 터미널을 여세요. 남겨 두면 그 셸의 ros2 만 로봇과 갈라집니다. 도메인은 plem 설정(,)에서 바꿉니다.

설정을 바꾼 뒤의 터미널, 네트워크 인터페이스, 다른 컴퓨터에서 접속하는 법은 ROS 2 인터페이스에 있습니다.

라이선스·토큰 오류​

PLEM is locked 페이지​

기기 라이선스가 없거나 만료됐거나 확인할 수 없으면 :8080 의 펜던트·Lab 자리에 PLEM is locked 페이지가 뜨고 서버 기능이 모두 막힙니다. 브라우저 탭 제목은 PLEM — License required 입니다. 페이지는 영어이고, 회색 상자에 사유가, 그 아래 「What to do」에 조치가 나옵니다. 유효한 라이선스가 없으면 로봇 컨트롤러도 기동하지 않습니다.

페이지의 사유할 일
만료(Expired)담당자에게 연장을 요청한 뒤 sudo plem-register --refresh 를 실행하세요
그 밖의 라이선스 사유(다른 기기, 검증 실패, 손상된 파일, 내부 오류 등)담당자에게 문의하세요
libplem_control.so 를 열지 못함sudo apt install --reinstall plem-core 로 다시 설치하세요
libethercat.so.1 을 열지 못함IgH EtherCAT 마스터가 설치돼 있지 않습니다. 지원팀에 문의하세요
그 밖의 이름의 라이브러리(*.so)를 열지 못함그 파일을 제공하는 패키지를 확인하세요
라이브러리 이름 없이 비정상 종료·시간 초과sudo apt install --reinstall plem-core 로 다시 설치하세요. 반복되면 지원팀에 문의하세요

사유 문장에 따로 적힌 지시가 있으면 그것도 따르세요. 조치한 뒤에는 plem 에서 로봇 스택을 다시 시작해야 적용됩니다.

토큰 거부​

plem update·plem-register·plem code 가 토큰 거부를 받으면 흔한 두 원인과 각각의 조치를 함께 보여 줍니다. 서버가 둘을 구별해 주지 않으므로 어느 쪽인지는 담당자에게 확인하세요. plem-register 는 두 경우 모두 종료 코드 11로 끝납니다.

원인뜻할 일
토큰 폐기폐기는 영구입니다. 담당자가 기기를 삭제하면 그 기기에 쓴 토큰도 함께 폐기됩니다폐기된 토큰은 되살릴 수 없습니다. 담당자에게 이 기기의 기존 등록 삭제와 새 토큰을 요청하세요. 그다음 plem uninstall 로 제거하고 새 토큰으로 다시 설치하세요. 설치 명령은 이미 등록된 기기에서는 멈추기 때문입니다
라이선스 만료기기에 등록된 토큰은 라이선스 만료일을 따릅니다. 만료되면 plem update 가 거부되고 plem code 도 다음 키 갱신부터 거부됩니다. 원격 지원 plem remote 는 열립니다담당자에게 연장을 요청한 뒤 sudo plem-register --refresh 로 새 라이선스를 받고 로봇 스택을 다시 시작하세요. 연장 전에 실행하면 같은 401로 거부됩니다

등록은 Depot 단위입니다​

이미 등록된 기기를 다른 Depot 주소에 새 토큰으로 등록하면 그 Depot 쪽에 새 기기로 등록됩니다. 이때 기기의 라이선스(/etc/plem/license.key)와 등록 정보(/etc/plem/depot.json)가 새 것으로 바뀝니다. 다시 등록하기 전에 지금 등록처가 어디인지 담당자에게 확인하세요.

라이선스·키를 잃었을 때​

/etc/plem/ 아래 파일은 직접 고치지 마세요.

잃은 것할 일
라이선스 파일(/etc/plem/license.key)담당자에게 이 기기의 라이선스 재발급을 요청하세요. 등록 해제는 필요 없습니다. 다시 등록해도 복구되지 않습니다. 이미 등록된 기기라 등록이 거부됩니다(plem-register 종료 코드 16). 재발급은 Depot 쪽에 저장된 만료일로 다시 서명하므로, 등록이 이미 만료됐다면 연장이 필요합니다
plem code 기기 키(/etc/plem/code/plem-code-key.json)기기에서 sudo plem-register --reissue-plem-key 를 실행하세요. 아래 주의를 먼저 보세요

재발급된 값(license_file)을 받았다면 디코드하지 말고 다음 한 줄로 설치한 뒤 로봇 스택을 다시 시작하세요. 파일 모드가 0644가 아니면 PLEM 쪽에서 파일을 읽지 못해 거부합니다.

printf '%s' '<license_file 값>' | sudo install -m 0644 -o root -g root /dev/stdin /etc/plem/license.key

기기 키를 재발급하기 전에 확인하세요.

  • 재발급하면 이 기기의 옛 키는 즉시 폐기됩니다. 백업 등 다른 곳에 있는 사본도 쓸 수 없게 됩니다. 살아 있는 사본이 있으면 재발급하지 마세요.
  • 기기에 라이선스와 등록 정보(/etc/plem/depot.json)가 남아 있어야 합니다. 없으면 명령이 무엇을 해야 하는지 알려 줍니다.
  • 키 파일이 아직 있으면 아무것도 바꾸지 않고 거부합니다. 파일이 손상됐다면 지운 뒤 다시 실행하세요.

제거와 재설치​

패키지만 갱신하려면 제거하지 말고 plem update 를 쓰세요. plem uninstall 은 기본으로 라이선스와 기기 키까지 지우므로, 실행하기 전에 plem uninstall을 읽으세요. 라이선스 파일은 이 기기의 식별자로 서명돼 있어 다른 기기에 복사해 쓸 수 없습니다.

원격 지원을 받고 싶다​

기기에서 다음을 실행하면 지원 엔지니어가 접속할 수 있는 임시 통로가 열립니다. 명령을 끝내면(Ctrl+C) 통로도 함께 닫힙니다.

plem remote

지원을 요청할 때​

문의는 william@wimcorp.co.kr 메일로 보내 주세요. 로봇이 일하는 중에 처음 보는 메시지가 뜨면 먼저 로봇을 멈추고(필요하면 비상 정지) 알려 주세요.

TUI·로봇 스택의 로그는 ~/.plem/log 에 있습니다. 이 폴더를 묶어 함께 보내면 진단이 빨라집니다.

tar czf plem-log.tar.gz -C ~/.plem log
로그위치
TUI (조작·기동·정지·로봇 이벤트)~/.plem/log/plem_tui_<시각>.log (plem 을 켤 때마다 새 파일)
로봇 스택 (launch·노드·서버 출력)~/.plem/log/<시각>/ (로봇 스택을 기동할 때마다 새 폴더)

두 종류 모두 가장 최근 20개만 남고, 그보다 오래된 것은 다음 실행 때 지워집니다. 문제가 난 기동의 로그가 지워지기 전에 보내 주세요.

여기에 plem version 결과와 어떤 조작에서 문제가 났는지를 덧붙여 주세요.