---
title: 업데이트 오류
description: NexCMP 업데이트 실패 원인(권한, 다운로드 검증, 서명, 재시작) 및 복구 또는 롤백 방법.
url: https://nexcmp.com/ko/docs/troubleshooting/update-errors/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# 업데이트 오류 {#update-errors}

> **관리자 위치:** System › Admin › License & updates (`/license`)

업데이트는 [NexCMP 업데이트](https://nexcmp.com/ko/docs/getting-started/updating/)에 설명되어 있습니다. 업데이트 카드 또는 `sudo nexcmp update`에서 오류가 보고되는 경우:

| 메시지 | 원인 | 해결 방법 |
|---|---|---|
| `update plan expired — renew on the license page to receive this feature release` | 업데이트 지원 기한이 릴리스 날짜보다 이전입니다. 보안 수정 사항은 계속 제공되지만 기능 릴리스는 제공되지 않습니다 | [nexcmp.com/licenses](https://nexcmp.com/licenses)(NexCMP Free의 경우 연간 $99)에서 갱신한 후 다시 확인하세요. 그동안 소프트웨어는 계속 실행됩니다. |
| `sha256 mismatch (downloaded …, expected …)` | 손상되었거나 변조된 다운로드 | 다시 시도하세요. 계속되면 경로상의 프록시를 확인하세요. |
| `downgrade/same version rejected: X is not newer than Y` | 선택한 버전이 현재 실행 중인 버전보다 최신이 아님 | 수행할 작업 없음 — 최신 버전 상태입니다. |
| `extraction failed / main binary missing` | 손상된 아카이브 또는 디스크 용량 부족 | `df -h`을(를) 확인하고 다시 시도하세요. |
| `systemctl restart failed` | 바이너리를 교체한 후 서비스를 다시 시작하지 못함 | `journalctl -u nexcmp -n 80`; 이전 바이너리는 `/opt/nexcmp/bin/nexcmp.bak`(으)로 유지됩니다. 아래의 롤백을 참조하세요. |
| 업데이트 서버 통신 중 서버 오류 발생 | `nexcmp.com`에 대한 경로가 없거나 라이선스 토큰이 만료됨 | 아웃바운드 HTTPS를 확인하고 라이선스 카드의 **Check now**를 클릭하세요. |

## 롤백 {#roll-back}

새 버전에 문제가 발생하는 경우:

```bash
sudo systemctl stop nexcmp-vmd nexcmp
sudo cp /opt/nexcmp/bin/nexcmp.bak /opt/nexcmp/bin/nexcmp
echo <previous-version> | sudo tee /opt/nexcmp/VERSION
sudo systemctl start nexcmp nexcmp-vmd
```

데이터베이스 마이그레이션이 이미 실행된 경우, 업데이트 전에 수행한 [백업](https://nexcmp.com/ko/docs/getting-started/backup-and-restore/)도 함께 복원하세요.

## `sudo nexcmp update`에서 설치 프로그램을 찾을 수 없다고 표시됨 {#sudo-nexcmp-update-says-it-cannot-find-the-installer}

`nexcmp update`은(는) 설치된 릴리스 내부에 포함된 설치 프로그램(`/opt/nexcmp/releases/<version>/share/install.sh`)을 실행합니다. 해당 파일이 누락된 경우 라이선스 페이지에서 설치 명령을 다시 실행하세요.