Omada SDN 컨트롤러 CLI 구성 가이드(v5.9.9 이상)

CLI 구성의 본질은 명령어를 통해서 장치들을 구성하는 것입니다. GUI 구성을 보충하는 역할을 하며 CLI 구성은 GUI 구성과 충돌할 수 있습니다.

Omada SDN 컨트롤러는 2가지 유형의 CLI 컨트롤러를 지원합니다. 사이트 CLI와 장치 CLI입니다.

■ 사이트 CLI

사이트 CLI는 CLI 구성을 지원하는 장치들에 대한 일괄 구성을 사이트 상에서 지원합니다.

■ 장치 CLI

장치 CLI는 선택한 장치들의 일괄 구성을 지원합니다.

현재, CLI 구성은 스위치만을 지원합니다. TP-Link 스위치의 CLI 명령어 이해를 위해 CLI 참조 가이드를 참조하세요.

CLI 구성을 사용해야 한다면 사전 주의 사항과 사용자 가이드를 주의 깊에 읽어주세요. 필요 시 TP-Link 기술 지원 팀에 연락할 수 있습니다.

CLI 구성을 적용한 뒤 장치 > 신 결과 로 이동하여 구성 결과를 볼 수 있습니다.

일반적 사전 주의사항

1. GUI 및 CLI 구성은 실제 네트워크 토폴로지와 요구사항에 맞춰 전체적으로 계획되어야 합니다.

2. 기존 GUI 기능들을 구성하기 위한 CLI 사용은 충돌 방지를 위해 권장되지 않습니다.

a. 새로운 장치의 경우 컨트롤러는 GUI, 사이트 CLI, 그리고 장치 CLI 순으로 장치에 구성을 적용합니다. 구성 충돌이 발생하면 마지막에 적용된 구성이 유효합니다.

b. CLI 프로필은 (사이트 CLI 프로필 및 장치 CLI 프로필을 포함) 적용 후 장치에 한 번만 전송됩니다. 신 결과의 "다시 적용"를 클릭하여 전체 구성 적용을 실행하지 않는 한 추가로 전송되지 않습니다.

c. 장치가 펌웨어를 업그레이드 할 때 컨트롤러는 전체 구성을 장치에 GUI, 사이트 CLI, 그리고 장치 CLI 순으로 적용합니다.

d. 이후 구성은 이전 구성을 덮어쓸 수 있기 때문에 같은 기능이 GUI, 사이트 CLI, 및 장치 CLI로 반복적으로 변경 된 경우 다른 장치들의 실행 중인 구성들은 서로 상이할 수 있습니다.

3. Omada 컨트롤러는 장치들의 기존 GUI 및 CLI 구성을 검증하지 않습니다. 새로운 구성을 적용하기 전 기존 구성을 꼭 확인하세요. 그렇지 않으면 구성 적용 후 예상치 못한 결과가 발생할 수 있으며 장치가 오프라인 상태로 될 수도 있습니다.

4. 어느 특정 기능을 구성하기 위해 CLI를 사용해야만 한다면 구성 충돌을 방지하기 위해 GUI를 통한 구성을 동시에 진행하지 않는 것이 좋습니다.

5. 구성 에러 혹은 충돌로 인한 장치들의 컨트롤러부터의 연결 해제를 방지하기 위해서는 VLAN, VLAN 인터페이스, IP 주소, ACL 등을 GUI를 통해 구성하는 것과 CLI를 통한 연관된 구성 변경을 피하는 것이 좋습니다.

반복적인 구성

동일한 기능이 CLI로 여러 번 구성될 시 이전 구성이 덮어쓰일 수 있으며 가장 최근에 적용된 구성이 우선 적용됩니다.

a. 현재 유효한 명령어들을 CLI 구성 뷰 기능인 "실행 중 구성 보기"를 통해서 확인하는 것을 권장합니다.

b. 특정 구성을 취소해야 하는 경우 "no" 명령어를 사용하세요.

c. 특정 구성을 수정해야 하는 경우 새 명령어를 이용하여 구성을 덮어쓸 수 있습니다.

d. 최종 구성을 적용하고 CLI 구성 보기 기능을 통해 기능이 올바르게 구성되었고 적용되었는지 확인하세요.

실행 실패

CLI 명령 실행이 실패하면 오류가 보고되고 후속 명령이 실행됩니다. 오류 메시지를 통해 오류 세부 정보를 볼 수 있으며 이전에 성공적으로 실행된 명령은 취소되지 않습니다. 아래 단계를 따르는 것이 좋습니다.

