gNOI 서비스 개요

Junos 디바이스는 이 주제에 설명된 gNOI 서비스 및 RPC를 지원합니다.

gRPC 네트워크 운영 인터페이스(gNOI)는 네트워크 디바이스에서 운영 명령을 수행하기 위한 서비스를 정의합니다. OpenConfig는 프로토 정의 파일에서 각 서비스에 대한 작업(RPC)과 데이터 구조(메시지)를 정의합니다. gNOI RPC의 전체 목록이 포함된 프로토 파일은 https://github.com/openconfig/gnoi 의 OpenConfig gNOI GitHub 리포지토리에 있습니다. Junos 디바이스는 다음 섹션에서 설명한 대로 서비스 및 RPC의 하위 집합을 지원합니다.

지원되는 서비스 개요

표 1 은 Junos 디바이스에서 지원되는 gNOI 서비스를 간략하게 보여줍니다. 이 표에는 지정된 버전의 프로토 파일에 대한 지원이 시작되는 릴리스가 나열되어 있습니다.

표 1: 지원되는 gNOI 서비스
서비스	릴리스 시작 지원	프로토 파일 버전
`CertificateManagement`	Junos OS Evolved 릴리스 22.2R1	0.2.0
`Diag`	Junos OS Evolved 릴리스 22.2R1	0.1.0
`File`	Junos OS Evolved 릴리스 22.2R1	0.1.0
`Layer2`	Junos OS 및 Junos OS Evolved 릴리스 24.2R1	0.1.0
`LinkQualification`	Junos OS Evolved 25.2X100D20	1.1.0
`OS`	Junos OS Evolved 릴리스 22.2R1	0.1.1
`System`	Junos OS Evolved 릴리스 22.2R1	1.0.0

CertificateManagement Service

표 2: 지원되는 cert.proto RPC
RPC	설명	릴리스에 도입된 내용
`CanGenerateCSR()`	대상 디바이스를 쿼리하여 지정된 키 유형, 키 크기 및 인증서 유형으로 인증서 서명 요청(CSR)을 생성할 수 있는지 확인합니다. 지원되는 값: 키 유형: KT_RSA 키 크기: 1024, 2048, 4096 인증서 유형: CT_X509 gNOI 서버가 특정 키 유형, 키 크기 및 인증서 유형을 지원하는 경우 반환 `True` 됩니다.	Junos OS Evolved 23.1R1
`GenerateCSR()`	인증서 서명 요청(CSR)을 생성하고 반환합니다.	Junos OS Evolved 22.2R1
`GetCertificates()`	대상 디바이스에 로드된 로컬 인증서를 반환합니다.	Junos OS Evolved 22.2R1
`Install()`	CSR 요청을 생성하고, CSR을 기반으로 인증서를 생성하고, 새 인증서 ID를 사용하여 인증서를 로드하여 대상 디바이스에 새 인증서를 로드합니다.	Junos OS Evolved 22.2R1
`LoadCertificate()`	대상 디바이스의 CA(인증 기관)에서 서명한 인증서를 로드합니다.	Junos OS Evolved 22.2R1
`LoadCertificateAuthorityBundle()`	대상 디바이스에 CA 인증서 번들을 로드합니다.	Junos OS Evolved 22.2R1
`RevokeCertificates()`	대상 디바이스에서 지정된 인증서 ID로 인증서를 해지합니다.	Junos OS Evolved 23.1R1
`Rotate()`	CSR 요청을 생성하고, CSR을 기반으로 인증서를 생성하고, 기존 인증서 ID를 사용하여 인증서를 로드하여 대상 디바이스의 기존 인증서를 교체합니다.	Junos OS Evolved 22.2R1

진단(진단) 서비스

