Apstra ConnectorOps RNIC Configurator
Tataiso

Apstra ConnectorOps RNIC Configurator

E hatisitsoe
2025-12-09

Litlhaloso tsa likarolo tsa Juniper Networks, Inc.
Mokhoa oa 1133 oa ho nchafatsa
Sunnyvale, California 94089
usa
408-745-2000
www.junipere.net

Juniper Networks, logo ea Juniper Networks, Juniper, le Junos ke matšoao a ngolisitsoeng a Juniper Networks, Inc. United States le linaheng tse ling. Matshwao a mang kaofela a kgwebo, matshwao a tshebeletso, matshwao a ngodisitsweng, kapa matshwao a tshebeletso a ngodisitsweng ke thepa ya beng ba ona ka ho fapana.
Juniper Networks ha e nke boikarabello bakeng sa ho se nepahale hofe kapa hofe ho tokomane ena. Juniper Networks e na le tokelo ea ho fetola, ho fetola, ho fetisa, kapa ho ntlafatsa sengoliloeng sena ntle le tsebiso.
Apstra ConnectorOps RNIC Configurator Guide
Copyright © 2025 Juniper Networks, Inc. Litokelo tsohle li sirelelitsoe.
Lintlha tse tokomaneng ena ke tsa morao-rao ho tloha ka letsatsi le leqepheng la sehlooho.

SELEMO SA 2000 TSEBISO
Juniper Networks hardware le lihlahisoa tsa software li lumellana le Selemo sa 2000. Junos OS ha e na meeli e tsejoang e amanang le nako ho pholletsa le selemo sa 2038. Leha ho le joalo, kopo ea NTP e tsejoa e na le bothata bo itseng ka selemo sa 2036.

QETELA TUMELLANO YA LAesense ya MOSEBETSI
Sehlahisoa sa Juniper Networks seo e leng sehlooho sa litokomane tsena tsa tekheniki se na le (kapa se reretsoe ho sebelisoa le) software ea Juniper Networks. Tšebeliso ea software e joalo e ipapisitse le lipehelo le lipehelo tsa Tumellano ea License ea Mosebelisi (“EULA”) e behiloeng ho. https://support.juniper.net/support/eula/. Ka ho jarolla, ho kenya, kapa ho sebelisa software e joalo, o lumellana le lipehelo le lipehelo tsa EULA eo.

Mabapi le Tataiso ena

This guide walks you through the setup and deployment of Apstra ConnectorOps RNIC Configurator.
You define QoS and DCQCN settings in Apstra, and ConnectorOps RNIC reads those settings to configure your GPU server RNICs accordingly. The service then generates and pushes vendor-specific configuration scripts to your GPU server RNICs over SSH. ConnectorOps RNIC runs as a service on a VM or host with access to both Apstra and the GPU servers. It continuously monitors selected blueprints for configuration changes and ensures that RDMA traffic is always managed according to the latest Apstra intent.

1 CHAPTER: Introduction

Selelekela

KAKARETSO
ConnectorOps RDMA Network Interface Card (RNIC) Configurator automates host-side RNIC configuration for GPU servers in your fabric.

ConnectorOps RDMA Network Interface Card (RNIC) Configurator is a service designed to automate host-side RDMA NIC configuration for GPU servers in your fabric. The service continuously monitors Apstra blueprints for changes in topology and QoS configuration, such as updates to the Data Center Quantized Congestion Notification (DCQCN) Configlets. If an update event occurs, the service automatically generates scripts that are delivered to GPU servers based on the vendor. This keeps the network interface card Differentiated Services Code Point (DSCP) and Priority-based Flow Control (PFC) settings aligned with the intended fabric policy.

EKETSEHILENG TS'OANE
Apstra ConnectorOps Setup Guide

2 CHAPTER: Prerequisites

Lintho tse hlokahalang
Blueprint Prerequisites

• GPU servers connected as “generic systems” in the blueprint
• All interface cabling is mapped in the blueprint
• Configlets assigned to all leaf switches with connected GPU hosts

Apstra ConnectorOps RNIC Configurator Prerequisites

• DCQCN Configlets created in Apstra
• Property Set imported with GPU server SSH credentials
• ConnectorOps RNIC host can access Apstra and GPU servers
• SSH is enabled on all GPU servers
• configure_nic flag set to “enable” for RNIC configuration automation

3 CHAPTER: Deploy ConnectorOps RNIC Configurator and Verify Connectivity

Deploy ConnectorOps RNIC Configurator and Verify Khokahano

KAKARETSO
Use the following steps to deploy ConnectorOps RNIC Configurator and Verify Connectivity

1. Create a directory for the ConnectorOps image.
   mkdir ~/connectorops-rnic
2. Download the latest Apstra ConnectorOps RNIC image onto the VM/host/server.
   Use the following download link under Application Tools: https://support.juniper.net/support/downloads/?p=apstra.
3. Install Docker and Docker Compose.
4. Load the Docker image.
   root@test-vm:~/connectorops-rnic$ docker load -i <connectorops-rnic-image>
5. Create the docker-compose.yml file.
   Se latelang ke example Docker Compose. yml file.
   ditshebeletso:
   connector-ops-rnic:
   image: <image-name>:<tag>
   container_name: connector-ops-rnic
   tikoloho:
   – AOS_URL=<aos-url>
   – AOS_USER=<aos-username>
   – AOS_PASSWORD=<aos-password>
   – CONFIGURE_NIC=enable
   likou:
   – “<host-port>:8080”
   meqolo:
   – <path-to-host-directory>:/app/data
   restart: always
