본문으로 건너뛰기

업데이트

새 버전이 나왔는지 아는 법​

새 버전은 두 곳에서 알려 줍니다.

  • plem 을 실행할 때 새 버전이 있으면 지금 업데이트할지 묻습니다. n 을 누르거나 그대로 두면 평소대로 Start session 화면으로 넘어갑니다.
  • TUI 화면 맨 위 줄의 버전 표시 옆에 새 버전이 함께 뜹니다.

두 곳 모두 조회에 실패하면 아무 표시 없이 넘어가므로, 알림이 없어도 최신이 아닐 수 있습니다.

지금 버전은 plem version 으로 확인하세요. X.Y.Z 형식으로 나옵니다.

업데이트하기​

로봇 스택을 먼저 내리세요. 실행 중인 세션이 있으면 업데이트가 시작되지 않습니다. TUI 화면을 정상 종료하고, 남은 프로세스가 있으면 plem kill 로 정리하세요.

plem update

plem update 는 다음 순서로 진행합니다.

  1. 최신 업데이트 절차를 받아 그 절차로 진행합니다. 인터넷 연결이 없는 등의 이유로 받지 못하면 기기에 설치된 절차로 계속합니다. 최신 절차를 쓰므로 여러 버전을 건너뛰어도 그 사이에 추가된 단계를 모두 거칩니다.
  2. 실행 중인 세션이 없는지 확인합니다.
  3. 설치된 버전과 새 버전을 보여 주고 계속할지 묻습니다.
  4. 패키지를 설치합니다. 더 이상 쓰이지 않게 된 패키지가 있으면 이름과 정리 명령을 알려 주고, 자동으로 지우지는 않습니다.
  5. 운영 계정을 realtime(실시간 제어)·plem(자격증명) 그룹에 넣습니다. 이미 들어 있으면 넘어갑니다.
  6. JetPack 6 기기에서는 충돌 회피 구성 요소(cuMotion)에 빠진 것이 있으면 채웁니다.
  7. 기기의 로봇 모델이 등록 정보와 다르면 승인을 받아 맞춥니다.

끝나면 plem 으로 다시 기동하세요. 업데이트가 스택을 대신 띄워 주지는 않습니다.

0.7.0 이상이 설치된 기기는 중간 버전을 거치지 않고 바로 최신으로 올릴 수 있습니다. 처음 올릴 때 어느 절차로 진행되는지는 설치된 버전에 따라 다릅니다.

설치된 버전처음 올릴 때
0.7.0 미만지원팀에 문의하세요
0.7.x기기에 있던 절차로 진행됩니다. 처음 한 번 멈출 수 있으며, 그때는 구성 요소를 지워야 한다며 멈추면을 보세요
0.8.0 ~ 0.9.0기기에 있던 절차로 진행됩니다
0.9.0보다 새 버전최신 절차를 받아 진행합니다
업데이트는 데이터를 백업하지 않습니다

업데이트는 ~/.plem 아래 데이터를 백업하지도, 되돌리지도 않습니다. 남겨야 할 데이터가 있으면 업데이트 전에 직접 복사해 두세요.

401로 멈추면​

plem update 가 패키지 목록을 받다가 401로 멈추면 이 기기의 토큰이 폐기됐거나 라이선스가 만료된 것입니다. 경우별 조치는 문제 해결 › 토큰 거부에 있습니다.

구성 요소를 지워야 한다며 멈추면​

업데이트 중에 설치된 구성 요소를 지워야 할 때가 있습니다. 새 버전이 그 구성 요소를 폐지한다고 선언한 경우에만 지우고 진행합니다. 선언되지 않은 구성 요소를 지워야 하면 아무것도 바꾸지 않고 멈춥니다.

0.7.x 기기에 있던 옛 절차는 이 판단을 하지 못해, 폐지된 구성 요소가 있어도 멈춥니다. 이때는 최신 절차를 한 번만 직접 실행하세요. 그다음부터는 plem update 가 정상 동작합니다.

curl -fsSL https://depot.wimcorp.dev/jetson/update.sh | sudo bash

최신 절차로도 같은 안내가 나오면 지원팀에 문의하세요.

다른 패키지 작업 중이라며 멈추면​

자동 업데이트 같은 다른 패키지 작업이 실행 중이면 패키지 설치 단계는 최대 5분 기다립니다. 패키지 목록을 받는 단계는 기다리지 않고 Could not get lock 으로 멈춥니다. 잠시 뒤 다시 실행하세요.

업데이트한 뒤​

  1. 다시 로그인하세요. 업데이트가 운영 계정을 realtime·plem 그룹에 새로 넣었다면 다시 로그인하거나 재부팅해야 적용됩니다. id -nG 로 확인할 수 있습니다.
  2. 새 터미널에서 ros2 daemon stop 을 한 번 실행하세요. 이미 떠 있던 ros2 데몬이 예전 통신 설정을 기억하고 있을 수 있습니다. 다음 ros2 명령이 새 설정으로 데몬을 다시 띄웁니다.
  3. ~/.bashrc 등에 ROS_DOMAIN_ID·CYCLONEDDS_URI·RMW_IMPLEMENTATION 을 export 해 두었다면 지우세요. plem 은 그 값을 읽지 않고, 새 터미널에 같은 값을 넣어 줍니다. 남겨 두면 그 셸의 ros2 만 로봇과 갈라집니다. 도메인은 TUI 설정(,)에서 바꿉니다.
  4. 변경 이력의 호환성 주의 항목을 확인하세요. 외부 프로그램이나 설정을 고쳐야 하는 변경이 거기 모여 있습니다.

알아 둘 것​

원격 ROS 2 클라이언트를 쓴다면​

기기의 ROS 2 통신은 기본적으로 기기 안에서만 열립니다. PLEM_CYCLONEDDS_SYSTEM_DEFAULT=off 는 이제 읽히지 않습니다. 다른 컴퓨터에서 접속하려면 ROS 2 인터페이스를 따르세요.

라이선스는 다시 발급받지 않아도 됩니다​

라이선스 검증은 소프트웨어 버전을 보지 않습니다. 만료된 경우는 401로 멈추면을 보세요.

커스텀 토크 컨트롤러를 쓴다면​

플러그인 인터페이스(C-ABI)의 메이저 버전이 그대로면 이미 빌드한 플러그인은 그대로 동작합니다. 다만 다시 빌드할 때 소스를 고쳐야 할 수 있으니, 업데이트 전에 변경 이력의 「개발자 SDK」 항목을 확인하세요. PLEM 메이저 버전이 올라가는 업데이트에서는 알림이 플러그인 재빌드 가능성도 함께 알려 줍니다.

되돌리기는 지원하지 않습니다​

이전 버전으로 내리거나 업데이트를 되돌리는 기능은 없습니다. 업데이트 후 문제가 있으면 지원팀에 문의하세요. plem uninstall --keep-license 로 제거한 뒤 다시 설치해 복구할 수도 있습니다. 이미 등록된 기기이므로 남겨 둔 라이선스를 그대로 씁니다.