Updating Docs for commit fdc0509 made on 2024-12-12T01:19:38+00:00 fr…

…om refs/heads/master
netrisai · Dec 12, 2024 · 649a7ab · 649a7ab
commit 649a7ab
Show file tree

Hide file tree

Showing 2,409 changed files with 573,085 additions and 0 deletions.
diff --git a/.gitattributes b/.gitattributes
@@ -0,0 +1,2 @@
+*.pdf filter=lfs diff=lfs merge=lfs -text
+*.epub filter=lfs diff=lfs merge=lfs -text
diff --git a/.nojekyll b/.nojekyll
diff --git a/README.md b/README.md
@@ -0,0 +1,7 @@
+# GitHub Pages Cache
+
+Nothing to see here. The contents of this branch are essentially a cache that's not intended to be viewed on github.com.
+
+You can view the actual documentation as it's intended to be viewed at [https://netris.io/docs/](https://netris.io/docs/)
+
+If you're looking to update our documentation, check the relevant development branch's ['docs'](https://github.com/netrisai/docs).
diff --git a/en/2.9/.buildinfo b/en/2.9/.buildinfo
@@ -0,0 +1,4 @@
+# Sphinx build info version 1
+# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
+config: 87b438ab61e542501fac234e0ef63265
+tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/en/2.9/.doctrees/SoftGate-agent-installation.doctree b/en/2.9/.doctrees/SoftGate-agent-installation.doctree
diff --git a/en/2.9/.doctrees/accounts.doctree b/en/2.9/.doctrees/accounts.doctree
diff --git a/en/2.9/.doctrees/concepts.doctree b/en/2.9/.doctrees/concepts.doctree
diff --git a/en/2.9/.doctrees/controller-initial-configuration.doctree b/en/2.9/.doctrees/controller-initial-configuration.doctree
diff --git a/en/2.9/.doctrees/controller-installation.doctree b/en/2.9/.doctrees/controller-installation.doctree
diff --git a/en/2.9/.doctrees/controller-k8s-installation.doctree b/en/2.9/.doctrees/controller-k8s-installation.doctree
diff --git a/en/2.9/.doctrees/environment.pickle b/en/2.9/.doctrees/environment.pickle
diff --git a/en/2.9/.doctrees/index.doctree b/en/2.9/.doctrees/index.doctree
diff --git a/en/2.9/.doctrees/network-policies.doctree b/en/2.9/.doctrees/network-policies.doctree
diff --git a/en/2.9/.doctrees/release-notes.doctree b/en/2.9/.doctrees/release-notes.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox1/configurations.doctree b/en/2.9/.doctrees/sandbox/Sandbox1/configurations.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox1/creating-services.doctree b/en/2.9/.doctrees/sandbox/Sandbox1/creating-services.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox1/index.doctree b/en/2.9/.doctrees/sandbox/Sandbox1/index.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox1/onprem-k8s.doctree b/en/2.9/.doctrees/sandbox/Sandbox1/onprem-k8s.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox1/sandbox-info.doctree b/en/2.9/.doctrees/sandbox/Sandbox1/sandbox-info.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox10/Configurations.doctree b/en/2.9/.doctrees/sandbox/Sandbox10/Configurations.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox10/Diagram.doctree b/en/2.9/.doctrees/sandbox/Sandbox10/Diagram.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox10/Sandbox-info.doctree b/en/2.9/.doctrees/sandbox/Sandbox10/Sandbox-info.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox10/creating-services.doctree b/en/2.9/.doctrees/sandbox/Sandbox10/creating-services.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox10/index.doctree b/en/2.9/.doctrees/sandbox/Sandbox10/index.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox2/configurations.doctree b/en/2.9/.doctrees/sandbox/Sandbox2/configurations.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox2/creating-services.doctree b/en/2.9/.doctrees/sandbox/Sandbox2/creating-services.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox2/index.doctree b/en/2.9/.doctrees/sandbox/Sandbox2/index.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox2/onprem-k8s.doctree b/en/2.9/.doctrees/sandbox/Sandbox2/onprem-k8s.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox2/sandbox-info.doctree b/en/2.9/.doctrees/sandbox/Sandbox2/sandbox-info.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox3/configurations.doctree b/en/2.9/.doctrees/sandbox/Sandbox3/configurations.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox3/creating-services.doctree b/en/2.9/.doctrees/sandbox/Sandbox3/creating-services.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox3/index.doctree b/en/2.9/.doctrees/sandbox/Sandbox3/index.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox3/onprem-k8s.doctree b/en/2.9/.doctrees/sandbox/Sandbox3/onprem-k8s.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox3/sandbox-info.doctree b/en/2.9/.doctrees/sandbox/Sandbox3/sandbox-info.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox4/configurations.doctree b/en/2.9/.doctrees/sandbox/Sandbox4/configurations.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox4/creating-services.doctree b/en/2.9/.doctrees/sandbox/Sandbox4/creating-services.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox4/index.doctree b/en/2.9/.doctrees/sandbox/Sandbox4/index.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox4/onprem-k8s.doctree b/en/2.9/.doctrees/sandbox/Sandbox4/onprem-k8s.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox4/sandbox-info.doctree b/en/2.9/.doctrees/sandbox/Sandbox4/sandbox-info.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox5/configurations.doctree b/en/2.9/.doctrees/sandbox/Sandbox5/configurations.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox5/creating-services.doctree b/en/2.9/.doctrees/sandbox/Sandbox5/creating-services.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox5/index.doctree b/en/2.9/.doctrees/sandbox/Sandbox5/index.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox5/onprem-k8s.doctree b/en/2.9/.doctrees/sandbox/Sandbox5/onprem-k8s.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox5/sandbox-info.doctree b/en/2.9/.doctrees/sandbox/Sandbox5/sandbox-info.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox6/configurations.doctree b/en/2.9/.doctrees/sandbox/Sandbox6/configurations.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox6/creating-services.doctree b/en/2.9/.doctrees/sandbox/Sandbox6/creating-services.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox6/index.doctree b/en/2.9/.doctrees/sandbox/Sandbox6/index.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox6/onprem-k8s.doctree b/en/2.9/.doctrees/sandbox/Sandbox6/onprem-k8s.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox6/sandbox-info.doctree b/en/2.9/.doctrees/sandbox/Sandbox6/sandbox-info.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox7/configurations.doctree b/en/2.9/.doctrees/sandbox/Sandbox7/configurations.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox7/creating-services.doctree b/en/2.9/.doctrees/sandbox/Sandbox7/creating-services.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox7/index.doctree b/en/2.9/.doctrees/sandbox/Sandbox7/index.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox7/onprem-k8s.doctree b/en/2.9/.doctrees/sandbox/Sandbox7/onprem-k8s.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox7/sandbox-info.doctree b/en/2.9/.doctrees/sandbox/Sandbox7/sandbox-info.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox8/configurations.doctree b/en/2.9/.doctrees/sandbox/Sandbox8/configurations.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox8/creating-services.doctree b/en/2.9/.doctrees/sandbox/Sandbox8/creating-services.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox8/index.doctree b/en/2.9/.doctrees/sandbox/Sandbox8/index.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox8/onprem-k8s.doctree b/en/2.9/.doctrees/sandbox/Sandbox8/onprem-k8s.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox8/sandbox-info.doctree b/en/2.9/.doctrees/sandbox/Sandbox8/sandbox-info.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox9/configurations.doctree b/en/2.9/.doctrees/sandbox/Sandbox9/configurations.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox9/creating-services.doctree b/en/2.9/.doctrees/sandbox/Sandbox9/creating-services.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox9/index.doctree b/en/2.9/.doctrees/sandbox/Sandbox9/index.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox9/onprem-k8s.doctree b/en/2.9/.doctrees/sandbox/Sandbox9/onprem-k8s.doctree
diff --git a/en/2.9/.doctrees/sandbox/Sandbox9/sandbox-info.doctree b/en/2.9/.doctrees/sandbox/Sandbox9/sandbox-info.doctree
diff --git a/en/2.9/.doctrees/services.doctree b/en/2.9/.doctrees/services.doctree
diff --git a/en/2.9/.doctrees/switch-agent-installation.doctree b/en/2.9/.doctrees/switch-agent-installation.doctree
diff --git a/en/2.9/.doctrees/visibility.doctree b/en/2.9/.doctrees/visibility.doctree
diff --git a/en/2.9/.nojekyll b/en/2.9/.nojekyll
diff --git a/en/2.9/SoftGate-agent-installation.html b/en/2.9/SoftGate-agent-installation.html
diff --git a/en/2.9/_images/ACL_active.png b/en/2.9/_images/ACL_active.png
diff --git a/en/2.9/_images/ACL_approval.png b/en/2.9/_images/ACL_approval.png
diff --git a/en/2.9/_images/ACL_rule.png b/en/2.9/_images/ACL_rule.png
diff --git a/en/2.9/_images/BGP_neighbor.png b/en/2.9/_images/BGP_neighbor.png
diff --git a/en/2.9/_images/BGP_neighbors_listing.png b/en/2.9/_images/BGP_neighbors_listing.png
diff --git a/en/2.9/_images/BGP_route.png b/en/2.9/_images/BGP_route.png
diff --git a/en/2.9/_images/EVPN_routing.png b/en/2.9/_images/EVPN_routing.png
diff --git a/en/2.9/_images/IP_allocation.png b/en/2.9/_images/IP_allocation.png
diff --git a/en/2.9/_images/IP_pool_assignment.png b/en/2.9/_images/IP_pool_assignment.png
diff --git a/en/2.9/_images/IPv4_Prefix.png b/en/2.9/_images/IPv4_Prefix.png
diff --git a/en/2.9/_images/IPv6_Prefix.png b/en/2.9/_images/IPv6_Prefix.png
diff --git a/en/2.9/_images/ISP_Iris.png b/en/2.9/_images/ISP_Iris.png
diff --git a/en/2.9/_images/MAC_listing.png b/en/2.9/_images/MAC_listing.png
diff --git a/en/2.9/_images/NATIP_address.png b/en/2.9/_images/NATIP_address.png
diff --git a/en/2.9/_images/NetSubnets_listing.png b/en/2.9/_images/NetSubnets_listing.png
diff --git a/en/2.9/_images/Port_Forwarding.png b/en/2.9/_images/Port_Forwarding.png
diff --git a/en/2.9/_images/ROH_instance.png b/en/2.9/_images/ROH_instance.png
diff --git a/en/2.9/_images/ROH_listing.png b/en/2.9/_images/ROH_listing.png
diff --git a/en/2.9/_images/SiteMesh_listing.png b/en/2.9/_images/SiteMesh_listing.png
diff --git a/en/2.9/_images/SiteMesh_modes.png b/en/2.9/_images/SiteMesh_modes.png
diff --git a/en/2.9/_images/Site_Mesh.png b/en/2.9/_images/Site_Mesh.png
diff --git a/en/2.9/_images/Spine1.png b/en/2.9/_images/Spine1.png
diff --git a/en/2.9/_images/TCAM.png b/en/2.9/_images/TCAM.png
diff --git a/en/2.9/_images/VNET_listing.png b/en/2.9/_images/VNET_listing.png
diff --git a/en/2.9/_images/VNETs.png b/en/2.9/_images/VNETs.png
diff --git a/en/2.9/_images/V_NET.png b/en/2.9/_images/V_NET.png
diff --git a/en/2.9/_images/action_permit.png b/en/2.9/_images/action_permit.png
diff --git a/en/2.9/_images/allocation.png b/en/2.9/_images/allocation.png
diff --git a/en/2.9/_images/anycast_IPv4_address.png b/en/2.9/_images/anycast_IPv4_address.png
diff --git a/en/2.9/_images/approve_reject.png b/en/2.9/_images/approve_reject.png
diff --git a/en/2.9/_images/assignment.png b/en/2.9/_images/assignment.png
diff --git a/en/2.9/_images/assignment2.png b/en/2.9/_images/assignment2.png
diff --git a/en/2.9/_images/community.png b/en/2.9/_images/community.png
diff --git a/en/2.9/_images/create_link.png b/en/2.9/_images/create_link.png
diff --git a/en/2.9/_images/createboard.png b/en/2.9/_images/createboard.png
diff --git a/en/2.9/_images/credentials.png b/en/2.9/_images/credentials.png
diff --git a/en/2.9/_images/defaultroute.png b/en/2.9/_images/defaultroute.png
diff --git a/en/2.9/_images/edit_switch_port.png b/en/2.9/_images/edit_switch_port.png
diff --git a/en/2.9/_images/globalIP.png b/en/2.9/_images/globalIP.png
diff --git a/en/2.9/_images/graphboard.png b/en/2.9/_images/graphboard.png
diff --git a/en/2.9/_images/hairpin.png b/en/2.9/_images/hairpin.png
diff --git a/en/2.9/_images/hairpin_topology.png b/en/2.9/_images/hairpin_topology.png
diff --git a/en/2.9/_images/hardware_health.png b/en/2.9/_images/hardware_health.png
diff --git a/en/2.9/_images/installOS.png b/en/2.9/_images/installOS.png
diff --git a/en/2.9/_images/inventory_heartbeat.png b/en/2.9/_images/inventory_heartbeat.png
diff --git a/en/2.9/_images/inventory_profile.png b/en/2.9/_images/inventory_profile.png
diff --git a/en/2.9/_images/leaf1_spine1.png b/en/2.9/_images/leaf1_spine1.png
diff --git a/en/2.9/_images/listing_L3.png b/en/2.9/_images/listing_L3.png
diff --git a/en/2.9/_images/listing_L4.png b/en/2.9/_images/listing_L4.png
diff --git a/en/2.9/_images/listing_kubenet.png b/en/2.9/_images/listing_kubenet.png
diff --git a/en/2.9/_images/load-balancer.png b/en/2.9/_images/load-balancer.png
diff --git a/en/2.9/_images/loadbalancer_listing.png b/en/2.9/_images/loadbalancer_listing.png
diff --git a/en/2.9/_images/netris_controller_diagram.png b/en/2.9/_images/netris_controller_diagram.png
diff --git a/en/2.9/_images/new_VNET.png b/en/2.9/_images/new_VNET.png
diff --git a/en/2.9/_images/new_hardware.png b/en/2.9/_images/new_hardware.png
diff --git a/en/2.9/_images/new_kubenet.png b/en/2.9/_images/new_kubenet.png
diff --git a/en/2.9/_images/password.png b/en/2.9/_images/password.png
diff --git a/en/2.9/_images/permission_group.png b/en/2.9/_images/permission_group.png
diff --git a/en/2.9/_images/ping.png b/en/2.9/_images/ping.png
diff --git a/en/2.9/_images/request_L4.png b/en/2.9/_images/request_L4.png
diff --git a/en/2.9/_images/route-map.png b/en/2.9/_images/route-map.png
diff --git a/en/2.9/_images/sandbox-l4lb-kubeapi.png b/en/2.9/_images/sandbox-l4lb-kubeapi.png
diff --git a/en/2.9/_images/sandbox-l4lbs.png b/en/2.9/_images/sandbox-l4lbs.png
diff --git a/en/2.9/_images/sandbox-podinfo-prov.png b/en/2.9/_images/sandbox-podinfo-prov.png
diff --git a/en/2.9/_images/sandbox-podinfo-ready.png b/en/2.9/_images/sandbox-podinfo-ready.png
diff --git a/en/2.9/_images/sandbox_topology.png b/en/2.9/_images/sandbox_topology.png
diff --git a/en/2.9/_images/sandbox_topology_n.png b/en/2.9/_images/sandbox_topology_n.png
diff --git a/en/2.9/_images/saveasnormal.png b/en/2.9/_images/saveasnormal.png
diff --git a/en/2.9/_images/siteDefault.png b/en/2.9/_images/siteDefault.png
diff --git a/en/2.9/_images/softgate_diagram.png b/en/2.9/_images/softgate_diagram.png
diff --git a/en/2.9/_images/softgate_node.png b/en/2.9/_images/softgate_node.png
diff --git a/en/2.9/_images/static_route.png b/en/2.9/_images/static_route.png
diff --git a/en/2.9/_images/subnet_listing.png b/en/2.9/_images/subnet_listing.png
diff --git a/en/2.9/_images/switch_port.png b/en/2.9/_images/switch_port.png
diff --git a/en/2.9/_images/switch_port_statuses.png b/en/2.9/_images/switch_port_statuses.png
diff --git a/en/2.9/_images/telescope.png b/en/2.9/_images/telescope.png
diff --git a/en/2.9/_images/tenants.png b/en/2.9/_images/tenants.png
diff --git a/en/2.9/_images/topology_manager.png b/en/2.9/_images/topology_manager.png
diff --git a/en/2.9/_images/uninstallOS.png b/en/2.9/_images/uninstallOS.png
diff --git a/en/2.9/_images/updateONIE.png b/en/2.9/_images/updateONIE.png
diff --git a/en/2.9/_images/user_role.png b/en/2.9/_images/user_role.png
diff --git a/en/2.9/_images/users.png b/en/2.9/_images/users.png
diff --git a/en/2.9/_images/waiting_approval.png b/en/2.9/_images/waiting_approval.png
diff --git a/en/2.9/_sources/SoftGate-agent-installation.rst.txt b/en/2.9/_sources/SoftGate-agent-installation.rst.txt
@@ -0,0 +1,139 @@
+.. meta::
+  :description: Netris SoftGate Agent Installation
+
+***********************************
+Netris SoftGate agent installation
+***********************************
+Minimal hardware requirements
+=============================
+* 2 x Intel Silver CPU
+* 96 GB RAM
+* 300 GB HDD
+* Nvidia Mellanox Connect-X 5 SmartNIC card
+
+BIOS configuration
+==================
+The following are some recommendations on BIOS settings. Different vendors will have different BIOS naming so the following is mainly for reference:
+
+* Before starting consider resetting all BIOS settings to their defaults.
+* Disable all power saving options such as: Power performance tuning, CPU P-State, CPU C3 Report and CPU C6 Report.
+* Select Performance as the CPU Power and Performance policy.
+* Disable Turbo Boost to ensure the performance scaling increases with the number of cores.
+* Set memory frequency to the highest available number, NOT auto.
+* Disable all virtualization options when you test the physical function of the NIC, and turn off VT-d.
+* Disable Hyper-Threading.
+
+Software installation
+=====================
+Requires freshly installed Ubuntu Linux 18.04 and network connectivity with your Netris Controller over the out-of-band management network.
+
+1. Set environment variables to use Netris Controller as a proxy.
+
+.. code-block:: shell-session
+
+  export http_proxy=http://<Your Netris Controller address>:3128 && export https_proxy=http://<Your Netris Controller address>:3128
+
+  echo -e 'Acquire::http::Proxy "http://<Your Netris Controller address>:3128";\nAcquire::https::Proxy "http://<Your Netris Controller address>:3128";' | sudo tee -a /etc/apt/apt.conf.d/netris-proxy
+
+2. Config the apt for Mellanox repository.
+
+.. code-block:: shell-session
+
+  wget -qO - https://www.mellanox.com/downloads/ofed/RPM-GPG-KEY-Mellanox | sudo apt-key add -
+
+  wget http://linux.mellanox.com/public/repo/mlnx_ofed/5.0-2.1.8.0/ubuntu18.04/mellanox_mlnx_ofed.list -O /tmp/mellanox_mlnx_ofed.list && sudo mv /tmp/mellanox_mlnx_ofed.list /etc/apt/sources.list.d/
+
+3. Config the apt for Netris repository. 
+
+.. code-block:: shell-session
+
+  wget -qO - http://repo.netris.ai/repo/public.key | sudo apt-key add -
+  
+  echo "deb http://repo.netris.ai/repo/ bionic main" | sudo tee /etc/apt/sources.list.d/netris.list
+
+4. Install Mellanox drivers
+
+.. code-block:: shell-session
+
+  sudo apt-get update && sudo apt-get install mlnx-ofed-dpdk
+
+5. Install Netris agent package and dependencies, including specific Linux Kernel version.
+
+.. code-block:: shell-session
+
+  sudo apt-get install netris-dpdk-mlnx
+
+6. Configure Management IP address
+
+Configure out of band management IP address. In case Netris Controller is not in the same OOB network then add a route to Netris Controller. No default route or other IP addresses should be configured. 
+
+.. code-block:: shell-session
+
+  sudo vim /etc/network/interfaces 
+
+.. code-block:: shell-session
+
+  # The loopback network interface
+  auto lo
+  iface lo inet loopback
+
+  # The primary network interface
+  auto eth0
+  iface eth0 inet static
+         address <Management IP address/prefix length>
+         up ip ro add <Controller address> via <Management network gateway> #delete this line if Netris Controller is located in the same network with the SoftGate node.
+
+  source /etc/network/interfaces.d/*
+
+.. code-block:: shell-session
+
+  sudo ifreload -a
+
+7. Initialize the SoftGate
+
+|  netris-setup parameters, described below.
+
+| **--auth** - Authentication key, “6878C6DD88224981967F67EE2A73F092” is the default value, we strongly recommend to change this string in your controller as described in Controller initial configuration section.
+| **--controller** - IP address or domain name of Netris Controller. 
+| **--hostname** - Specify the hostname for the current switch, this hostname should match the name defined for particular switch in the Controller..
+| **--lo** - IP address for the loopback interface, as it is defined in the controller.
+| **--node-prio - brief explanation of node priority goes here**
+|
+| Run netris-setup.
+
+.. code-block:: shell-session
+
+  sudo /opt/netris/bin/netris-setup --lo=<SoftGate loopback IP address as defined in controller>  --controller=<Netris Controller IP or FQDN> --hostname=<node name as defined in controller> --auth=<authentication key> --node-prio=<node priority 1/2>  
+
+Example: Running netris-setup
+
+.. code-block:: shell-session
+
+  netris@ubuntu:~$ sudo /opt/netris/bin/netris-setup --lo=10.254.97.33  --controller=10.254.97.10 --hostname=softgate1 --auth=6a284d55148f81728f932b28e9d020736c8f78e1950b3d576f6e679d90516df1 --node-prio=1
+  * Setup Hostname
+  * Setup Hosts
+  * Setup Keepalived
+  * Setup Collectd
+  * Setup Loopback
+  * Get CPU List
+  * Setup FRR BGP Daemon
+  * Setup Netris Agent Config
+  * Setup DPDK Router Config
+  * Setup DPDK Router Systemd Unit
+  └── └── * Setup Grub Config
+  * Update Grub
+  └── 
+
+| *** ATTENTION: You must reboot SoftGate to complete the installation 
+| netris@ubuntu:~$ 
+|
+
+8. Reboot the server
+
+.. code-block:: shell-session
+
+  sudo reboot
+
+When server boots up, you should see it’s heartbeat status in Net→Inventory
+
+
diff --git a/en/2.9/_sources/accounts.rst.txt b/en/2.9/_sources/accounts.rst.txt
@@ -0,0 +1,64 @@
+.. meta::
+    :description: Netris Controller User Account Management
+
+########
+Accounts
+########
+
+The accounts section is for the management of user accounts, access permissions, and tenants.
+
+Users
+=====
+Description of User account fields:
+
+* **Username** - Unique username.
+* **Full Name** - Full Name of the user. 
+* **E-mail** - The email address of the user. Also used for system notifications and for password retrieval.
+* **E-mail CC** - Send copies of email notifications to this address.
+* **Phone Number** - User’s phone number.
+* **Company** - Company the user works for. Usually useful for multi-tenant systems where the company provides Netris Controller access to customers.
+* **Position** - Position within the company.
+* **User Role** - When using a User Role object to define RBAC (role-based access control), Permissions Group and Tenant fields will deactivate.
+* **Permission Group** - User permissions for viewing and editing parts of the Netris Controller. (if User Role is not used)
+* **+Tenant** - User permissions for viewing and editing services using Switch Port and IP resources assigned to various Tenants. (if User Role is not used)
+
+Example: Creating a user with full access to all sections of Netris Controller, read-only access to resources managed by any Tenant, and full access to resources assigned to the Tenant Admin. 
+
+.. image:: images/users.png
+    :align: center
+
+**Password**: To set a password or email the user for a password form, go to the listing of usernames and click the menu on the right side. 
+
+Example: Listing of user accounts.
+
+
+.. image:: images/password.png
+    :align: center
+
+Tenants
+=======
+IP addresses and Switch Ports are network resources that can be assigned to different Tenants to have under their management. Admin is the default tenant, and by default, it owns all the resources. The concept of Tenants can be used for sharing and delegation of control over the network resources, typically used by network teams to grant access to other teams for requesting & managing network services using the Netris Controller as a self service portal or programmatically (with Kubernetes CRDs) as part of DevOps/NetOps pipeline. 
+
+A Tenant has just two fields, the unique name and custom description.
+
+Example: Adding a tenant.
+
+.. image:: images/tenants.png
+    :align: center
+
+Permission Groups
+=================
+Permission Groups are a list of permissions on a per section basis that can be attached individually to a User or a User Role. Every section has a View and Edit attribute. The view defines if users with this Permission Group can see the particular section at all. Edit defines if users with this Permission Group can edit services and policies in specific sections. 
+
+Example: Permission Group.
+
+.. image:: images/permission_group.png
+    :align: center
+
+User Roles
+==========
+Permission Groups and Tenants can be either linked directly to an individual username or can be linked to a User Role object which then can be linked to an individual username.  
+
+.. image:: images/user_role.png
+    :align: center
+
diff --git a/en/2.9/_sources/concepts.rst.txt b/en/2.9/_sources/concepts.rst.txt
@@ -0,0 +1,44 @@
+.. meta::
+    :description: Netris Core Concepts
+
+########
+Concepts
+########
+
+Introduction to Netris
+======================
+Netris is an automatic netops software for operating physical networks like it is a cloud. Netris automatically configures switching, routing, load-balancing, and network security based on user-defined services and policies. Netris continuously monitors the network's health and either apply software remediation or informs you of necessary actions if human intervention is required. Netris abstracts away the complexities of detailed network configuration, letting you perform efficiently by operating your physical network in a top down approach like a cloud – instead of the legacy box by box operation.
+
+
+What is Netris Controller
+=========================
+Netris Controller is the main operations control center for engineers using GUI/RestAPI/Kubernetes, systems, and network devices. 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). Netris Controller can run as a VM or container, on/off-prem, or in Netris cloud. 
+
+Diagram: High level Netris architecture.
+
+.. image:: images/netris_controller_diagram.png
+    :align: center
+
+* **Controller HA.** We highly recommend running more than one copy of the controller for database replication. 
+* **Multiple sites.** Netris is designed to operate multiple sites with just a single controller with HA.
+* **What if the controller is unreachable.** Netris operated switches/routers can tolerate the unreachability of the Netris Controller. Changes and stats collection will be unavailable during the controller unavailability window; however, switches/routers' core operation will not be affected.
+
+Netris Switch Agent
+===================
+Netris Switch Agent is software running in the user space of the network operating system (NOS) of the switch and is responsible for automatically generating the particular switch configuration according to service requirements and policies defined in the Netris Controller. Netris Switch Agent uses an encrypted GRPC protocol for secure communication with the Netris Controller accessible through a local management network or over the Internet. 
+
+Netris SoftGate
+===============
+Netris SoftGate is automatic configuration software and reference architecture for enabling border routing, Layer-4 Load Balancing, Network Address Translation (NAT), and site-to-site VPN function on a regular x86 server with a SmartNIC card.
+
+Netris SoftGate supports a high-performance DPDK data plane running in the user-space. It configures the system so that packets entering the NIC (network interface card) bypass Linux Kernel and go directly to the user space application. So traffic from the NIC travels through the PCIe bus to the closest CPU’s last level cache and then into one of 8 cores, all reserved for the data-plane application. DPDK data-plane software processes the traffic for routing, load-balancing, NAT and makes necessary changes in the packet header (rewrites mac/VLAN-id) then returns the packet to the NIC, which sends it further into the switch for traveling further in Layer-2. 
+
+The server has to have 2 x Intel CPUs (8+ cores each). One CPU (closest to the SmartNIC card) is reserved for the data-plane process only (OS will report 100% CPU usage). Another CPU is used for running Linux OS, routing control plane (FRR), Netris agent, and other standard Linux utilities. 
+
+Netris agents can also configure Wireguard to form full mesh VPN tunnels between customer sites and then run necessary dynamic routing. So, servers and applications in multiple data centers can communicate over the Internet using encrypted tunnels. 
+
+
+Diagram: Netris SoftGate high level architecture
+
+.. image:: images/softgate_diagram.png
+    :align: center
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		*.pdf filter=lfs diff=lfs merge=lfs -text
		*.epub filter=lfs diff=lfs merge=lfs -text