Junos XML 프로토콜 세션 시작
각 Junos XML 프로토콜 세션은 Junos XML 프로토콜 서버와 클라이언트 애플리케이션이 XML 버전과 사용하는 Junos XML 관리 프로토콜 버전을 지정하는 핸드셰이크로 시작됩니다. 각 당사자는 통신이 성공적으로 전달될 수 있는지 여부를 확인하기 위해 이를 사용하여 서로에서 방출되는 버전 정보를 구문 분석합니다. 특히 클라이언트 애플리케이션은 PI와 오프닝 <junoscript> 태그를 내포 <?xml?> 합니다. 다음 섹션에서는 Junos XML 프로토콜 세션을 시작하는 방법에 대해 설명합니다.
<?xml?> PI 방출
클라이언트 애플리케이션은 PI를 내보는 것으로 <?xml?> 시작됩니다.
다음 예와 클라이언트 애플리케이션에서 발신하는 이 태그 요소의 모든 예에서 텍스트에서 논의되는 태그 시퀀스의 부분을 강조하기 위해 굵은 글꼴이 사용됩니다.
<?xml version="version" encoding="encoding"?>
속성은 다음과 같습니다. Junos XML 관리 프로토콜의 현재 버전에서 허용되는 속성 값 목록은 Verifying Software Compatibility를 참조하십시오.
버전—클라이언트 애플리케이션에서 방출되는 태그 요소가 준수되는 XML 버전
인코딩—클라이언트 애플리케이션이 사용하고 이해할 수 있는 표준화된 문자 세트
클라이언트 애플리케이션의 <?xml?> PI version="1.0" 예에서 속성은 애플리케이션이 XML 1.0 사양을 준수하는 태그 요소를 내보낸다는 것을 나타냅니다. 이 속성은 encoding="us-ascii" 클라이언트 애플리케이션이 ANSI(American National Standards Institute)가 표준화한 7비트 ASCII 문자 집합을 사용하고 있음을 나타냅니다. ANSI 표준에 대한 자세한 내용은 http://www.ansi.org/ .
<?xml version="1.0" encoding="us-ascii"?>
애플리케이션이 오프닝 <junoscript> 태그를 내보내기 전에 PI를 방출 <?xml?> 하지 못할 경우, Junos XML 프로토콜 서버는 오류 메시지를 내보내고 세션과 연결을 즉시 닫습니다.
오프닝 <junoscript> 태그 내보내기
클라이언트 애플리케이션은 다음 구문을 가지고 있는 오프닝 <junoscript> 태그를 내뿜습니다.
<junoscript version="version" hostname="hostname" junos:key="key" release="release-code">
속성은 다음과 같습니다. Junos XML 관리 프로토콜의 현재 버전에서 허용되는 속성 값 목록은 Verifying Software Compatibility를 참조하십시오.
version |
(필수) 클라이언트 애플리케이션이 사용하고 있는 Junos XML 관리 프로토콜 버전을 지정합니다. |
hostname |
(선택사항) 클라이언트 애플리케이션이 실행 중인 머신의 이름을 지습니다. 이 정보는 문제 진단 시만 사용됩니다. Junos XML 프로토콜은 신뢰할 수 있는 호스트 관계를 설정하거나 클라이언트 호스트 이름에 따라 Junos XML 프로토콜 서버 동작을 변경하는 지원을 포함하지 않습니다. |
junos:key |
(선택사항) Junos XML 프로토콜 서버가 자식 구성 요소가 상위 요소의 식별자인지 여부를 표시할 것을 요청합니다. 유일한 수용 가능한 가치는 "키"입니다. 자세한 내용은 Junos XML 프로토콜을 사용하여 구성 요소에 대한 식별자 표시기 요청을 참조하십시오. |
release |
(선택사항) 클라이언트 애플리케이션이 설계된 Junos OS 릴리스(그리고 암시적으로 Junos XML API)를 식별합니다. 이 속성의 가치는 클라이언트 애플리케이션이 Junos XML API의 해당 버전을 지원하는 Junos XML 프로토콜 서버와 성공적으로 상호 작용할 수 있음을 나타냅니다. 즉, 클라이언트 애플리케이션이 해당 API의 요청 태그 요소를 내보내어 응답 태그 요소를 구문 분석하는 방법을 알고 있음을 나타냅니다. 애플리케이션에 이 속성을 포함하지 않으면 Junos XML 프로토콜 서버는 지원하는 Junos XML API의 태그 요소를 내보내게 됩니다. 속성의 |
클라이언트 애플리케이션의 오프닝 <junoscript> 태그 version="1.0" 예에서 속성은 Junos XML 프로토콜 버전 1.0을 사용하고 있음을 나타냅니다. 속성은 hostname="client1" 클라이언트 애플리케이션이 client1라는 시스템상에서 실행되고 있음을 나타냅니다1. 이 속성은 release="20.4R1" 스위치, 라우터 또는 보안 디바이스가 Junos OS 릴리스 20.4의 초기 버전을 실행하고 있음을 나타냅니다.
<junoscript version="1.0" hostname="client1" release="20.4R1">
애플리케이션이 오프닝 <junoscript> 태그를 내보내기 전에 PI를 방출 <?xml?> 하지 못하면 Junos XML 프로토콜 서버는 아래와 유사한 오류 메시지를 내보여 세션 및 연결을 즉시 닫습니다.
<rpc-reply>
<xnm:error xmlns="http://xml.juniper.net/xnm/1.1/xnm" \
xmlns:xnm="http://xml.juniper.net/xnm/1.1/xnm">
<message>
communication error while exchanging credentials
</message>
</xnm:error>
</rpc-reply>
<!-- session end at YYYY-MM-DD hh:mm:ss TZ -->
</junoscript>
태그에 대한 <xnm:error> 자세한 내용은 Junos XML 프로토콜 세션의 오류 또는 경고 처리를 참조하십시오.
Junos XML 프로토콜 서버의 <?xml?> PI 구문 분석
Junos XML 프로토콜 세션이 시작되면 Junos XML 프로토콜 서버가 PI 및 오프닝 <junoscript> 태그를 <?xml?> 내보입니다.
PI에 대한 <?xml?> 구문은 다음과 같습니다.
<?xml version="version" encoding="encoding"?>
속성은 다음과 같습니다. Junos XML 관리 프로토콜의 현재 버전에서 허용되는 속성 값 목록은 Verifying Software Compatibility를 참조하십시오.
| 버전 | Junos XML 프로토콜 서버에서 방출되는 태그 요소가 준수할 수 있는 XML 버전 |
| 인코딩 | Junos XML 프로토콜 서버가 사용하고 이해할 수 있는 표준화된 문자 세트 |
Junos XML 프로토콜 서버의 <?xml?> PI version="1.0" 예에서 속성은 서버가 XML 1.0 사양을 준수하는 태그 요소를 내보낸다는 것을 나타냅니다. 이 속성은 encoding="us-ascii" 서버가 ANSI에 의해 표준화된 7비트 ASCII 문자 집합을 사용하고 있음을 나타냅니다. ANSI 표준에 대한 자세한 내용은 http://www.ansi.org/ .
<?xml version="1.0" encoding="us-ascii"?>
Junos XML Protocol Server의 오프닝 <junoscript> 태그 구문 분석
PI를 <?xml?> 방출한 후 서버는 다음 형식의 오프닝 <junoscript> 태그를 내뿜습니다(태그는 가독성을 위해 여러 줄에만 표시).
<junoscript xmlns="namespace-URL" xmlns:junos="namespace-URL" \ schemaLocation="namespace-URL" os="JUNOS" \ release="release-code" hostname="hostname" version="version">
속성은 다음과 같습니다.
| 호스트 | Junos XML 프로토콜 서버가 실행 중인 장비의 이름입니다. |
| Os | Junos XML 프로토콜 서버가 실행 중인 장비의 운영 체제입니다. 그 가치는 항상 JUNOS입니다. |
| 릴리스 | Junos XML 프로토콜 서버가 파생되고 이를 이해하도록 설계된 Junos OS 버전의 식별자입니다. 아마도 Junos XML 프로토콜 서버가 실행 중인 디바이스에서 사용되고 있는 것으로 간주됩니다. 속성의 |
| 스키마 배치 | Junos OS 구성 계층의 XML 스키마 언어 표현을 위한 XML 네임스페이스입니다. |
| 버전 | Junos XML 프로토콜 서버가 사용하는 Junos XML 관리 프로토콜의 버전입니다. |
| Xmlns | 이름에 접두사(즉, Junos XML 태그 요소의 |
| xmlns:junos | 이름에 접두사(prefix)가 있는 태그 요소로 |
Junos XML 프로토콜 서버의 오프닝 <junoscript> 태그 version 예에서 속성은 서버가 Junos XML 프로토콜 버전 1.0을 사용하고 있음을 나타내며hostname, 해당 속성은 라우터의 이름이 큰 장비임을 나타냅니다. 및 release 속성은 os 디바이스가 Junos OS 릴리스 20.4의 초기 버전을 실행 중임을 나타냅니다. 속성은 xmlns Junos XML 태그 요소의 기본 네임스페이스가 임을 http://xml.juniper.net/xnm/1.1/xnm 나타냅니다. 속성은 xmlns:junos prefix가 있는 태그 요소의 네임스페이 junos: 스가 을 http://xml.juniper.net/junos/20.4R1/junos 나타냅니다. 태그는 가독성만을 위해 여러 줄에 나타납니다.
<junoscript xmlns="http://xml.juniper.net/xnm/1.1/xnm"\
xmlns:junos="http://xml.juniper.net/junos/20.4R1/junos" \
schemaLocation="http://xml.juniper.net/junos/20.4R1/junos" os="JUNOS" \
release="20.4R1.8" hostname="big-device" version="1.0">
소프트웨어 호환성 검증
요소와 <junoscript> 요소를 교환하면 <?xml?> 클라이언트 애플리케이션과 Junos XML 프로토콜 서버가 Junos XML 프로토콜 세션 중에 사용되는 여러 버전의 소프트웨어를 실행하고 있는지 확인할 수 있습니다. 때때로 서로 다른 버전이 호환되지 않으며, Junos XML 프로토콜 컨벤션을 통해 소프트웨어의 최신 버전을 실행하는 당사자가 비호환성을 처리하는 방법을 결정합니다. 완전히 자동화된 성능을 위해 소프트웨어 버전이 Junos XML 프로토콜 서버보다 늦은지 여부를 결정하는 코드를 클라이언트 애플리케이션에 포함하십시오. 애플리케이션의 버전이 최신일 때 적합한 옵션을 결정하고 해당 응답을 구현합니다.
Junos 버전의 차이점을 무시하고 Junos XML 프로토콜 서버를 수용하기 위해 클라이언트 애플리케이션의 동작을 변경하지 마십시오. Junos 버전이 달라도 서버와 클라이언트가 호환되지 않을 필요는 없기 때문에 이는 종종 유효한 접근법입니다.
Junos XML 프로토콜 서버와 호환될 수 있도록 표준 동작을 변경합니다. 예를 들어 클라이언트 애플리케이션이 Junos OS의 최신 버전을 실행하는 경우 Junos XML 프로토콜 서버의 Junos OS 버전에서 사용할 수 있는 소프트웨어 기능을 나타내는 태그 요소만 내보낸다는 것을 선택할 수 있습니다.
Junos XML 프로토콜 세션을 종료하고 연결을 종료합니다. 이는 Junos XML 프로토콜 서버의 소프트웨어 버전을 수용하는 것이 적합하지 않다고 판단되는 경우에 적합합니다. 지침은 Junos XML 프로토콜 세션 종료 및 연결 종료를 참조하십시오.
표 1 은 Junos XML 관리 프로토콜의 버전 1.0에서 Junos XML 프로토콜을 초기화하는 동안 버전 정보를 전달하는 데 사용되는 PI 또는 오프닝 태그 및 속성을 지정합니다.
소프트웨어 및 버전 |
PI 또는 태그 |
특성 |
|---|---|---|
XML 1.0 |
|
|
ANSI 표준화된 7비트 ASCII 문자 세트 |
|
|
Junos XML 프로토콜 1.0 |
|
|
Junos OS 릴리스 |
|
|