Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions images/ufm-basic-function.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions installation/controller-k3s-air-gap-ha.rst
Original file line number Diff line number Diff line change
Expand Up @@ -549,7 +549,7 @@ The Netris Local Repository is essential for environments where switches, softga

.. code-block:: shell

export PVC_PATH=$(kubectl get pv $(kubectl get pvc staticsite-$(kubectl -nnetris-controller get pod -l app.kubernetes.io/instance=netris-local-repo --field-selector spec.nodeName=$(hostname) --no-headers -o custom-columns=":metadata.name") -n netris-controller -o jsonpath="{.spec.volumeName}") -o jsonpath="{.spec.local.path}")
export PVC_PATH=$(kubectl get pv $(kubectl get pvc staticsite-$(kubectl -nnetris-controller get pod -l app.kubernetes.io/instance=netris-local-repo --field-selector spec.nodeName=$(hostname | tr '[:upper:]' '[:lower:]') --no-headers -o custom-columns=":metadata.name") -n netris-controller -o jsonpath="{.spec.volumeName}") -o jsonpath="{.spec.local.path}")

sudo cp -r files/repo ${PVC_PATH}

Expand Down Expand Up @@ -740,7 +740,7 @@ On **all three nodes**, copy the repository files into the Persistent Volume:

.. code-block:: shell

export PVC_PATH=$(kubectl get pv $(kubectl get pvc staticsite-$(kubectl -nnetris-controller get pod -l app.kubernetes.io/instance=netris-local-repo --field-selector spec.nodeName=$(hostname) --no-headers -o custom-columns=":metadata.name") -n netris-controller -o jsonpath="{.spec.volumeName}") -o jsonpath="{.spec.local.path}")
export PVC_PATH=$(kubectl get pv $(kubectl get pvc staticsite-$(kubectl -nnetris-controller get pod -l app.kubernetes.io/instance=netris-local-repo --field-selector spec.nodeName=$(hostname | tr '[:upper:]' '[:lower:]') --no-headers -o custom-columns=":metadata.name") -n netris-controller -o jsonpath="{.spec.volumeName}") -o jsonpath="{.spec.local.path}")

sudo cp -r files/repo ${PVC_PATH}

Expand Down
4 changes: 2 additions & 2 deletions netris-architecture.rst
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ A Netris system is composed of 3 elements:
Netris Controller
=================

Netris Controller is the main operations control center for engineers using GUI/RestAPI/Kubernetes, systems, and network devices. The Netris Controller stores the data representing the user-defined network services and policies, health, statistics, analytics received from the network devices, and information from integration modules with external systems (Kubernetes, Terraform, etc.). Netris Controller can run as a VM or container, on/off-prem, or in Netris cloud.
Netris Controller is the main operations control center for engineers using GUI/RestAPI/Kubernetes, systems, and network devices. The Netris Controller stores the data representing the user-defined network services and policies, health, statistics, analytics received from the network devices, and information from integration modules with external systems (Kubernetes, Terraform, etc.). Netris Controller can run on or off premises on bare-metal, as a VM, or as a container.

Diagram: High level Netris architecture

Expand All @@ -44,4 +44,4 @@ Netris SoftGate
In multi-tenant environments, tenants typically require controlled ingress and egress connectivity to their VPCs. For example, the workload access to and from the Internet.
SoftGate is an optional, multi-tenant (VPC-aware) software component designed for cloud providers and scales horizontally to provide this ingress and egress connectivity services (NAT and L4LB). The SoftGate software runs on a dedicated set of operator-provided bare-metal servers and is tightly integrated with the Netris-managed North-South fabric

You can learn more about SoftGate architecture and deployment scenarios in the :doc:`Netris SoftGate HS <netris-softgate-HS>` document.
You can learn more about SoftGate architecture and deployment scenarios in the :doc:`Netris SoftGate HS <netris-softgate-HS>` document.
17 changes: 14 additions & 3 deletions netris-ufm-integration.rst
Original file line number Diff line number Diff line change
Expand Up @@ -30,8 +30,16 @@ When you define a :doc:`server-cluster </server-cluster>` in Netris, the plugin

- Discovers InfiniBand port GUIDs from UFM
- Creates and manages appropriate PKeys in UFM
- Sets up SHARP reservations for high-performance operations
- Optionally sets up SHARP reservations for high-performance operations

.. image:: images/ufm-basic-function.svg
:align: center
:class: with-shadow

.. raw:: html

<p style="text-align: center;"><em>Figure: Netris-UFM Integration Workflow</em></p>

Prerequisites
==============

Expand All @@ -42,8 +50,6 @@ Before installing the Netris-UFM plugin, ensure:
3. Network connectivity between both systems
4. Appropriate access credentials for both platforms



UFM Configuration Requirements
================================

Expand Down Expand Up @@ -106,6 +112,7 @@ This option is recommended if you already have a Netris Controller running in a
UFM_VERIFY_SSL: "false"
UFM_ID: "ufm-lab"
UFM_PKEY_RANGE: "100-7ffe"
UFM_ENABLE_SHARP: "true"

3. Apply the configuration to your Kubernetes cluster:

Expand Down Expand Up @@ -133,6 +140,7 @@ This option is ideal for environments without Kubernetes or when you want to dep
UFM_VERIFY_SSL="false"
UFM_ID="ufm-lab"
UFM_PKEY_RANGE="100-7ffe"
UFM_ENABLE_SHARP="true"
LOG_LEVEL="info"

2. Run the Docker container:
Expand Down Expand Up @@ -202,6 +210,9 @@ NVIDIA UFM Configuration
* - UFM_PKEY_RANGE
- Range of PKey IDs that can be allocated to clusters, in hexadecimal format
- 100-7ffe
* - UFM_ENABLE_SHARP
- Whether to enable SHARP reservation management for clusters
- true or false

Agent Configuration
-------------------
Expand Down
5 changes: 5 additions & 0 deletions supported-platform-matrix.rst
Original file line number Diff line number Diff line change
Expand Up @@ -522,6 +522,11 @@ Netris and NOS versions compatibility matrix
- **SoftGate PRO OS**
- **SoftGate HS OS**
- **Availability**
* - 4.7.0
- Nvidia Cumulus 5.13, Dell SONiC 4.5, EdgeCore SONiC 202211-331, Arista EOS 4.34.1F
- N/A
- Ubuntu 24.04
- ✔
* - 4.6.0
- Nvidia Cumulus 5.13, Dell SONiC 4.5, EdgeCore SONiC 202211-331, Arista EOS 4.34.1F
- N/A
Expand Down
Loading