# 엔드포인트 업그레이드 패키지 관리

Canonical: https://www.nsecsoft.com/ko/docs/ping64-platform/platform/endpoint-lifecycle/endpoint-upgrade/

Language: ko-KR

Updated: 2026-11-15T03:17:17.817649Z

엔드포인트 업그레이드 관리에서는 검증된 패키지를 저장하고, 해당 플랫폼의 기본 버전을 설정하며, 지정한 엔드포인트에 업그레이드 버전을 할당합니다. 패키지 저장, 기본 버전 변경, 대상 할당 및 실제 업그레이드는 서로 다른 단계입니다. 게시 성공만으로 엔드포인트의 업그레이드 완료를 판단할 수 없습니다. 다음 조작 항목은 영어 인터페이스를 기준으로 하며 콘솔 언어가 다르면 표시 이름도 다를 수 있습니다.

## 사전 조건

-   이 페이지는 자체 구축 환경에 적용됩니다. 플랫폼 설정 권한이 있는 최고 관리자 계정을 사용하고 해당 서비스 라이선스를 확인합니다.
-   신뢰할 수 있는 배포 경로에서 대상 플랫폼에 맞는 업그레이드 패키지와 대응 서명 파일을 준비합니다. 화면에서 두 파일을 업로드하고 검증합니다. macOS에는 `.pkg` 패키지와 `.sig` 서명 파일이 필요합니다. 파일 선택기에서는 Windows와 나열된 Linux 플랫폼에 `.cab`, macOS에 `.pkg`를 사용합니다. 파일을 선택할 수 있다는 사실이 검증 통과를 뜻하지는 않습니다.
-   대상 버전, 엔드포인트 플랫폼 및 영향 범위를 정하고 소수의 시험 장치부터 시작합니다. 조직의 변경 절차에 따라 업무 중단, 복구 계획 및 확대 배포 조건을 평가합니다.
-   제공되는 플랫폼과 옵션은 환경, 라이선스 및 플랫폼 조건에 따라 다릅니다. Kylin과 UOS의 표시 여부는 시장 지역에도 영향을 받습니다. 옵션이 표시된다고 모든 장치의 업그레이드 가능성이 검증된 것은 아닙니다.

## 새 패키지 업로드 및 게시

1.  시스템 설정에서 **Endpoint Upgrade**(엔드포인트 업그레이드)을 열고 **New Package**(새 패키지)을 선택합니다.
2.  업로드 및 검증 단계에서 대상 플랫폼, 패키지 및 서명 파일을 선택하고 다음 단계로 이동합니다. 검증이 끝나면 확인된 버전을 검토합니다. 플랫폼이나 파일을 바꾸면 다시 확인하고 검증합니다.
3.  용도에 따라 **Store Only**(저장만), **Set as Default**(기본값으로 설정), **Assign Specific Endpoints**(지정 장치에 할당) 또는 **Default and Assign**(기본값 설정 및 할당)을 선택합니다. 현재 플랫폼과 상황에 맞는 옵션만 표시됩니다.
4.  할당을 선택한 경우 패키지 플랫폼과 일치하는 장치를 하나 이상 선택하고 이름, 플랫폼 및 선택 범위를 확인합니다. 저장만 하거나 기본값만 설정할 때는 장치를 선택하지 않습니다.
5.  확인 단계에서 플랫폼, 버전, 게시 방식 및 대상을 검토하고 **Publish**(게시)를 선택합니다. 목록에서 버전, 기본 상태 및 할당을 확인하고 장치의 실제 버전과 작동 상태를 별도로 확인합니다.

**대상 플랫폼 변경:** 새 패키지 생성 중 플랫폼을 바꾸면 선택한 패키지, 서명 파일, 검증 결과와 대상 단말이 지워지고 게시 방식이 **Store Only**로 초기화됩니다. 변경 후 파일을 다시 선택하고 검증한 다음 게시 방식과 대상을 다시 선택하십시오. 이전 선택이 유지된다고 가정하지 마십시오.

