이 문서에서는 SWIM 트러블슈팅에 대해 설명하며, 실제적인 확인, 명확한 복구 단계, 에스컬레이션 전에 확인해야 할 정보 등을 제공합니다.
이 문서에서 CatC는 Cisco Catalyst Center(CatC)를 의미하며 SWIM은 SWIM(Software Image Management)을 의미합니다.
변경하기 전에 콘솔 또는 관리 액세스를 사용할 수 있는지, 대상 이미지가 올바른지, 백업 경로가 있는지, 디바이스에서 다른 설치 작업을 아직 실행하고 있지 않은지, 변경 사항이 승인되었는지 확인하십시오.
GUI는 CLI 또는 데이터베이스 검사로 이동하기 전에 유용한 컨텍스트를 제공합니다.
이 검토는 이미지 배포 또는 활성화 문제 해결 전에 첫 번째 확인 중 하나여야 합니다.

권장 TAC 검토 흐름:

TAC에서 검증하는 내용:
이 단계가 중요한 이유: 이 단계는 이미지 선택 오류를 조기에 포착하는 데 도움이 됩니다. 또한 컴플라이언스, 라이프사이클 조정 또는 보안 권고에 따른 업그레이드 여부도 설명할 수 있습니다.
FIPS 모드가 활성화된 경우, URL 기반 이미지 가져오기는 플랫폼 보안 제어에 의해 제한되어야 합니다. 이러한 경우 Cisco.com 또는 로컬 파일 업로드와 같이 지원되는 가져오기 방법을 사용한 다음 가져오기 후에 이미지 메타데이터 및 체크섬이 올바르게 채워졌는지 확인합니다.
![]() |
![]() |

원격 배포 서버가 System > Settings > Device Settings > Image Distribution Servers 아래에 구성되어 있는 경우 케이스 처음부터 분석에 포함하십시오. 이는 전송 방법, 전송 타이밍, 스테이징 동작 및 이미지 배포 중 실제 실패 지점에 영향을 줄 수 있습니다.

