문제 해결
증상에서 시작하세요.
| 증상 | 할 일 |
|---|---|
| Start session 화면의 로봇 목록이 비어 있다 | 납품 시 설정된 프로필이 보이지 않는 상태입니다. 지원팀에 문의하세요. 화면 설명은 기동 구성에 있습니다 |
s 를 눌렀는데 스택이 안 뜬다 | 로봇 스택 기동 |
plem 을 켜자마자 로봇 스택과 서버가 error creating node 로 멈춘다 | plem update 로 최신 버전을 받으세요. 설치·업데이트가 ROS 2 통신에 필요한 커널 수신 버퍼 설정을 깔고 바로 적용합니다. 업데이트 중 could not apply net. 경고가 나왔다면 sudo sysctl --system 을 실행하거나 재부팅하세요 |
| 로봇이 보호 정지로 멈춰 움직이지 않는다 | 쓰고 있는 도구에서 복구하세요. TUI 화면은 정지와 복구, Teaching Pendant 화면은 보호 정지 풀기에 있습니다. 멈춘 이유와 ROS 2 클라이언트가 지킬 규칙은 정지·안전에 있습니다 |
브레이크 해제가 거부되고 로그에 [RT] SLAVE_ 이 뜬다 | 기동 직후라면 잠시 뒤 다시 해제해 보세요. 계속되면 sudo dmesg | grep -i ethercat 의 출력과 함께 지원팀에 문의하세요 |
| 드라이브가 Quick stop 등으로 멈춘 채 풀리지 않는다 | PLEM 명령 중에는 이를 푸는 명령이 없습니다. 스택을 끄기 전에 로봇이 실제로 멈췄는지 눈으로 확인하세요. 정지·안전 참조 |
웹 화면(:8080)이 안 열린다 | 웹 화면이 안 열린다 |
| 카메라 영상이 없다 | ZED X Mini 카메라가 잡히지 않는다 |
터미널의 ros2 topic list 에 로봇이 안 보인다 | ros2 에서 로봇이 보이지 않는다 |
| 펜던트·Lab 대신 PLEM is locked 페이지가 뜬다, 또는 토큰이 거부된다 | 라이선스·토큰 오류 |
| 라이선스 파일이나 plem code 기기 키를 잃었다 | 라이선스·키를 잃었을 때 |
plem 이 ros_ 오류를 보이며 시작하지 않는다 | ~/. 의 ros_ 를 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_ 로 지정한 브라우저가 있어야 합니다 |
모두 맞는데 안 열리면 웹 브릿지만 빠졌을 가능성이 큽니다. 기동 로그에 브릿지 관련 경고가 있으면 나머지 스택이 정상이어도 웹 화면만 안 뜹니다. 스택을 내리고 다시 기동하세요.
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_ 이 있으면 sudo /usr/ 를 한 번 실행하세요. apt 로 직접 업그레이드한 기기에만 필요합니다. plem update 로 업데이트했다면 이미 적용돼 있습니다.
ros2 에서 로봇이 보이지 않는다
- 업데이트한 뒤 처음이라면 새 터미널에서
ros2 daemon stop을 한 번 실행하세요. 이전 설정을 기억하는ros2데몬이 남아 있으면 로봇이 보이지 않습니다. ~/.등에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_ 를 열지 못함 | sudo apt install --reinstall plem-core 로 다시 설치하세요 |
libethercat. 을 열지 못함 | IgH EtherCAT 마스터가 설치돼 있지 않습니다. 지원팀에 문의하세요 |
그 밖의 이름의 라이브러리(*.)를 열지 못함 | 그 파일을 제공하는 패키지를 확인하세요 |
| 라이브러리 이름 없이 비정상 종료·시간 초과 | 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/)와 등록 정보(/etc/)가 새 것으로 바뀝니다. 다시 등록하기 전에 지금 등록처가 어디인지 담당자에게 확인하세요.
라이선스·키를 잃었을 때
/etc/ 아래 파일은 직접 고치지 마세요.
| 잃은 것 | 할 일 |
|---|---|
라이선스 파일(/etc/) | 담당자에게 이 기기의 라이선스 재발급을 요청하세요. 등록 해제는 필요 없습니다. 다시 등록해도 복구되지 않습니다. 이미 등록된 기기라 등록이 거부됩니다(plem-register 종료 코드 16). 재발급은 Depot 쪽에 저장된 만료일로 다시 서명하므로, 등록이 이미 만료됐다면 연장이 필요합니다 |
plem code 기기 키(/etc/) | 기기에서 sudo plem-register --reissue-plem-key 를 실행하세요. 아래 주의를 먼저 보세요 |
재발급된 값(license_)을 받았다면 디코드하지 말고 다음 한 줄로 설치한 뒤 로봇 스택을 다시 시작하세요. 파일 모드가 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·로봇 스택의 로그는 ~/. 에 있습니다. 이 폴더를 묶어 함께 보내면 진단이 빨라집니다.
tar czf plem-log.tar.gz -C ~/.plem log
| 로그 | 위치 |
|---|---|
| TUI (조작·기동·정지·로봇 이벤트) | ~/. (plem 을 켤 때마다 새 파일) |
| 로봇 스택 (launch·노드·서버 출력) | ~/. (로봇 스택을 기동할 때마다 새 폴더) |
두 종류 모두 가장 최근 20개만 남고, 그보다 오래된 것은 다음 실행 때 지워집니다. 문제가 난 기동의 로그가 지워지기 전에 보내 주세요.
여기에 plem version 결과와 어떤 조작에서 문제가 났는지를 덧붙여 주세요.