**할당 전 다른 버전 확인:** 선택한 단말에 다른 업그레이드 버전이 이미 할당되어 있으면 이번 할당으로 대상 버전이 현재 버전으로 변경되며 두 할당이 동시에 유지되지 않습니다. 먼저 관련 책임자와 영향을 확인하십시오. 대상 변경은 단말의 업그레이드나 이전 버전 복귀가 실제로 완료되었다는 뜻이 아닙니다.

## 게시 방식

-   **저장만:** 패키지를 저장하며 기본 버전을 변경하거나 장치에 즉시 할당하지 않습니다.
-   **기본값으로 설정:** 플랫폼의 기본 버전을 변경하지만 기존 장치에 업그레이드를 할당하는 것은 아닙니다. Windows와 macOS에서만 선택할 수 있으며 Windows 기본 버전은 이후 생성되는 클라이언트 설치 프로그램에 사용됩니다.
-   **지정 장치에 할당:** 플랫폼이 일치하는 선택 장치에 버전을 할당하며 기본값은 변경하지 않습니다.
-   **기본값 설정 및 할당:** 해당 플랫폼의 기본값을 설정하고 선택 장치에 할당합니다. 저장 후 기본값, 할당 범위 및 실행 결과를 각각 확인합니다.

## 기존 버전의 할당 변경

1.  패키지 목록에서 플랫폼과 버전을 찾고 **Upgrade to This Version**(이 버전으로 업그레이드)을 선택합니다.
2.  게시 방식을 선택하고 현재 선택된 장치를 확인합니다. 계속 할당해야 하는 장치는 유지하고 필요한 장치를 추가하거나 제거합니다.
3.  확인 후 게시하고 목록에서 대상과 기본 상태를 확인합니다. 제출한 목록은 해당 버전의 기존 할당 전체를 대체합니다. 기존 장치의 선택을 해제하면 해당 버전의 할당이 제거되고, 목록을 비우면 해당 버전의 기존 할당이 모두 제거됩니다. 제출 전에 영향을 확인하고 단순 추가로 이해하지 마십시오.

**선택 범위 확인:** 기존 할당을 편집할 때 선택 수에는 해당 버전의 기존 대상이 포함됩니다. 오른쪽 목록은 현재 로드된 단말 트리에서 식별할 수 있는 선택 대상만 표시하며 여러 페이지일 수 있습니다. 모든 페이지를 확인한 뒤에도 수가 다르면 표시되지 않은 기존 대상이 제출에 포함될 수 있습니다. 트리, 플랫폼과 관리 범위를 확인하고 다시 로드하십시오. 전체 범위를 확인할 수 없다면 게시하지 말고 관리자나 지원팀에 문의하십시오.

기존 버전의 기본값과 할당을 함께 변경할 때 두 작업이 각각 완료될 수 있습니다. 실패가 표시되면 아무 변경도 발생하지 않았다고 가정하지 말고 목록에서 두 상태를 확인한 후 재시도를 결정합니다.

## 문제 해결

-   **업로드 또는 검증 실패:** 패키지, 서명, 플랫폼 및 출처가 일치하는지 확인합니다. 서버 검증 설정을 사용할 수 없으면 관리자나 기술 지원에 문의합니다.
-   **검증 결과 만료 또는 버전 중복:** 안내에 따라 다시 업로드하고 검증하거나 목록의 플랫폼과 버전을 확인합니다. 같은 버전을 중복 게시하지 마십시오.
-   **대상 선택 또는 할당 실패:** 장치 플랫폼과 표시 범위, 계정 권한 및 서비스 라이선스를 확인합니다. 새 패키지를 할당하려면 일치하는 장치를 하나 이상 선택해야 합니다.
-   **패키지 삭제 불가:** 기본 버전이나 장치 할당에서 해당 버전을 참조하면 먼저 확인하고 처리합니다. 삭제 전에 영향을 확인하고 직접 복구할 수 있다고 가정하지 마십시오.
-   **게시 후 장치가 업그레이드되지 않음:** 실제 할당, 플랫폼, 연결 상태, 현재 버전 및 장치 실행 결과를 각각 확인합니다. 문제가 계속되면 기술 지원에 문의합니다.