TAC에서 확인하는 내용:
중요한 이유:
원격 배포 서버를 사용하는 경우 이미지 경로는 더 이상 단순한 컨트롤러 간 전송이 아닙니다. 디바이스 자체보다는 외부 서버, 프로토콜 기본 설정, 연결 가능성, 이미지 스테이징 또는 서버측 가용성에 의해 장애가 발생합니다.
권장 TAC 검증 흐름:
일반적인 TAC 문제:
심층적인 트러블슈팅 전에 다음 정보를 수집합니다.
권장 TAC 수집 순서:
중요한 이유: 이러한 정보를 조기에 수집하면 에스컬레이션 과정에서 앞뒤가 바뀌는 일이 줄어들며, TAC에서 문제가 이미지 선택, 작업 오케스트레이션, 플랫폼 호환성 또는 디바이스 상태와 관련이 있는지를 파악하는 데 도움이 됩니다.
GUI에서 다음 항목을 확인합니다.
권장 TAC 검증 순서:
중요한 이유: 이러한 검사는 TAC에서 이미지 선택, 할당, 컨트롤러 작업 처리, 인벤토리 동기화 또는 디바이스 자체로 인해 발생한 문제인지 여부를 확인하는 데 도움이 됩니다.
플랫폼 및 소프트웨어 모드에 맞는 명령만 실행합니다.
이러한 설치 관련 명령은 SWIM 업그레이드 분석 시 특히 유용합니다. 이러한 how tech installcommand는 설치 프로세스에 대한 광범위한 기술 스냅샷을 제공하며 일반적으로 검토 또는 에스컬레이션을 위해 전반적인 설치 관련 증거를 수집하는 데 사용됩니다. show platform software install-manager switch X R0 operation history detailcommand는 특정 스택 멤버에 대한 install-manager 작업의 세부 기록을 보여주며 어떤 단계가 완료되었고 어디에서 프로세스가 실패했는지 확인하는 데 도움이 됩니다. show platform software install-manager switch X R0 operation current detailcommand는 해당 스위치의 라이브 설치 상태를 표시하며, 업그레이드가 중지되었거나 아직 실행 중인 경우 유용합니다. 요청 플랫폼 소프트웨어 추적 아카이브 명령은 심층 분석을 위해 플랫폼 소프트웨어 추적 데이터를 수집하는 반면, 요청 플랫폼 소프트웨어 추적 슬롯 스위치 X 아카이브 명령은 특정 스택 멤버에 대해 동일한 추적 데이터를 수집합니다. 이러한 명령을 함께 사용하면 설치 중에 발생한 일, 현재 진행 중인 일, 추가 분석을 위해 수집해야 할 증거 등을 파악할 수 있습니다.
show tech install
show platform software install-manager switch X R0 operation history detail(stack)
show platform software install-manager switch X R0 operation current detail(stack)
플랫폼 소프트웨어 추적 아카이브 요청
요청 플랫폼 소프트웨어 추적 슬롯 스위치 X 아카이브(스택)
show version
인벤토리 표시
show platform
show boot
show running-config | 부트 시스템 포함
startup-config 표시 | 부트 시스템 포함
파일 시스템 표시
dir 플래시:
dir bootflash:
이 명령을 사용하여 현재 버전, 부팅 설정 및 사용 가능한 스토리지를 확인합니다.
설치 요약 표시
show install active(활성 설치 표시)
show install committed
설치 로그 세부 정보 표시
설치 요청 표시
이 명령은 이전 설치가 여전히 실행 중인지, 완료되지 않았는지 또는 커밋되지 않았는지 확인하는 데 도움이 됩니다.
로깅 표시
로깅 표시 | INSTALL|INSTALL|BOOT|ERROR|FAIL|ROMMON 포함
show archive log config all
다시 로드 표시
show tech-support
쇼 스위치
스위치 세부 정보 표시
이중화 표시
show platform software status control-processor 개요
플랫폼 소프트웨어 패키지 상태 표시
ping <게이트웨이 또는 관리 피어>
show ip interface brief
인터페이스 상태 표시
show processes cpu sorted | 0.00 제외
show processes memory sorted
파일 시스템 표시
dir 플래시:
dir bootflash:
로깅 표시 | 포함 SCP|SFTP|HTTP|TFTP|복사|전송|플래시
show processes cpu sorted | 0.00 제외
사용 가능한 공간이 충분한지 확인하고, 관리 경로가 안정적인지 확인하고, 사용 중이 아닌지 확인한 후에만 이전 파일을 제거합니다.
GUI 작업: 실패한 작업을 열고, 디바이스가 여전히 관리되는지 확인하고, 이미지가 저장소에 있는지 확인하고, 원격 배포 서버가 사용 중인지 확인하고, 스토리지, 자격 증명 및 전송 경로가 정상인 경우에만 다시 시도하십시오.
show version
show boot
show running-config | 부트 시스템 포함
startup-config 표시 | 부트 시스템 포함
설치 요약 표시
부팅 변수가 여전히 이전 이미지를 가리키는지 확인합니다. 필요한 경우 부팅 경로를 수정한 다음 다시 로드하기 전에 컨피그레이션을 저장합니다.
terminalno boot system 구성boot system flash:<target-image.bin>endwrite memoryshow boot
GUI 작업: 작업 일정을 검토하고, 다시 로드한 후 디바이스가 다시 돌아왔는지 확인하고, GUI 버전이 오래된 경우 인벤토리 동기화를 실행하고, 다시 시도하기 전에 활성화 확인 및 정리 설정을 확인합니다.
설치 요약 표시
show install active(활성 설치 표시)
show install committed
설치 로그 세부 정보 표시
로깅 표시 | 설치 포함|설치
패키지가 이미 활성 상태이지만 커밋되지 않았는지 확인합니다. 현재 상태를 이해할 때까지 다른 설치를 시작하지 마십시오.
install commit
먼저 정상 작동이 확인된 이미지를 로컬에서 계속 사용할 수 있는지 확인하고 해당 플랫폼에 대해 승인된 ROMMON 복구 방법을 사용합니다.
dir 플래시:
부트 플래시:<known-good-image.bin>
show version
show boot
configure terminal
no boot system
부트 시스템 플래시:<known-good-image.bin>
끝
write memory
쇼 스위치
스위치 세부 정보 표시
show version
dir 플래시:
설치 요약 표시
로깅 표시 | 포함 스위치|버전|설치
모든 멤버가 있는지 확인하고, 모든 멤버의 이미지 가용성을 확인한 후 전체 스택이 정상인 경우에만 다시 시도하십시오.
show version
인벤토리 표시
show running-config | 부트 시스템 포함
디바이스 버전이 올바르면 업그레이드가 실패한 것으로 간주하기 전에 오래된 인벤토리 또는 규정 준수 데이터가 의심됩니다.
GUI 작업: 장치 레코드를 새로 고치고, 규정 준수를 다시 실행하고, 골든 이미지 매핑이 여전히 올바른지 확인하고, 작업 기록을 검토하여 예상 대상 버전을 확인합니다.
dir 플래시:
dir bootflash:
delete /force flash:<unused-image.bin>
delete /force /recursive flash:<unused-package-directory>
show boot
configure terminal
no boot system
부트 시스템 플래시:<target-image.bin>
끝
write memory
show boot
reload
설치 요약 표시
install commit
show install committed
show version
show boot
설치 요약 표시
로깅 표시 | 꼬리
show ip interface brief
13. TAC 워크플로
기본 GUI 및 CLI 확인 후 이 워크플로를 사용합니다. 이를 실시간 TAC 사례의 작업 시퀀스로 처리합니다.
목표: 문제가 Catalyst Center에서 시작되었는지, 전송 경로에서 시작되었는지 아니면 디바이스에서 시작되었는지를 결정합니다.
작업 검사: 작업 세부 정보, 타임스탬프, 인벤토리 상태 및 디바이스 연결성을 검토합니다. 컨트롤러측 장애는 전송 장애와 디바이스측 장애로부터 가능한 한 일찍 분리됩니다.
결정: 이미지가 디바이스에 도달하기 전에 작업이 실패한 경우 인벤토리, 자격 증명, 저장소 상태 및 전송 경로에 계속 집중합니다. 이미지가 복사되었지만 활성화가 실패한 경우 부트 변수, 설치 상태 및 디바이스 로그로 이동합니다.
목표: 완전한 실패 타임라인을 구축합니다.
캡처: 정확한 GUI 오류 텍스트, 작업 ID, 실패 타임스탬프 및 하위 작업 세부 정보(있는 경우)를 기록합니다.
이 점이 중요한 이유: 데이터는 GUI 이벤트를 디바이스 로그, SWIM 로그 및 데이터베이스 레코드와 일치시켜야 합니다.
목표: 단일 디바이스 문제인지 아니면 더 광범위한 플랫폼 문제인지 결정합니다.
확인: 문제가 환경 전체에서 하나의 디바이스, 하나의 스택, 하나의 사이트, 하나의 플랫폼 제품군 또는 여러 디바이스에 영향을 미치는지 확인합니다.
결정: 여러 디바이스에서 동일한 장애가 나타나는 경우, 한 디바이스를 비난하기 전에 의심스러운 이미지 품질, 플랫폼 호환성, 저장소 상태, 자격 증명 또는 컨트롤러측 작업 처리 등이 있습니다.
목표: 성공적으로 완료된 마지막 단계를 찾습니다.
트랙: 이미지 가져오기, 할당, 배포, 활성화, 다시 로드 및 업그레이드 후 동기화를 통해 워크플로를 진행합니다.
중요한 이유: 따라서 이미 작동했던 단계를 반복할 필요가 없으며 실제 장애 지점에 집중할 수 있습니다.
목표: 전송 단계가 실제로 완료되었는지 확인합니다.
검사: 이미지가 플래시에 있는지 확인합니다. 또는 bootflash: 사용 가능한 공간이 충분한지, 파일이 완전한지, 이미지가 원하는 플랫폼과 일치하는지 확인합니다.
결정: 이미지가 없는 경우 전송 트러블슈팅을 계속 진행합니다. 이미지가 있는 경우 활성화, 부팅 선택, 패키지 상태 또는 업그레이드 후 검증으로 전환합니다.
목표: 타임라인의 정확한 지점에 오류를 배치합니다.
분류: 이 문제를 다음 시점 중 하나로 분할하십시오. 다시 로드 전, 다시 로드 중 또는 다시 로드 후.
결정: 다시 로드하기 전에 오류가 발생한 경우 설치 로직, 부팅 설정 및 작업 오케스트레이션에 중점을 둡니다. 다시 로드하는 동안 오류가 발생한 경우 콘솔 출력, 다시 로드 이유 및 부팅 동작을 확인합니다. 다시 로드 후 발생한 경우 재검색, 규정 준수 동기화, 스택 상태 및 서비스 복구에 중점을 둡니다.
목표: 다시 실행하기 전에 디바이스가 안정적인지 확인하십시오.
확인: 소프트웨어 모드를 이해하고, 부팅 변수가 올바르고, 스토리지가 정상적이며, 설치 상태가 완전하지 않고, 스택 또는 HA 상태가 정상이고, 이전 설치 작업이 아직 활성 상태가 아닌지 확인합니다.
종료 기준: 이러한 검사가 모두 명확하거나 작업을 계속해야 할 이유가 문서화될 때까지 다시 시도하지 마십시오.
목표: 케이스를 계속 진행하면서 위험 감소
다음으로 시작: 인벤토리 새로 고침, 컴플라이언스 재실행, 로그 검토, 부팅 변수 수정, 활성화가 이미 성공한 경우 패키지 커밋
지침: 정상 검사에서 작업이 오래된 것으로 표시되어 있고 해당 장치가 워크플로에서 더 이상 활성 상태가 아닌 경우에만 데이터베이스 업데이트나 강제 정리를 진행하십시오.
목표: 다음 시도 전에 명확한 결정 지점을 설정합니다.
다음 경우에만 다시 시도: 현재 문제가 이해되고, 디바이스가 정상이며, 충돌하는 작업이 아직 열려 있지 않으며, 이미지와 할당이 올바르고, 복구 변경 사항이 저장되고 검증되었습니다.
결정: 이러한 조건이 충족되지 않으면 재시도 경로를 중지하고 이미 수집한 증거로 에스컬레이션합니다.
show version
show boot
show install summary
show install log detail
show logging
show switch
show redundancy
dir flash:
dir bootflash:
| 개정 | 게시 날짜 | 의견 |
|---|---|---|
1.0 |
17-Jun-2026
|
최초 릴리스 |