gNOI 서비스 개요

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

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

지원 서비스 개요

표 1 에는 Junos 디바이스에서 지원되는 gNOI 서비스가 요약되어 있습니다. 이 표에는 지정된 버전의 proto 파일에 대한 지원이 시작되는 릴리스가 나열됩니다.

표 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
`OS`	Junos OS Evolved 릴리스 22.2R1	0.1.1
`System`	Junos OS Evolved 릴리스 22.2R1	1.0.0

CertificateManagement 서비스

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

진단(진단) 서비스

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

파일 서비스

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

운영 체제(OS) 서비스

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

시스템 서비스(Ping 및 Traceroute)

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

시스템 서비스(재부팅)

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

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

표 8: 소프트웨어 업그레이드를 위해 지원되는 system.proto RPC
릴리스에 도입된	RPC	설명
`SetPackage()`	대상 장치에 소프트웨어 이미지를 설치합니다.	진화한 Junos OS 22.2R1

시스템 서비스(라우팅 엔진 스위치오버)

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