표 3: 지원되는 diag.proto RPC
RPC	설명	릴리스에 도입된 내용
`StartBERT()`	포트 집합에서 BERT를 시작합니다. Junos 디바이스는 gNOI BERT에 대해 다음 PRBS 패턴을 지원합니다. PRBS7 PRBS9 PRBS15 PRBS23 PRBS31	Junos OS Evolved 22.2R1
`StopBert()`	포트 집합에서 이미 진행 중인 BERT를 중지합니다.	Junos OS Evolved 22.2R1
`GetBERTResult()`	BERT 도중 또는 완료 후에 BERT 결과를 가져옵니다.	Junos OS Evolved 22.2R1

파일 서비스

표 4: 지원되는 file.proto RPC
RPC	설명	릴리스에 도입된 내용
`Get()`	대상에서 파일의 내용을 읽고 스트리밍합니다. 파일은 순차적 메시지로 스트리밍되며 각 메시지에는 최대 64KB의 데이터가 포함됩니다. 전송된 데이터의 해시가 포함된 스트림을 닫기 전에 마지막 메시지가 전송됩니다. 파일이 없거나 파일을 읽는 동안 오류가 있는 경우 이 작업은 오류를 반환합니다.	Junos OS Evolved 22.2R1
`Put()`	대상의 파일로 데이터를 스트리밍합니다. 파일은 순차적 메시지로 전송되며 각 메시지에는 최대 64KB의 데이터가 포함됩니다. 데이터 해시를 포함하는 최종 메시지를 보내야 합니다. 위치가 없거나 데이터를 쓰는 동안 오류가 있는 경우 이 작업은 오류를 반환합니다. 체크섬이 수신되지 않으면 대상은 부분적으로 전송된 파일을 제거합니다. 실패해도 같은 이름의 기존 파일은 변경되지 않습니다.	Junos OS Evolved 22.2R1
`Remove()`	대상에서 지정된 파일을 제거합니다. 파일이 없거나, 파일 경로가 디렉터리로 확인되거나, 제거 작업에서 오류가 발생하는 경우 이 작업은 오류를 반환합니다.	Junos OS Evolved 22.2R1
`Stat()`	대상 디바이스의 파일에 대한 메타데이터를 반환합니다. 파일이 없거나 메타데이터에 액세스하는 동안 오류가 있는 경우 이 작업은 오류를 반환합니다.	Junos OS Evolved 22.2R1

레이어 2 서비스

표 5: 지원되는 layer2.proto RPC
RPC	설명	릴리스에 도입된 내용
`ClearLLDPInterface()`	지정된 인터페이스의 모든 LLDP 이웃을 지웁니다.	Junos OS 및 Junos OS Evolved 24.2R1

LinkQualification Service

표 6: 지원되는 LinkQualification RPC
RPC	설명	릴리스에 도입된 내용
`Capabilities‎()`	디바이스가 테스트 수행을 위한 요구 사항을 충족하는지 여부를 반환합니다.	Junos OS Evolved 25.2X100D20
`Create()`	인터페이스 집합에서 PBLQ 테스트를 시작합니다.	Junos OS Evolved 25.2X100D20
`Get()`	테스트 결과를 반환합니다.	Junos OS Evolved 25.2X100D20
`List()`	지정된 인터페이스에 사용할 수 있는 테스트 결과를 나열합니다.	Junos OS Evolved 25.2X100D20
`Delete()`	지정된 테스트와 해당 결과를 제거합니다. 테스트가 진행 중인 경우 이 RPC는 테스트를 취소한 다음 삭제합니다.	Junos OS Evolved 25.2X100D20

운영 체제(OS) 서비스