a. CLI 구성 보기 기능(실행 중 구성 보기)를 이용하여 적용된 명령을 확인하세요. 취소하려면 "no" 명령을 입력하고 장치에 적용할 수 있습니다.

b. 명령 에러를 진단 및 수정하고 CLI 구성을 다시 생성한 뒤 장치에 적용합니다.

명령 수정

CLI를 통해 발행된 명령를 변경해야 하는 경우 아래 단계를 따르세요.

a. CLI 구성 보기 기능(진행 중 구성 보기)를 사용하여 적용된 명령를 확인하고 취소해야 하는 명령을 분류합니다.

b. "no" 명령을 이용하여 구성을 취소하고 장치에 적용합니다.

금지된 명령

1. 아이디 및 패스워드 변경, VLAN 관리, SDM 프로필, 재부팅, 초기화, 업그레이트, 내보내기 및 가져오기의 CLI 명령은 금지되어 있습니다. 다른 명령을 사용할 때에도 컨트롤러 관리에 문제가 생기지 않도록 주의하세요.

2. 장치 CLI는 변수 기능을 지원합니다. 변수 컨텐츠는 많은 제한이 없더라도 예를 들어 CLI 명령어를 입력할 수 있습니다. 그러나 이는 권장되지 않습니다.

1. 사이트 CLI

개요

사이트 CLI는 CLI 구성을 지원하는 모든 장치의 일괄 구성을 사이트에서 명령어를 통해 지원합니다.

구성

1. 설정 > CLI 구성 > 사이트 CLI로 이동

2. 새 사이트 CLI 프로필 생성 을 클릭하여 요구사항에 맞는 CLI 프로필을 생성합니다.

참고:

• #는 구성 모드로의 진입을 나타내는 특수한 명령어 입니다. 별도의 줄에 사용하세요. 같은 줄에서 다른 명령어들을 뒤에 추가하는 경우 해당 명령어들은 무시됩니다.

• 명령어가 !로 시작할 경우 해당 명령어는 무시됩니다.

이름	CLI 프로필의 이름을 입력하세요.
설명	(선택사항) 구분을 위한 설명을 입력하세요.
CLI	명령어들을 직접 입력하세요.
장치에서 CLI 가져오기	CLI 구성을 지원하는 장치를 클릭하고 선택하여 장치의 실행 중인 구성을 가져옵니다.
파일에서 CLI 가져오기	기존의 명령 파일을 클릭하고 선택하여 명령어를 가져옵니다.

3. 저장 을 눌러 프로필을 추가합니다. 새 프로필은 비활성화 상태이며 장치에 적용되지 않습니다.

4. 적용 을 클릭하여 CLI를 적용합니다. 프로필이 활성화 상태로 변하며 사이트에서 CLI 구성을 지원하는 모든 장치에 구성을 적용합니다.

참고:

프로필이 활성화 되면 더 이상 수정이 불가능합니다.

프로필이 성공적으로 장치에 적용되었는지 유효한지 확인하려면 CLI 세부 정보 보기 를 클릭하여 장치 > 신청 결과 페이지의 구성 결과를 봅니다.

참고:

CLI 프로필 삭제는 장치의 기존 구성에는 영향을 주지 않습니다. 기존 구성 삭제를 위해서는 "no" 명령어를 이용하세요.

2. 장치 CLI

개요

장치 CLI는 명령어를 통해 특정 장치의 일괄 구성을 가능하게 합니다.

장치 CLI는 변수를 지원합니다. %x%를 지용하여 x라는 변수를 정의한 다음 스위치마다 다른 값을 설정할 수 있습니다. 컨트롤러가 스위치에 장치 CLI 구성을 적용할 때 자동으로 변수 %x%를 설정한 값으로 수정합니다.

구성

1. 설정 > CLI 구성 > 장치 CLI 로 이동합니다. 새 장치 CLI 프로필 생성 을 클릭하여 CLI 프로필을 요구사항에 맞게 생성합니다.

참고:

• 명령어가 !로 시작할 경우 해당 명령어는 무시됩니다.

이름	CLI 프로필의 이름을 입력하세요.
설명	(선택사항) 분류를 위해 설명을 입력하세요.
CLI	명령어를 직접 입력하세요. CLI 템플릿에서 %xxx%을 입력해서 변수를 정의할 수 있습니다.
장치에서 CLI 가져오기	CLI 구성을 지원하는 장치를 클릭 및 선택하여 실행 중인 구성을 가져옵니다.
파일에서 CLI 가져오기	기존의 명령 파일을 클릭 및 선택하여 명령어를 가져옵니다.