마이그레이션 문제 해결

Secure Firewall 마이그레이션 툴 문제 해결

마이그레이션은 일반적으로 ASA 컨피그레이션 파일을 업로드하는 동안이나 마이그레이션된 컨피그레이션을 Firewall Management Center에 푸시하는 동안 실패합니다.

마이그레이션 프로세스가 실패하는 몇 가지 일반적인 시나리오는 다음과 같습니다.

  • ASA 컨피그레이션 파일의 알 수 없는 문자 또는 잘못된 문자

  • ASA 컨피그레이션 파일의 불완전하거나 누락된 요소

  • 네트워크 연결 끊김 또는 레이턴시

Secure Firewall 마이그레이션 툴 지원 번들

Secure Firewall 마이그레이션 툴은 로그 파일, DB, 구성 파일과 같은 중요한 문제 해결 정보를 추출하도록 지원 번들을 다운로드하는 옵션을 제공합니다. 다음을 수행하십시오.

  1. Complete Migration(마이그레이션 완료) 화면에서 Support(지원) 버튼을 클릭합니다.

    도움말 지원 페이지가 나타납니다.

  2. Support Bundle(지원 번들) 체크 박스를 선택한 다음 다운로드할 컨피그레이션 파일을 선택합니다.


    참고
    로그 및 dB 파일은 기본적으로 다운로드하도록 선택됩니다.

  3. Download(다운로드)를 클릭합니다.

    지원 번들 파일은 로컬 경로에 .zip으로 다운로드됩니다. 압축 폴더의 압축을 풀고 로그 파일, DB 및 컨피그레이션 파일을 봅니다.

  4. Email us(이메일 문의)를 클릭하여 기술 팀에 실패 세부 정보를 이메일로 보냅니다.

    다운로드한 지원 파일을 이메일에 첨부할 수도 있습니다.

  5. Visit TAC page(TAC 페이지 방문)를 클릭하여 Cisco 지원 페이지에서 TAC 케이스를 생성합니다.


    참고
    마이그레이션하는 동안 언제라도 지원 페이지에서 TAC 케이스를 열 수 있습니다.

문제 해결에 사용되는 로그 및 기타 파일

다음 파일에서 문제를 식별하고 해결하는 데 유용한 정보를 찾을 수 있습니다.

파일 위치

로그 파일

<migration_tool_folder>\logs

마이그레이션 전 보고서

<migration_tool_folder>\resources

마이그레이션 후 보고서

<migration_tool_folder>\resources

구문 분석되지 않은 파일

<migration_tool_folder>\resources

telemetry_sessionid_timestamp.json

<migration_tool_folder>\resources\telemetry_data

ASA 파일 업로드 실패 문제 해결

ASA 구성 파일이 업로드되지 않는 경우 일반적인 이유는 Secure Firewall 마이그레이션 툴이 파일에서 하나 이상의 라인을 구문 분석할 수 없기 때문입니다.

다음 위치에서 업로드 및 구문 분석 실패를 일으킨 오류에 대한 정보를 찾을 수 있습니다.

  • Secure Firewall 마이그레이션 툴에 의해 표시되는 오류 메시지 - 실패의 원인을 개략적으로 요약하여 제공합니다.

  • Log file(로그 파일) - "error"라는 단어를 검색하여 실패의 원인을 확인합니다.

ASA에 대한 문제 해결 예: 개체 그룹의 멤버를 찾을 수 없음

이 예에서는 파서가 개체 그룹의 멤버 중 하나를 찾을 수 없으므로 ASA 컨피그레이션 파일 업로드 및 구문 분석이 실패했습니다.

프로시저

단계 1

오류 메시지를 검토하여 문제를 식별합니다.

이 실패로 인해 다음 오류 메시지가 생성되었습니다.

Location 오류 메시지

마이그레이션 툴 메시지

해당 없음

마이그레이션 전 보고서의 Configuration Lines with Errors(오류가 있는 컨피그레이션 라인) 섹션

Line#2[ERROR] group-object GROUP1

Line#3[ERROR] group-object GROUP2

Line#1[ERROR] object-group network NOV-SERVERS

로그 파일

[INFO | object_group_mode.py:9491 > Parsing object-group network: [NOV-SERVERS]

[ERROR | object_group_mode.py:1048 ] [GROUP1] group not found when creating object-group network [NOV-SERVERS]

[ERROR | object_group_mode.py:1049 ] no row was found for one()

[ERROR | object_group_mode.py:1048 ] [GROUP2] group not found when creating object-group network [NOV-SERVERS]

[ERROR | object_group_mode.py:1049 ] no row was found for one()

단계 2

ASA 컨피그레이션 파일을 열고 다음과 같이 합니다.

  1. NOV-SERVERS라는 이름으로 개체 그룹을 검색합니다.

    ASA 컨피그레이션 파일에서 NOV-SERVERS에 대한 다음 라인이 표시됩니다.

    object-group network NOV-SERVERS
   group-object GROUP1
   group-object GROUP2

  2. 그룹의 각 멤버를 검색하여 ASA 컨피그레이션 파일에 포함되지 않은 멤버를 식별합니다.

단계 3

오류를 해결하려면 소스 ASA 디바이스에서 ASDM을 사용하여 다음과 같이 합니다.

  1. 개체 그룹에 대해 누락된 멤버를 생성합니다.

  2. 컨피그레이션 파일을 내보냅니다.

단계 4

오류가 더 이상 없으면 새 ASA 구성 파일을 Secure Firewall 마이그레이션 툴에 업로드하고 마이그레이션을 계속합니다.

ASA에 대한 문제 해결 예: 목록 인덱스 범위를 벗어남

이 예에서는 Secure Firewall 마이그레이션 툴이 지원하지 않는 요소의 컨피그레이션 오류로 인해 ASA 컨피그레이션 파일 업로드 및 구문 분석이 실패했습니다.

프로시저

단계 1

오류 메시지를 검토하여 문제를 식별합니다.

이 실패로 인해 다음 오류 메시지가 생성되었습니다.

Location 오류 메시지

마이그레이션 툴 메시지

list index out of range

마이그레이션 전 보고서의 Configuration Lines with Errors(오류가 있는 컨피그레이션 라인) 섹션

해당 없음

로그 파일

[ERROR | asa_config_upload.py:119] > list index out of range

단계 2

구문 분석되지 않은 파일을 열고 맨 아래로 스크롤하여 성공적으로 구문 분석된 ASA 컨피그레이션 파일의 마지막 라인을 식별합니다.

이 예에서 구문 분석되지 않은 파일의 마지막 라인은 다음과 같습니다.

Line#345 [SKIPPED] address 209.165.200.224 255.255.255.224

단계 3

ASA 컨피그레이션 파일을 열고 다음과 같이 합니다.

  1. address 209.165.200.224 255.255.255.224를 찾습니다.

    이 라인 다음에 오는 라인에 문제를 일으킨 컨피그레이션 요소가 포함되어 있습니다.

  2. 해당 라인을 검토하여 마이그레이션이 실패한 원인을 확인합니다.

    이 예에서 Secure Firewall 마이그레이션 툴이 구문 분석을 중지한 라인은 name www.example.s3.amazonaws.com입니다. 이는 구문 분석되지 않은 파일의 마지막 라인 바로 뒤에 있는 ASA 컨피그레이션 파일의 라인입니다. 이 라인에서 문제를 식별할 수 없는 경우, Secure Firewall 마이그레이션 툴 릴리즈 노트에서 알려진 문제 섹션을 검토하여 릴리스에서 알려진 문제 중 하나가 발생했는지 확인하는 것이 좋습니다.