표 7: 지원되는 os.proto RPC
RPC	설명	릴리스에 도입된 내용
`Activate()`	다음 재부팅 시 사용할 소프트웨어 버전을 설정합니다. `Activate()` 플래그가 `no_reboot` 생략되거나 로 설정된 경우 대상을 재부팅합니다. `False` 재부팅이 요청된 소프트웨어 버전을 부팅하지 못하면 대상이 이전 버전으로 롤백됩니다. 참고: Junos 디바이스는 메시지의 필드를 `standby_supervisor` 지원하지 않습니다.`ActivateRequest` 참고: Junos OS Evolved 릴리스 25.2R1 이전에는 소프트웨어 `Activate()` 에 대해 현재 구성을 검증하고, 소프트웨어를 설치하고, 소프트웨어 버전을 다음 부팅 버전으로 설정합니다.	Junos OS Evolved 22.2R1
`Install()`	소프트웨어 설치 패키지를 대상으로 전송하고, 소프트웨어에 대한 구성의 유효성을 검사하고, 소프트웨어를 설치(스테이징)합니다. 지정된 소프트웨어 이미지가 디바이스에 이미 설치되어 있는 경우, 소프트웨어 이미지에 대해 현재 구성을 검증하고 검증된 구성을 해당 소프트웨어 버전과 연관된 실행 구성으로 저장합니다. 참고: Junos 디바이스는 메시지의 필드를 `standby_supervisor` 지원하지 않습니다.`TransferRequest` 참고: Junos OS Evolved 릴리스 25.2R1 `Install()` 이전에는 소프트웨어 설치 패키지만 대상에 전송합니다.	Junos OS Evolved 22.2R1
`Verify()`	실행 중인 소프트웨어 버전을 확인합니다. 이 RPC는 대상이 성공할 때까지 부팅되는 동안 여러 번 호출될 수 있습니다. 참고: Junos 디바이스는 VerifyResponse를 지원 `verify_standby` 하지 않습니다.	Junos OS Evolved 22.2R1

시스템 서비스(Ping 및 Traceroute)

표 8: 네트워크 문제 해결을 위해 지원되는 system.proto RPC
RPC	설명	릴리스에 도입된 내용
`Ping()`	디바이스를 ping합니다. RPC는 `Ping()` IPv4 및 IPv6 ping을 지원합니다. 이 RPC는 ping이 완료된 후 ping 결과를 다시 스트리밍합니다. 기본 패킷 수: 5	Junos OS Evolved 22.2R1
`Traceroute()`	대상 디바이스에서 traceroute 명령을 실행하고 결과를 다시 스트리밍합니다. 기본 홉 수: 30	Junos OS Evolved 22.2R1

시스템 서비스(재부팅)

표 9: 재부팅을 위해 지원되는 system.proto RPC
RPC	설명	릴리스에 도입된 내용
`Reboot()`	대상을 재부팅합니다. 한 번에 하나의 대상에 대한 재부팅 요청만 실행할 수 있습니다. 선택적으로 향후 재부팅 지연을 구성하고, 하위 구성 요소를 개별적으로 재부팅하고, 재부팅이 시작될 때 메시지를 추가할 수 있습니다. 지연은 나노초 단위로 구성됩니다. Junos 디바이스는 다음과 같은 재부팅 방법을 지원합니다. 냉기 (1) 파워 다운 (2) 정지 (3) 파워업 (7)	Junos OS Evolved 22.2R1
`RebootStatus()`	재부팅 상태를 반환합니다.	Junos OS Evolved 22.2R1
`CancelReboot()`	보류 중인 재부팅 요청을 취소합니다.	Junos OS Evolved 22.2R1

시스템 서비스(소프트웨어 업그레이드)

표 10: 소프트웨어 업그레이드에 지원되는 system.proto RPC
RPC	설명	릴리스에 도입된 내용
`SetPackage()`	대상 디바이스에 소프트웨어 이미지를 설치합니다.	Junos OS Evolved 22.2R1

시스템 서비스(라우팅 엔진 전환)

표 11: 라우팅 엔진 전환을 위해 지원되는 system.proto RPC
RPC	설명	릴리스에 도입된 내용
`SwitchControlProcessor()`	현재 라우팅 엔진에서 지정된 라우팅 엔진으로 전환합니다. 현재 라우팅 엔진과 지정된 라우팅 엔진이 동일하면, NOOP입니다. 대상이 존재하지 않으면 RPC는 오류를 반환합니다. 참고: Junos 디바이스는 를 지원 `control_processor` 하지 않습니다.`SwitchControlProcessorResponse`	Junos OS Evolved 22.2R1