6. Start ConnectorOps RNIC Configurator.
   root@test-vm:~/connectorops-rnic$ docker-compose up -d
   The service begins caching blueprint data and monitoring for configuration changes.
7. Access the debugging dashboard to verify the service is active.
   Bula a web browser and navigate to http://<host-ip>:<8080> (the same port in your docker-compose.yml) to view the dashboard tool.
   U lokela ho bona:
   • Active blueprints being monitored
   • Cached config-context data
   • Last poll timestamps
   • Any detected configuration changes

4 CHAPTER: Create and Import a Global Property Set

To Create and Import a Global Property Set

KAKARETSO
You must define a Property Set with input information for ConnectorOps to automate configuration generation to the RNICs. ConnectorOps uses this Property Set as the data source for configuration rendering and to establish connectivity between devices.
You must configure a Property Set with the “connectorops_config” prefix. The property set must include the following:

• gpu_host credentials: username/password to access the GPU host or hosts.
• gpu_details: username/password to access the GPUs.

Se latelang ke example Property Set. Note that the jump_host details are only required if your topology contains a jump host.

Name connectorops_config
Litekanyetso
{
“jump_host”: “<jump_host_ip>”,
“jump_host_user”: “<username>”,
“jump_host_password”: “<password>”,
“gpu_hosts_user”: “<username>”,
“gpu_hosts_password”: “<password>”,
“gpu_details”: {
“H100-01”: {
“user”: “<username>”,
“password”: “<password>”
},
“H100-0[2-4]”: {
“user”: “<username>”,
“password”: “<password>”
}
}
}

1. Navigate to Design > Property Sets > Create Property Set.
   The Create Property Set window displays.
2. Enter a Name and define a Property Set configuration in Values.
   Make sure to follow the proper naming convention.
3. Tobetsa Create.
4. From within your Blueprint, navigate to Staged > Catalog > Property Sets > Import Property Set.
   The Import Property Set from Global Catalog window displays.
5. Select the Property Set you created from the dropdown, and click Import Property Set.
   This triggers an event, and ConnectorOps uses the Property Set as input to generate the configuration.

5 CHAPTER: Create and Import a DCQCN Configlet

Create and Import a DCQCN Configlet
For instructions about how to create and import a DCQCN Configlet into your Apstra blueprint, see Enable DCQCN in your AI Fabric.

For more information about DCQCN, see Data Center Quantized Congestion Notification (DCQCN).
Se latelang ke example DCQCN Configlet:

class-of-service {
classifiers {
dscp mydscp {
forwarding-class CNP {
loss-priority low code-points 110000;
}
forwarding-class NO-LOSS {
loss-priority low code-points 011010;
}
}
}
drop-profiles {
dp1 {
interpolate {
fill-level [ 55 90 ];
drop-probability [ 0 100 ];
}
}
}
shared-buffer {
ingress {
buffer-partition lossless {
percent 66;
dynamic-threshold 10;
}
buffer-partition lossless-headroom {
percent 24;
}
buffer-partition lossy {
percent 10;
}
}
egress {
buffer-partition lossless {
percent 66;
}
buffer-partition lossy {
percent 10;
}
}
}
dedicated-buffer {
ingress {
percent 15;
}
egress {
percent 30;
}
}
forwarding-classes {
class CNP queue-num 3;
class NO-LOSS queue-num 4 no-loss pfc-priority 3;
}
congestion-notification-profile {
cnp {
pfc-watchdog;
input {
dscp {
code-point 011010 {
pfc;
}
}
}
output {
ieee-802.1 {
code-point 011 {
flow-control-queue 4;
}
}
}
}
}
likhokahano {
et-* {
congestion-notification-profile cnp;
scheduler-map sm1;
unit * {
classifiers {
dscp mydscp;
}
}
}
}
scheduler-maps {
sm1 {
forwarding-class CNP scheduler s2-cnp;
forwarding-class NO-LOSS scheduler s1;
}
}
schedulers {
s1 {
drop-profile-map loss-priority any protocol any drop-profile dp1;
explicit-congestion-notification;
}
s2-cnp {
transmit-rate percent 5;
priority strict-high;
}
}
}

After you import and commit, Apstra includes the DCQCN policies in the config-context for the relevant switches in your fabric. ConnectorOps RNIC Configurator automatically reads these policies and enforces them on all GPU server RNICs.

6 CHAPTER: Troubleshooting

Ho batle phoso
Check the following to help with troubleshooting:

• Ensure that the GPU servers are connected as “generic systems” in the blueprint.
• Verify that all user-inputted Property Sets follow the correct naming conventions and are properly imported into the relevant blueprints.
• Confirm that both Apstra and the GPU servers are reachable from the VM/host/server where ConnectorOps is installed.
• Check that the ConnectorOps RNIC Configurator service is up and running. Review logs for any errors using:

docker logs <container_name_or_id>

To access the debugging tool dashboard, visit http://<host-ip>:<8080>.
You can use the debugging dashboard tool to troubleshoot by checking which blueprints are being polled, when data was last updated, and whether any errors occurred while processing Apstra configuration changes.

Litokomane / Lisebelisoa

Juniper NETWORKS Apstra ConnectorOps RNIC Configurator [pdf] Bukana ea Mosebelisi Apstra ConnectorOps RNIC Configurator, ConnectorOps RNIC Configurator, RNIC Configurator

Litšupiso

• Bukana ea Mosebelisi