diff --git a/tutorials/images/acs-dnat-creation.png b/cloudstack/images/acs-dnat-creation.png similarity index 100% rename from tutorials/images/acs-dnat-creation.png rename to cloudstack/images/acs-dnat-creation.png diff --git a/tutorials/images/acs-enable-netris-plugin.png b/cloudstack/images/acs-enable-netris-plugin.png similarity index 100% rename from tutorials/images/acs-enable-netris-plugin.png rename to cloudstack/images/acs-enable-netris-plugin.png diff --git a/tutorials/images/acs-infra-diagram.png b/cloudstack/images/acs-infra-diagram.png similarity index 100% rename from tutorials/images/acs-infra-diagram.png rename to cloudstack/images/acs-infra-diagram.png diff --git a/tutorials/images/acs-inventory-profile.png b/cloudstack/images/acs-inventory-profile.png similarity index 100% rename from tutorials/images/acs-inventory-profile.png rename to cloudstack/images/acs-inventory-profile.png diff --git a/tutorials/images/acs-link-creation.png b/cloudstack/images/acs-link-creation.png similarity index 100% rename from tutorials/images/acs-link-creation.png rename to cloudstack/images/acs-link-creation.png diff --git a/tutorials/images/acs-lo-subnet.png b/cloudstack/images/acs-lo-subnet.png similarity index 100% rename from tutorials/images/acs-lo-subnet.png rename to cloudstack/images/acs-lo-subnet.png diff --git a/tutorials/images/acs-mgmt-subnet.png b/cloudstack/images/acs-mgmt-subnet.png similarity index 100% rename from tutorials/images/acs-mgmt-subnet.png rename to cloudstack/images/acs-mgmt-subnet.png diff --git a/tutorials/images/acs-mng-cloudbr0-vnet.png b/cloudstack/images/acs-mng-cloudbr0-vnet.png similarity index 100% rename from tutorials/images/acs-mng-cloudbr0-vnet.png rename to cloudstack/images/acs-mng-cloudbr0-vnet.png diff --git a/tutorials/images/acs-mng-hyper-subnet.png b/cloudstack/images/acs-mng-hyper-subnet.png similarity index 100% rename from tutorials/images/acs-mng-hyper-subnet.png rename to cloudstack/images/acs-mng-hyper-subnet.png diff --git a/tutorials/images/acs-mng-mgmt-vnet.png b/cloudstack/images/acs-mng-mgmt-vnet.png similarity index 100% rename from tutorials/images/acs-mng-mgmt-vnet.png rename to cloudstack/images/acs-mng-mgmt-vnet.png diff --git a/tutorials/images/acs-private-allocation.png b/cloudstack/images/acs-private-allocation.png similarity index 100% rename from tutorials/images/acs-private-allocation.png rename to cloudstack/images/acs-private-allocation.png diff --git a/tutorials/images/acs-public-allocation.png b/cloudstack/images/acs-public-allocation.png similarity index 100% rename from tutorials/images/acs-public-allocation.png rename to cloudstack/images/acs-public-allocation.png diff --git a/tutorials/images/acs-public-nat-subnet.png b/cloudstack/images/acs-public-nat-subnet.png similarity index 100% rename from tutorials/images/acs-public-nat-subnet.png rename to cloudstack/images/acs-public-nat-subnet.png diff --git a/tutorials/images/acs-server2-creation.png b/cloudstack/images/acs-server2-creation.png similarity index 100% rename from tutorials/images/acs-server2-creation.png rename to cloudstack/images/acs-server2-creation.png diff --git a/tutorials/images/acs-server2-link-edit.png b/cloudstack/images/acs-server2-link-edit.png similarity index 100% rename from tutorials/images/acs-server2-link-edit.png rename to cloudstack/images/acs-server2-link-edit.png diff --git a/tutorials/images/acs-server2-one-liner.png b/cloudstack/images/acs-server2-one-liner.png similarity index 100% rename from tutorials/images/acs-server2-one-liner.png rename to cloudstack/images/acs-server2-one-liner.png diff --git a/tutorials/images/acs-snat-creation.png b/cloudstack/images/acs-snat-creation.png similarity index 100% rename from tutorials/images/acs-snat-creation.png rename to cloudstack/images/acs-snat-creation.png diff --git a/tutorials/images/acs-system-vms-subnet.png b/cloudstack/images/acs-system-vms-subnet.png similarity index 100% rename from tutorials/images/acs-system-vms-subnet.png rename to cloudstack/images/acs-system-vms-subnet.png diff --git a/tutorials/images/acs-system-vms-vnet.png b/cloudstack/images/acs-system-vms-vnet.png similarity index 100% rename from tutorials/images/acs-system-vms-vnet.png rename to cloudstack/images/acs-system-vms-vnet.png diff --git a/tutorials/images/acs-topology-link-edit.png b/cloudstack/images/acs-topology-link-edit.png similarity index 100% rename from tutorials/images/acs-topology-link-edit.png rename to cloudstack/images/acs-topology-link-edit.png diff --git a/tutorials/images/acs-wizard-launch-zone.png b/cloudstack/images/acs-wizard-launch-zone.png similarity index 100% rename from tutorials/images/acs-wizard-launch-zone.png rename to cloudstack/images/acs-wizard-launch-zone.png diff --git a/tutorials/images/acs-wizard-netris-details.png b/cloudstack/images/acs-wizard-netris-details.png similarity index 100% rename from tutorials/images/acs-wizard-netris-details.png rename to cloudstack/images/acs-wizard-netris-details.png diff --git a/tutorials/images/acs-wizard-physical-network.png b/cloudstack/images/acs-wizard-physical-network.png similarity index 100% rename from tutorials/images/acs-wizard-physical-network.png rename to cloudstack/images/acs-wizard-physical-network.png diff --git a/tutorials/images/acs-wizard-pod1-details.png b/cloudstack/images/acs-wizard-pod1-details.png similarity index 100% rename from tutorials/images/acs-wizard-pod1-details.png rename to cloudstack/images/acs-wizard-pod1-details.png diff --git a/tutorials/images/acs-wizard-public-netris-pool.png b/cloudstack/images/acs-wizard-public-netris-pool.png similarity index 100% rename from tutorials/images/acs-wizard-public-netris-pool.png rename to cloudstack/images/acs-wizard-public-netris-pool.png diff --git a/tutorials/images/acs-wizard-public-network1.png b/cloudstack/images/acs-wizard-public-network1.png similarity index 100% rename from tutorials/images/acs-wizard-public-network1.png rename to cloudstack/images/acs-wizard-public-network1.png diff --git a/tutorials/images/acs-wizard-public-network2.png b/cloudstack/images/acs-wizard-public-network2.png similarity index 100% rename from tutorials/images/acs-wizard-public-network2.png rename to cloudstack/images/acs-wizard-public-network2.png diff --git a/tutorials/images/acs-wizard-vxlan-range.png b/cloudstack/images/acs-wizard-vxlan-range.png similarity index 100% rename from tutorials/images/acs-wizard-vxlan-range.png rename to cloudstack/images/acs-wizard-vxlan-range.png diff --git a/tutorials/images/acs-wizard-zone-details.png b/cloudstack/images/acs-wizard-zone-details.png similarity index 100% rename from tutorials/images/acs-wizard-zone-details.png rename to cloudstack/images/acs-wizard-zone-details.png diff --git a/tutorials/netris-cloudstack.rst b/cloudstack/netris-cloudstack.rst similarity index 100% rename from tutorials/netris-cloudstack.rst rename to cloudstack/netris-cloudstack.rst diff --git a/tutorials/netris-cloudstack_p1.rst b/cloudstack/netris-cloudstack_p1.rst similarity index 100% rename from tutorials/netris-cloudstack_p1.rst rename to cloudstack/netris-cloudstack_p1.rst diff --git a/tutorials/netris-cloudstack_p2.rst b/cloudstack/netris-cloudstack_p2.rst similarity index 99% rename from tutorials/netris-cloudstack_p2.rst rename to cloudstack/netris-cloudstack_p2.rst index f1307bf9..8c10a21c 100644 --- a/tutorials/netris-cloudstack_p2.rst +++ b/cloudstack/netris-cloudstack_p2.rst @@ -4,9 +4,7 @@ Prerequisites ============= -`Switch fabric up & running `_ - -`ISP upstreams connected through BGP `_ +:doc:`Switch fabric up & running ` and :ref:`connected to ISP ` Step-by-Step Configuration Instructions for the Netris Controller ----------------------------------------------------------------- diff --git a/tutorials/netris-cloudstack_p3.rst b/cloudstack/netris-cloudstack_p3.rst similarity index 100% rename from tutorials/netris-cloudstack_p3.rst rename to cloudstack/netris-cloudstack_p3.rst diff --git a/tutorials/netris-cloudstack_p4.rst b/cloudstack/netris-cloudstack_p4.rst similarity index 100% rename from tutorials/netris-cloudstack_p4.rst rename to cloudstack/netris-cloudstack_p4.rst diff --git a/tutorials/netris-cloudstack_p5.rst b/cloudstack/netris-cloudstack_p5.rst similarity index 100% rename from tutorials/netris-cloudstack_p5.rst rename to cloudstack/netris-cloudstack_p5.rst diff --git a/definitions.rst b/definitions.rst index 678e8be7..7264b2de 100644 --- a/definitions.rst +++ b/definitions.rst @@ -9,7 +9,12 @@ When configuring and operating a Netris system, the following nomenclature is im * **User** - A user account for accessing Netris Controller through GUI, RestAPI, and Kubernetes. The default username is ``netris``, with password ``newNet0ps``. -* **The Netris VPC** - logically segregated virtual network.The VPC acts as a VRF in traditional networking, providing the flexibility to employ overlapping IP ranges across various VPCs while maintaining secure management and operation of resources. +* **Netris VPC** - logically segregated virtual network.The VPC acts as a VRF in traditional networking, providing the flexibility to employ overlapping IP ranges across various VPCs while maintaining secure management and operation of resources. + +* **V-Net (Virtual Network)** is a Netris construct for grouping switch ports into a defined network segment—much like a traditional VLAN or a public cloud subnet. It is a virtual networking service that provides Layer-2 (unrouted) or Layer-3 (routed) virtual network segments in a Netris VPC. V-Net is assigned to one VPC and one or multiple sites. Your endpoints (servers, VMs) are connected to V-Nets. + + * **L2VPN (Layer 2 Virtual Private Network)** is a V-Net type and is similar to a traditional VLAN with modern and scalable implementation. + * **L3VPN** is a V–Net type and is typically used for back-end (east–west) connectivity in GPU clusters on Ethernet-based AI fabrics such as NVIDIA Spectrum-X. Built as one mini-subnet per switch port, a VXLAN L3VPN is conceptually similar to MPLS L3VPN in provider networks. * **Tenant** - IP addresses and Switch Ports are network resources assigned to different Tenants to have under their management. Admin is the default tenant, and by default, it owns all the resources. You can use different Tenants for sharing and delegation of control over the network resources. Network teams typically use Tenants to grant access to other groups to request and manage network services using the Netris Controller as a self-service portal or programmatically (with Kubernetes CRDs or Terraform) via a DevOps/NetOps pipeline. @@ -17,7 +22,9 @@ When configuring and operating a Netris system, the following nomenclature is im * **User Role** - Group of user permissions and tenants for role-based access control (RBAC). -* **Site** - Each separate deployment (each data center) should be defined as a Site. All network units and resources are attached to a site. Site entry defines global attributes such as; AS numbers, default ACL policy, Site Mesh (site to site VPN), and other site-level parameters. +* **Site** - Each separate deployment (a region or a data center) should be defined as a Site. All network components and resources should be associated with their respective Site and VPC. Site entry defines global attributes such as; AS numbers, default ACL policy, and other site-level parameters. + +* **IPAM** - You can create IP Allocations and Subnet assignments for a VPC. These may overlap between different VPCs. A Subnet can be assigned to multiple sites if you aim to extend your V-Net to multiple locations. * **Subnet** - IPv4/IPv6 address resources linked to *Sites* and *Tenants* @@ -25,4 +32,12 @@ When configuring and operating a Netris system, the following nomenclature is im * **Inventory** - Inventory of all network units that are operated using Netris Agent. +* **External connections** - You can connect your VPC to ISP providers or other segments of your network using Netris E-BGP service, or statically by defining a V-Net and using Net->Routes (for natively integrated Bare Metal Cloud Providers please refer to the provider-specific tutorial, as external connections usually establish automatically + * **E-BGP** - Defines all External BGP peers (iBGP and eBGP). + +* **NAT services** - SNAT allows your endpoints to communicate with the Internet. DNAT allows your endpoints to be accessible from the Internet. + +* **Load-balancing service** - Use L4LB service to share the load between your endpoints. + +* **Access lists** - ACLs provide a layer of security that acts as a firewall for controlling traffic in and out of one or more subnets. diff --git a/images/add-new-hardware.png b/images/add-new-hardware.png deleted file mode 100644 index 5e00df64..00000000 Binary files a/images/add-new-hardware.png and /dev/null differ diff --git a/images/allocation.png b/images/allocation.png deleted file mode 100644 index 81a76478..00000000 Binary files a/images/allocation.png and /dev/null differ diff --git a/images/allocation_empty.png b/images/allocation_empty.png deleted file mode 100644 index 2115fc59..00000000 Binary files a/images/allocation_empty.png and /dev/null differ diff --git a/images/bgp_empty.png b/images/bgp_empty.png deleted file mode 100644 index 9e5243f5..00000000 Binary files a/images/bgp_empty.png and /dev/null differ diff --git a/tutorials/images/bgp_status.png b/images/bgp_status.png similarity index 100% rename from tutorials/images/bgp_status.png rename to images/bgp_status.png diff --git a/images/create_dnat_empty.png b/images/create_dnat_empty.png deleted file mode 100644 index 8e4313d5..00000000 Binary files a/images/create_dnat_empty.png and /dev/null differ diff --git a/images/create_link.png b/images/create_link.png deleted file mode 100644 index e951e381..00000000 Binary files a/images/create_link.png and /dev/null differ diff --git a/images/create_snat_empty.png b/images/create_snat_empty.png deleted file mode 100644 index 61c0fe86..00000000 Binary files a/images/create_snat_empty.png and /dev/null differ diff --git a/tutorials/images/dnat_add.png b/images/dnat_add.png similarity index 100% rename from tutorials/images/dnat_add.png rename to images/dnat_add.png diff --git a/tutorials/images/install_agent.gif b/images/install_agent.gif similarity index 100% rename from tutorials/images/install_agent.gif rename to images/install_agent.gif diff --git a/tutorials/images/inventory_switch.png b/images/inventory_switch.png similarity index 100% rename from tutorials/images/inventory_switch.png rename to images/inventory_switch.png diff --git a/tutorials/images/ipam_allocation.png b/images/ipam_allocation.png similarity index 100% rename from tutorials/images/ipam_allocation.png rename to images/ipam_allocation.png diff --git a/tutorials/images/ipam_common_subnet.png b/images/ipam_common_subnet.png similarity index 100% rename from tutorials/images/ipam_common_subnet.png rename to images/ipam_common_subnet.png diff --git a/tutorials/images/ipam_l4lb_subnet.png b/images/ipam_l4lb_subnet.png similarity index 100% rename from tutorials/images/ipam_l4lb_subnet.png rename to images/ipam_l4lb_subnet.png diff --git a/tutorials/images/ipam_loopback_subnet.png b/images/ipam_loopback_subnet.png similarity index 100% rename from tutorials/images/ipam_loopback_subnet.png rename to images/ipam_loopback_subnet.png diff --git a/tutorials/images/ipam_mgmt_subnet.png b/images/ipam_mgmt_subnet.png similarity index 100% rename from tutorials/images/ipam_mgmt_subnet.png rename to images/ipam_mgmt_subnet.png diff --git a/tutorials/images/ipam_nat_subnet.png b/images/ipam_nat_subnet.png similarity index 100% rename from tutorials/images/ipam_nat_subnet.png rename to images/ipam_nat_subnet.png diff --git a/tutorials/images/l4lb_create.png b/images/l4lb_create.png similarity index 100% rename from tutorials/images/l4lb_create.png rename to images/l4lb_create.png diff --git a/images/nat_subnet_empty.png b/images/nat_subnet_empty.png deleted file mode 100644 index 01c3bfc8..00000000 Binary files a/images/nat_subnet_empty.png and /dev/null differ diff --git a/tutorials/images/netris_version_example.png b/images/netris_version_example.png similarity index 100% rename from tutorials/images/netris_version_example.png rename to images/netris_version_example.png diff --git a/images/request-L4.png b/images/request-L4.png deleted file mode 100644 index 8e73cf8b..00000000 Binary files a/images/request-L4.png and /dev/null differ diff --git a/tutorials/images/site_setup.png b/images/site_setup.png similarity index 100% rename from tutorials/images/site_setup.png rename to images/site_setup.png diff --git a/tutorials/images/snat_add.png b/images/snat_add.png similarity index 100% rename from tutorials/images/snat_add.png rename to images/snat_add.png diff --git a/images/subnet_empty.png b/images/subnet_empty.png deleted file mode 100644 index 0dd21f1a..00000000 Binary files a/images/subnet_empty.png and /dev/null differ diff --git a/images/subnet_listing.png b/images/subnet_listing.png deleted file mode 100644 index fc7a6a62..00000000 Binary files a/images/subnet_listing.png and /dev/null differ diff --git a/tutorials/images/topology.png b/images/topology.png similarity index 100% rename from tutorials/images/topology.png rename to images/topology.png diff --git a/images/topology_2.png b/images/topology_2.png deleted file mode 100644 index e8ef0281..00000000 Binary files a/images/topology_2.png and /dev/null differ diff --git a/tutorials/images/topology_completed.png b/images/topology_completed.png similarity index 100% rename from tutorials/images/topology_completed.png rename to images/topology_completed.png diff --git a/tutorials/images/topology_create_link.png b/images/topology_create_link.png similarity index 100% rename from tutorials/images/topology_create_link.png rename to images/topology_create_link.png diff --git a/tutorials/images/vpc_add.png b/images/vpc_add.png similarity index 100% rename from tutorials/images/vpc_add.png rename to images/vpc_add.png diff --git a/index.rst b/index.rst index 8cbb7c31..04462ce1 100644 --- a/index.rst +++ b/index.rst @@ -14,17 +14,18 @@ You are welcome to join our community Slack channel (see button at the top) to g :maxdepth: 2 :caption: General Information - definitions introduction supported-platform-matrix supported-switch-hardware netris-architecture + definitions .. toctree:: :maxdepth: 2 :caption: Try & Learn Netris - try-learn/index + try-learn/nvidia-spectrum-x-scenario + try-learn/onprem-k8s .. toctree:: :maxdepth: 2 @@ -33,11 +34,13 @@ You are welcome to join our community Slack channel (see button at the top) to g installation/installation switch-agent-installation netris-softgate-HS + ai-netris-host-networking .. toctree:: :maxdepth: 2 :caption: Fabric Management + site topology-management network-policies switch-ports @@ -62,7 +65,7 @@ You are welcome to join our community Slack channel (see button at the top) to g netris-ufm-integration netris-nvlink-integration kubernetes-integration - tutorials/netris-cloudstack + cloudstack/netris-cloudstack terraform-integration evpn-on-host @@ -75,12 +78,12 @@ You are welcome to join our community Slack channel (see button at the top) to g monitoring-observability/healthchecks .. toctree:: - :maxdepth: 2 + :maxdepth: 0 :caption: Tutorials + vpc-gateways-with-managed-fabric.rst + cloudstack/netris-cloudstack ai-netris-host-networking - vpc - tutorials/vpc-gateways-with-managed-fabric.rst .. toctree:: :maxdepth: 4 diff --git a/introduction.rst b/introduction.rst index af5b6d2c..6d37b0b5 100644 --- a/introduction.rst +++ b/introduction.rst @@ -6,6 +6,8 @@ Introduction to Netris Netris is a network automation and abstraction software for cloud builders. Netris brings cloud-like VPC abstractions 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 applies 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. +Netris :doc:`SoftGate `, also known as VPC gateway, provides Network Services and is an optional, multi-tenant (VPC-aware) software component designed for cloud providers and scales horizontally to provide this ingress and egress connectivity. The SoftGate software runs on a dedicated set of operator-provided bare-metal x86 servers and is tightly integrated with the Netris-managed North-South fabric. + .. image:: images/private-cloud-enterprise-dc-2.png :align: center diff --git a/l4-load-balancer.rst b/l4-load-balancer.rst index 63de30d5..778670b2 100644 --- a/l4-load-balancer.rst +++ b/l4-load-balancer.rst @@ -6,7 +6,7 @@ ####################### L4 Load Balancer (L4LB) ####################### -Netris L4 Load Balancer (L4LB) leverages SoftGate(Linux router) nodes to provide Layer-4 load balancing services, including on-demand cloud load balancing with native integration with Kubernetes. +Netris L4 Load Balancer (L4LB) leverages SoftGate(Linux router) nodes to provide Layer-4 load balancing services, including on-demand cloud load balancing with native integration with :doc:`Kubernetes ` and :doc:`Terraform `. Enabling L4LB service --------------------- @@ -69,10 +69,10 @@ Add new L4 Load Balancer fields are described below: * **Port** - Service port on the backend host. * **Enabled** - Administrative state of particular backend. -.. image:: images/request-L4.png +.. image:: images/l4lb_create.png :align: center :class: with-shadow - :alt: Request an L4 Load Balancer + :alt: Create an L4 Load Balancer Example: Requesting an L4 Load Balancer service. diff --git a/network-policies.rst b/network-policies.rst index 8afd02bd..7e6bb656 100644 --- a/network-policies.rst +++ b/network-policies.rst @@ -1,13 +1,24 @@ .. meta:: :description: Netris Network Policies & Protocol Configuration -### -VPC -### +.. _vpc_def: + +====================== +Netris VPC +====================== + +The Netris VPC offers you the ability to operate your resources within a logically segregated virtual network. You can create, edit, and remove VPCs as needed. The VPC acts as a VRF in traditional networking, providing the flexibility to employ overlapping IP ranges across various VPCs while maintaining secure management and operation of resources. Netris Controller is preconfigured with a default system VPC-1. Use the default VPC, and create additional VPCs as needed in the future. -The VPC acts as a VRF in traditional networking, providing the ability to use overlapping IP ranges across various VPCs while maintaining safe management and operation of services. +The following diagram shows a VPC concept in the Netris Controller. + +.. image:: images/vpc_diagram.png + :align: center + :alt: VPC diagram + +VPC is the highest entity in the hierarchy and it spreads over all Sites. +Take a look at the VPC features and services. VPC can be created in the Network → VPC section. @@ -17,15 +28,14 @@ Adding new VPC 1. Navigate to Network → VPC in the web UI. 2. Click Add button. -.. image:: images/vpc_empty.png +.. image:: images/vpc_add.png :align: center .. _ipam_def_vpc: - -##################### +====================== IP Address Management -##################### +====================== Netris IPAM allows users to document their IP addresses and track pool usage. It is designed to have a tree-like view to provide opportunity to perform any kind of subnetting. @@ -37,9 +47,13 @@ Each VPC has its own IPAM table. Allocations and Subnets ----------------------- -There are 2 main types of IP prefixes - **allocation** and **subnet**. +There are 2 types of IPAM objects: + +* **Allocations** are IP ranges allocated to an organization via RIR/LIR or private IP ranges that are going to be used by the network. +* **Subnets** are prefixes which are going to be used in services. Subnets are always children of allocations. Allocations do not have parent subnets. -Allocations are IP ranges allocated to an organization via RIR/LIR or private IP ranges that are going to be used by the network. Subnets are prefixes which are going to be used in services. Subnets are always children of allocations. Allocations do not have parent subnets. +IPAM Tree View +-------------------------- .. image:: images/ipam_tree_new.png @@ -51,9 +65,6 @@ Allocations are IP ranges allocated to an organization via RIR/LIR or private IP
-IPAM Tree View --------------------------- - Add an Allocation ----------------- @@ -77,24 +88,58 @@ Add an Allocation * - Tenant - Owner of the allocation. -.. image:: images/allocation_empty.png +.. image:: images/ipam_allocation.png :align: center :class: with-shadow :alt: Add a New IP Allocation -Add Allocation Window +.. raw:: html --------------------------- +
Add a Subnet ------------ +**Create subnets for devices** + +You will require two subnets for your devices: one for loopback IP addresses and another for the management network. Note that device subnets must reside in the System VPC. + #. Navigate to Network → IPAM #. Click the **Add** button #. Select **Subnet** from the bottom select box #. Fill in the rest of the fields based on the requirements listed below #. Click the **Add** button +.. image:: images/ipam_mgmt_subnet.png + :align: center + +.. image:: images/ipam_loopback_subnet.png + :align: center + +**Create subnets for V-Nets** + +Create at least one subnet with the Common purpose to use it for a new V-Net. IP addresses from this subnet will be assigned to your servers. + +.. image:: images/ipam_common_subnet.png + :align: center + + +**Create subnets for Load-balancing service** + +If you plan to use load-balancing services, you should first define subnet(s) from which IP addresses will be assigned for Virtual IP (frontend). + +.. image:: images/ipam_l4lb_subnet.png + :align: center + + +.. _ipam_nat_subnet: + +**Create subnets for NAT service** + +If you plan to perform network address translation (NAT), you must first create subnets for this purpose. + +.. image:: images/ipam_nat_subnet.png + :align: center .. list-table:: Subnet fields :widths: 25 50 @@ -118,24 +163,19 @@ Add a Subnet - *nat* - hosts of this subnet or subnet itself can be used to define NAT services. - *inactive* - can't be used in any services, useful for reserving/documenting prefixes for future use. -.. image:: images/subnet_empty.png - :align: center - :alt: Add a New Subnet - :class: with-shadow - -Add Subnet Window - - .. _bgp_def: -######### +====================== +BGP +====================== + Basic BGP -######### +--------- BGP neighbors can be declared in the Network → E-BGP section. Netris software will automatically generate and program the network configuration to meet the requirements. -Adding BGP Peers ----------------- +**Adding BGP Peers** + #. Navigate to Network → E-BGP in the web UI. #. Click the Add button. #. Fill in the fields as described in the table below. @@ -149,12 +189,16 @@ Adding BGP Peers Example: Declare a basic BGP neighbor. -.. image:: images/bgp_empty.png +.. image:: images/create_bgp.png + :align: center + +If everything is correct, State, port and BGP will get green status. + +.. image:: images/bgp_status.png :align: center -############ Advanced BGP -############ +------------ BGP neighbor declaration can optionally include advanced BGP attributes and BGP route-maps for fine-tuning of BGP policies. @@ -166,7 +210,6 @@ Click Advanced to expand the BGP neighbor add/edit window. :widths: 25, 75, 25 :header-rows: 0 --------------------------- BGP Objects ----------- @@ -220,7 +263,7 @@ Example: Creating community. .. image:: images/community.png :align: center --------------------------- + BGP route-maps -------------- @@ -248,7 +291,6 @@ Example: route-map :align: center :class: with-shadow --------------------------- eBGP Importing Non-Default Routes into a VPC ----------------------------------------------- @@ -328,20 +370,20 @@ Alternatively, the external BGP speaker can set the 0:7 community on outbound up This is useful when the upstream router is under the customer's control and managing policy from that side is preferred. -############## +====================== Static Routing -############## +====================== Located under Network → Routes is a method for describing static routing policies that Netris will dynamically inject on switches and/or SoftGate where appropriate. We recommend using the Routes only if BGP is not supported by the remote end. -| Typical use cases for static routing: +Typical use cases for static routing: * To connect the switch fabric to an ISP or upstream router in a situation where BGP and dual-homing are not supported. * Temporary interconnection with the old network for a migration. * Routing a subnet behind a VM hypervisor machine for an internal VM network. * Specifically routing traffic destined to a particular prefix through an out-of-band management network. -| Add new static route fields description: +Add new static route fields description: * **Prefix** - Route destination to match. * **Next-Hop** - Traffic destined to the Prefix will be routed towards the Next-Hop. Note that static routes will be injected only on units that have the Next-Hop as a connected network. @@ -367,35 +409,34 @@ Screenshot shows that the back route is actually applied on Softgate1 and Softga .. image:: images/static_route3.png :align: center --------------------------- .. _nat_def: -### +====================== NAT -### +====================== -Netris SoftGate nodes are required forNAT (Network Address Translation) functionality to work. - -**Note: works only in the system default VPC (limitation is planned to be lifted in Netris v. 4.1.0).** +If you utilize private address space for your hosts, you may need a NAT service to enable internet access. Netris SoftGate nodes are required for NAT (Network Address Translation) functionality to work and support SNAT, DNAT and Masquerade features. Enabling NAT ------------ -To enable NAT for a given site, you first need to create a subnet with NAT purpose in the IPAM section. The NAT IP addresses can be used for SNAT or DNAT as a global IP address (the public IP visible on the Internet). NAT IP pools are IP address ranges that SNAT can use as a rolling global IP (for a larger scale, similar to carrier-grade SNAT). SNAT is always overloading the ports, so many local hosts can share one or just a few public IP addresses. You can add as many NAT IP addresses and NAT pools as you need. +To enable NAT for a given site, you first need to :ref:`create a subnet with NAT purpose ` in the IPAM section. The NAT IP addresses can be used for SNAT or DNAT as a global IP address (the public IP visible on the Internet). NAT IP pools are IP address ranges that SNAT can use as a rolling global IP (for a larger scale, similar to carrier-grade SNAT). SNAT is always overloading the ports, so many local hosts can share one or just a few public IP addresses. You can add as many NAT IP addresses and NAT pools as you need. Adding an IP Subnet under Network → IPAM. +Defining NAT rules +------------------ +NAT rules are defined under Network → NAT. -1. Allocate a public IP subnet for NAT under Net→IPAM. - -Example: Adding an IP allocation under Net→Subnets. +Example: SNAT all hosts on 10.0.1.0/24subnet to the Internet using 192.0.2.128as a global IP. -.. image:: images/nat_subnet_empty.png +.. image:: images/snat_add.png :align: center +Example: Port forwarding. DNAT the traffic destined to 192.0.2.130:8080 to be forwarded to the host 10.0.1.100 on port tcp/80. + +.. image:: images/dnat_add.png + :align: center -Defining NAT rules ------------------- -NAT rules are defined under Network → NAT. .. list-table:: NAT Rule Fields :widths: 25 75 @@ -434,21 +475,9 @@ NAT rules are defined under Network → NAT. - Free optional comment. -Example: SNAT all hosts on 10.0.1.0/24subnet to the Internet using 192.0.2.128as a global IP. - -.. image:: images/create_snat_empty.png - :align: center - -Example: Port forwarding. DNAT the traffic destined to 192.0.2.130:8080 to be forwarded to the host 10.0.1.100 on port tcp/80. - -.. image:: images/create_dnat_empty.png - :align: center - --------------------------- - -############# +====================== Looking Glass -############# +====================== The Looking Glass Is a GUI-based tool for looking up routing information from a switch or SoftGate perspective. You can access the Looking Glass either from Topology, individually for every device (right click on device → details → Looking Glass), or by navigating to Network → Looking Glass then selecting the device from the top-left dropdown menu. @@ -494,9 +523,9 @@ Example: EVPN routing information listing for a specified route distinguisher. .. image:: images/lg_rd.png :align: center -############ +====================== VPC Peering -############ +====================== VPC peering allows routing between two VPCs. It is typically used to connect a tenant VPC to a "shared" VPC where the shared services (like storage access, DNS, etc.) are located. diff --git a/tutorials/new-site-setup.rst b/site.rst similarity index 91% rename from tutorials/new-site-setup.rst rename to site.rst index af39a1cf..a8e78e26 100644 --- a/tutorials/new-site-setup.rst +++ b/site.rst @@ -1,5 +1,5 @@ ############## -New Site setup +Netris Site ############## For each individual deployment, region, location, data center, etc. you should define it as a Site. All network components and resources should be associated with their respective Site and VPC. @@ -14,6 +14,6 @@ Network → Sites → +Add If you're implementing the Zero Trust security model, you may want to select the ACL Default Policy "Deny." More details can be found :doc:`here`. -.. image:: /tutorials/images/site_setup.png +.. image:: images/site_setup.png :align: center diff --git a/supported-platform-matrix.rst b/supported-platform-matrix.rst index bace497b..7b5e1eb3 100644 --- a/supported-platform-matrix.rst +++ b/supported-platform-matrix.rst @@ -5,7 +5,7 @@ Netris Supported Functionality & Platforms Matrix Switch Fabric Management Functions ================================== .. list-table:: - :header-rows: 0 + :header-rows: 1 * - Function - Description @@ -75,12 +75,6 @@ Switch Fabric Management Functions - TBD - ✔ - ✔ - * - Compute VXLAN/EVPN extension (EOH) - - Extend VXLAN/EVPN fabric into compute layer. See Compute integrations section below. - - ✔ - - ✔ - - TBD - - TBD * - ZTP - Zero-touch provisioning of the NOS & Netris agent - Coming Soon @@ -106,10 +100,38 @@ Switch Fabric Management Functions - ✔ - TBD + +Host Networking +============================================= + +.. list-table:: + :header-rows: 1 + + * - Function + - Description + - NVIDIA Cumulus + - Dell-SONiC + + BCM-SONiC + - Arista EOS + - EdgeCore-SONiC + * - HBN (Host Based Networking) for BlueFIeld DPUs + - Layer-4 container or vm/server load balancer with health checks. + - ✔ + - ✔ + - ✔ + - ✔ + * - :doc:`Compute VXLAN/EVPN extension (EOH) ` + - Extend VXLAN/EVPN fabric into compute layer. See Compute integrations section below. + - ✔ + - ✔ + - TBD + - TBD + Monitoring & Telemetry ================================== .. list-table:: - :header-rows: 0 + :header-rows: 1 * - Function - Description @@ -143,7 +165,7 @@ Monitoring & Telemetry - ✔ - ✔ - ✔ - * - Topology Validation + * - :doc:`Topology Validation ` - Detect wiring errors switch-to-switch & switch-to-SoftGate. - ✔ - ✔ @@ -155,13 +177,15 @@ Monitoring & Telemetry - ✔ - ✔ - ✔ - * - NVIDIA NetQ integration + * - :doc:`NVIDIA NetQ integration ` - Activate NVIDIA NetQ Blueprint through Netris topology - ✔ - N/A - N/A - N/A +See :doc:`monitoring-observability/healthchecks` for more details on monitoring and telemetry features. + External Routing Functions ========================== @@ -229,7 +253,7 @@ Cloud Networking Functions & Constructs - ✔ - ✔ - ✔ - * - Server Cluster (Profiling) + * - :doc:`Server Cluster (Profiling) ` - Create network constructs template, then apply it on groups of servers. - ✔ - ✔ @@ -299,19 +323,19 @@ Overlay Network Functions - ✔ - TBD - ✔ - * - EVPN-MH / VXLAN-ESI + * - :doc:`EVPN-MH / VXLAN-ESI ` - EVPN MultiHoming based on VXLAN and ESI for automatic Active-Active server network multihoming - ✔ - ✔ - ✔ - TBD - * - LACP + * - :doc:`LACP ` - Link Aggregation or Active-Standby server multihoming. - ✔ - ✔ - ✔ - TBD - * - MC-LAG + * - :doc:`MC-LAG ` - Traditional MC-LAG-based server multihoming - ✔ - TBD @@ -367,7 +391,7 @@ AI Specific Functions - N/A - TBD - ✔ - - Coming Soon + - N/A * - SuperNIC auto-configuration for RoCE - Automatically configure IP addresses, routing, RoCE and other SuperNIC specific configuration on GPU servers - ✔ @@ -428,7 +452,7 @@ Security - ✔ - ✔ - ✔ - * - Managed Device Profiling + * - :doc:`Managed Device Profiling ` - Managed switch & SoftGate protection from unwanted access, push administrative and system settings (NTP, DNS, timezone, etc.) - ✔ - ✔ @@ -451,7 +475,7 @@ Netris Controller Administration * - Function - Description - Globally - * - Role Based Access Control + * - :doc:`Role Based Access Control ` - Who can view and edit which aspects of the system. - ✔ * - Tenant RBAC @@ -463,7 +487,7 @@ Netris Controller Administration * - HA Controller - 3-node, HA Netris Controller cluster - ✔ - * - Air Gapped setup + * - :doc:`Air Gapped setup ` - Run Netris controller in Air Gapped environment and host switch & SoftGate software for local install. - ✔ @@ -486,28 +510,6 @@ Management Interfaces - Manage your infrastructure as a code using Terraform. - ✔ - -Host Networking -============================================= - -.. list-table:: - :header-rows: 1 - - * - Function - - Description - - NVIDIA Cumulus - - Dell-SONiC - - BCM-SONiC - - Arista EOS - - EdgeCore-SONiC - * - HBN (Host Based Networking) for BlueFIeld DPUs - - Layer-4 container or vm/server load balancer with health checks. - - ✔ - - ✔ - - ✔ - - ✔ - ============================================ Netris and NOS versions compatibility matrix ============================================ @@ -585,3 +587,5 @@ Netris and NOS versions compatibility matrix - Ubuntu 20.04 - N/A - ✔ + +See :doc:`release-notes/index` for more details on Netris releases. \ No newline at end of file diff --git a/topology-management.rst b/topology-management.rst index 944fbac9..5ee04307 100644 --- a/topology-management.rst +++ b/topology-management.rst @@ -12,6 +12,9 @@ The Inventory section allows you to add/edit/delete network switches and SoftGat #. Adding Switches. #. Adding Softgates. +.. note:: + You can also add new devices in the Topology view. + .. _topology-management-adding-switches: Adding Switches @@ -31,7 +34,7 @@ Every switch needs to be added to the Netris Controller inventory. You can add n **Example:** Add a new Switch. - .. image:: images/add-new-hardware.png + .. image:: images/inventory_switch.png :align: center .. note:: Repeat this process to define all your switches. @@ -44,11 +47,13 @@ Every SoftGate node needs to be added to the Netris Controller inventory. The installation process for SoftGate HS is described in the :ref:`SoftGate HS installation ` section. +.. _topology-manager: + ================ Topology Manager ================ -The topology manager is for describing and monitoring the desired network topology. Netris Switch Agents software will automatically configure the underlying network devices according to this topology and will watch against potential failures. +The topology manager is used for describing and monitoring the desired network topology. Netris Switch Agents software will automatically configure the underlying network devices according to this topology and will watch against potential failures. Wire your switches in accordance with the topology view. Adding Links ============ @@ -61,11 +66,14 @@ To define the links in the network: See the example below: -.. image:: images/create_link.png - :align: center - -.. image:: images/topology_2.png - :align: center +.. image:: images/topology.png + :align: center + +.. image:: images/topology_create_link.png + :align: center + +.. image:: images/topology_completed.png + :align: center Once the links have been defined, the network is automatically configured as long as physical connectivity is in place and Netris Agents can communicate with Netris Controller. diff --git a/try-learn/index.rst b/try-learn/index.rst deleted file mode 100644 index e99ea051..00000000 --- a/try-learn/index.rst +++ /dev/null @@ -1,10 +0,0 @@ -================== -Netris Try & Learn -================== - -.. toctree:: - :maxdepth: 2 - - netris-cloudsim - using-netris-cloudsim - nvidia-spectrum-x-scenario diff --git a/try-learn/netris-cloudsim.rst b/try-learn/netris-cloudsim.rst deleted file mode 100644 index 390757a2..00000000 --- a/try-learn/netris-cloudsim.rst +++ /dev/null @@ -1,8 +0,0 @@ -============================================= -Netris Infrastructure Simulation Platform -============================================= - -Netris infrastructure simulation platform was initially created by and for the Netris R&D team for internal use. Netris Infrastructure Simulation Platform is also available to customers and partners for testing and educational purposes per request. Each request is subject to approval by the Netris team. - -Please use the below link to schedule a demo. -https://netris.io/ \ No newline at end of file diff --git a/try-learn/using-netris-cloudsim.rst b/try-learn/using-netris-cloudsim.rst deleted file mode 100644 index efb37c14..00000000 --- a/try-learn/using-netris-cloudsim.rst +++ /dev/null @@ -1,63 +0,0 @@ -================================================== -Netris Test Controller & Infrastructure Simulation -================================================== - -This document provides general tips and tricks for using the Netris test controller and Netris infrastructure simulation. Please refer to individual scenarios in this section to experiment around a specific use case. - -Once your Try & Learn through Netris Infrastructure Simulation platform is approved you will receive credentials for accessing a Netris controller with a trial license hosted in Netris Infrastructure Simulation platform. - -Controller FQDN: example-ctl.netris.dev -Password: NetrisProvidedPassword - - -Web Console -=========== - -Navigate your browser to the Controller FQDN then use -username: netris -password: - -SSH -=== - -Controller initialization modules and simulation control packages are installed on the Netris controller server. - -Connect to the controller server using ssh. Username: ubuntu Password: - -.. code-block:: shell-session - - ssh ubuntu@ - - -Netris Init Modules -=================== - -Netris init modules are designed to generate Inventory, IPAM, and Topology data based on simple arguments. Most init modules are written using Terraform/HCL. - -Netris test environment may come with a module that is relevant to your use case. If you can't find the right module for your use case, please contact your SA (Solutions Architect) - -Init modules are stored in the ``/home/ubuntu/netris-init/`` directory. - -Each module is stored in its own subdirectory. To use a module 'cd' to the appropriate subdirectory, review ``terraform.tfvars`` file, make changes to the arguments if needed, and save. - -Execute ``tofu-apply`` or ``tofu-destroy`` in the init module subdirectory to apply/destroy the Netris controller configuration. - -Start/Stop a Simulation -======================= - -Once the topology blueprint, Inventory, and IPAM data are created in Netris -- basically, Netris controller is describing an infrastructure - you can start its simulation. - -Go to: - -.. code-block:: shell-session - - cd /home/ubuntu/netris-cloudsim - -Execute ``pulumi up`` or ``pulumi destroy`` to start/stop a simulation of what's described in the Netris Controller - -.. warning:: - Do not run ``pulumi stack rm main`` after ``pulumi destroy`` unless instructed by Netris support. This may cause issues with your simulation environment. Use only ``pulumi destroy`` to safely stop a simulation. - - - - diff --git a/tutorials/connecting-fabric-to-isp.rst b/tutorials/connecting-fabric-to-isp.rst deleted file mode 100644 index 38318d64..00000000 --- a/tutorials/connecting-fabric-to-isp.rst +++ /dev/null @@ -1,17 +0,0 @@ -########################################## -Connecting Netris managed fabric to an ISP -########################################## - -BGP is used to connect the Netris managed fabric to an ISP for internet access. To do this, connect a cable from the ISP to your switch port. Then, use the information provided by your ISP to configure a BGP session within the Netris Controller. - -To create a BGP session go to Network → E-BGP → +Add - -.. image:: images/create_bgp.png - :align: center - -If everything is correct, State, port and BGP will get green status. - -.. image:: images/bgp_status.png - :align: center - -Check out advanced BGP configuration here, if you require additional features. diff --git a/tutorials/connecting-servers-fabric.rst b/tutorials/connecting-servers-fabric.rst deleted file mode 100644 index cd12439c..00000000 --- a/tutorials/connecting-servers-fabric.rst +++ /dev/null @@ -1,11 +0,0 @@ -=============================================== -Connecting servers to the Netris managed fabric -=============================================== - -To connect servers or other endpoints to the switch fabric, you should use V-Nets. V-Net is a virtual networking service that provides Layer-2 (unrouted) or Layer-3 (routed) virtual network segments on switch ports throughout the switch fabric. Netris automatically configures a VXLAN with an EVPN control plane over an unnumbered BGP Layer-3 underlay network and manages the high availability for the default gateway behind the scenes. Simply add the necessary switch ports to a V-Net, and Netris will handle the rest. -Navigate to Services → V-Net → +Add - -.. image:: images/vnet.png - :align: center - -If you are planning to use Link Aggregation in your setup, please take a look at the options provided by Netris :doc:`here`. diff --git a/tutorials/enabling-load-balancing-services.rst b/tutorials/enabling-load-balancing-services.rst deleted file mode 100644 index 8742d147..00000000 --- a/tutorials/enabling-load-balancing-services.rst +++ /dev/null @@ -1,16 +0,0 @@ -################################ -Enabling Load-balancing services -################################ - -L4 Load Balancer is an on-demand (elastic) L4 Load Balancer service. You can natively use it for Kubernetes, as well as for any TCP/UDP service. - -Please check our cloud-native tools section of the documentation portal for consuming Load Balancer using Kubernetes native method, Kubernetes CRDs, or Terraform. - -:doc:`Kubernetes integration` - -:doc:`Terraform integration` - -Below is a screenshot of requesting a Load Balancer service through the Netris web console. Navigate to Services → L4 Load Balancer → +Add - -.. image:: images/l4lb_create.png - :align: center diff --git a/tutorials/enabling-nat-services.rst b/tutorials/enabling-nat-services.rst deleted file mode 100644 index 457b667f..00000000 --- a/tutorials/enabling-nat-services.rst +++ /dev/null @@ -1,23 +0,0 @@ -##################### -Enabling NAT services -##################### - -If you utilize private address space for your hosts, you may need a NAT service to enable internet access. -Netris Softgates support SNAT, DNAT and Masquerade features. - -.. note:: - Softgate PRO will support Masquerade in the future releases. - -Navigate to Network → NAT → +Add - -Create a SNAT service to allow connections from your hosts to the Internet. - -.. image:: images/snat_add.png - :align: center - -Selecting a SNAT pool will allocate the entire pool for this service, preventing the use of IP addresses from the pool for DNAT or other SNAT purposes. - -Create a DNAT service to allow connections from the Internet to your internal hosts with private IP. - -.. image:: images/dnat_add.png - :align: center diff --git a/tutorials/images/add-equinix-bgp-primary.png b/tutorials/images/add-equinix-bgp-primary.png deleted file mode 100644 index 2b343ada..00000000 Binary files a/tutorials/images/add-equinix-bgp-primary.png and /dev/null differ diff --git a/tutorials/images/add-interconnection-request.png b/tutorials/images/add-interconnection-request.png deleted file mode 100644 index de0be619..00000000 Binary files a/tutorials/images/add-interconnection-request.png and /dev/null differ diff --git a/tutorials/images/add-new-ebgp-form.png b/tutorials/images/add-new-ebgp-form.png deleted file mode 100644 index 8b771a90..00000000 Binary files a/tutorials/images/add-new-ebgp-form.png and /dev/null differ diff --git a/tutorials/images/add-new-vlan-equinix.png b/tutorials/images/add-new-vlan-equinix.png deleted file mode 100644 index 24187813..00000000 Binary files a/tutorials/images/add-new-vlan-equinix.png and /dev/null differ diff --git a/tutorials/images/aws-concept-traffic-flows.png b/tutorials/images/aws-concept-traffic-flows.png deleted file mode 100644 index 6f29b595..00000000 Binary files a/tutorials/images/aws-concept-traffic-flows.png and /dev/null differ diff --git a/tutorials/images/aws-ec2-stop-fwd-check.png b/tutorials/images/aws-ec2-stop-fwd-check.png deleted file mode 100644 index 773981a4..00000000 Binary files a/tutorials/images/aws-ec2-stop-fwd-check.png and /dev/null differ diff --git a/tutorials/images/aws-netris-create-sg.png b/tutorials/images/aws-netris-create-sg.png deleted file mode 100644 index aa8a2bf5..00000000 Binary files a/tutorials/images/aws-netris-create-sg.png and /dev/null differ diff --git a/tutorials/images/aws-netris-enable-site-mesh.png b/tutorials/images/aws-netris-enable-site-mesh.png deleted file mode 100644 index 7b72dc40..00000000 Binary files a/tutorials/images/aws-netris-enable-site-mesh.png and /dev/null differ diff --git a/tutorials/images/aws-netris-ipam-lo.png b/tutorials/images/aws-netris-ipam-lo.png deleted file mode 100644 index 4ee3b3ed..00000000 Binary files a/tutorials/images/aws-netris-ipam-lo.png and /dev/null differ diff --git a/tutorials/images/aws-netris-provision-sg.png b/tutorials/images/aws-netris-provision-sg.png deleted file mode 100644 index 71d018f6..00000000 Binary files a/tutorials/images/aws-netris-provision-sg.png and /dev/null differ diff --git a/tutorials/images/aws-netris-site-create.png b/tutorials/images/aws-netris-site-create.png deleted file mode 100644 index 641f1ef4..00000000 Binary files a/tutorials/images/aws-netris-site-create.png and /dev/null differ diff --git a/tutorials/images/aws-netris-site-mesh-status.png b/tutorials/images/aws-netris-site-mesh-status.png deleted file mode 100644 index 03d25a13..00000000 Binary files a/tutorials/images/aws-netris-site-mesh-status.png and /dev/null differ diff --git a/tutorials/images/aws-netris-static-route.png b/tutorials/images/aws-netris-static-route.png deleted file mode 100644 index 97bee607..00000000 Binary files a/tutorials/images/aws-netris-static-route.png and /dev/null differ diff --git a/tutorials/images/aws-security-group.png b/tutorials/images/aws-security-group.png deleted file mode 100644 index ea71ffde..00000000 Binary files a/tutorials/images/aws-security-group.png and /dev/null differ diff --git a/tutorials/images/aws-softgate-deployed.png b/tutorials/images/aws-softgate-deployed.png deleted file mode 100644 index 0ae61a94..00000000 Binary files a/tutorials/images/aws-softgate-deployed.png and /dev/null differ diff --git a/tutorials/images/aws-vpc-cidr-to-netris.png b/tutorials/images/aws-vpc-cidr-to-netris.png deleted file mode 100644 index 31849fd3..00000000 Binary files a/tutorials/images/aws-vpc-cidr-to-netris.png and /dev/null differ diff --git a/tutorials/images/aws-vpc-routes-created.png b/tutorials/images/aws-vpc-routes-created.png deleted file mode 100644 index b355e602..00000000 Binary files a/tutorials/images/aws-vpc-routes-created.png and /dev/null differ diff --git a/tutorials/images/bgp-listing.png b/tutorials/images/bgp-listing.png deleted file mode 100644 index 2e06af3d..00000000 Binary files a/tutorials/images/bgp-listing.png and /dev/null differ diff --git a/tutorials/images/bgp-looking-glass.png b/tutorials/images/bgp-looking-glass.png deleted file mode 100644 index b2cef4aa..00000000 Binary files a/tutorials/images/bgp-looking-glass.png and /dev/null differ diff --git a/tutorials/images/change-password.png b/tutorials/images/change-password.png deleted file mode 100644 index ad093aa3..00000000 Binary files a/tutorials/images/change-password.png and /dev/null differ diff --git a/tutorials/images/cloudflare-dns-record.png b/tutorials/images/cloudflare-dns-record.png deleted file mode 100644 index a0d7586c..00000000 Binary files a/tutorials/images/cloudflare-dns-record.png and /dev/null differ diff --git a/tutorials/images/create-new-admin-user.png b/tutorials/images/create-new-admin-user.png deleted file mode 100644 index 4dcde0ba..00000000 Binary files a/tutorials/images/create-new-admin-user.png and /dev/null differ diff --git a/tutorials/images/create_bgp.png b/tutorials/images/create_bgp.png deleted file mode 100644 index 6a697e4b..00000000 Binary files a/tutorials/images/create_bgp.png and /dev/null differ diff --git a/tutorials/images/dns-cloudflare-equinix-ip.png b/tutorials/images/dns-cloudflare-equinix-ip.png deleted file mode 100644 index 212d1af7..00000000 Binary files a/tutorials/images/dns-cloudflare-equinix-ip.png and /dev/null differ diff --git a/tutorials/images/dns-record-netrisctl.png b/tutorials/images/dns-record-netrisctl.png deleted file mode 100644 index 1d04c129..00000000 Binary files a/tutorials/images/dns-record-netrisctl.png and /dev/null differ diff --git a/tutorials/images/equinix-ebgp-links-up.png b/tutorials/images/equinix-ebgp-links-up.png deleted file mode 100644 index decce718..00000000 Binary files a/tutorials/images/equinix-ebgp-links-up.png and /dev/null differ diff --git a/tutorials/images/equinix-metal-activate-bgp.png b/tutorials/images/equinix-metal-activate-bgp.png deleted file mode 100644 index 947f9993..00000000 Binary files a/tutorials/images/equinix-metal-activate-bgp.png and /dev/null differ diff --git a/tutorials/images/equinix-metal-bgp-diagram.png b/tutorials/images/equinix-metal-bgp-diagram.png deleted file mode 100644 index 50080c16..00000000 Binary files a/tutorials/images/equinix-metal-bgp-diagram.png and /dev/null differ diff --git a/tutorials/images/equinix-metal-netris-bgp-up.png b/tutorials/images/equinix-metal-netris-bgp-up.png deleted file mode 100644 index 8c993d3a..00000000 Binary files a/tutorials/images/equinix-metal-netris-bgp-up.png and /dev/null differ diff --git a/tutorials/images/equinix-metal-netris-ipam-synced.png b/tutorials/images/equinix-metal-netris-ipam-synced.png deleted file mode 100644 index 7095db4a..00000000 Binary files a/tutorials/images/equinix-metal-netris-ipam-synced.png and /dev/null differ diff --git a/tutorials/images/equinix-metal-project-api-keys.png b/tutorials/images/equinix-metal-project-api-keys.png deleted file mode 100644 index 84182fb3..00000000 Binary files a/tutorials/images/equinix-metal-project-api-keys.png and /dev/null differ diff --git a/tutorials/images/equinix-metal-project-id.png b/tutorials/images/equinix-metal-project-id.png deleted file mode 100644 index 4a89f373..00000000 Binary files a/tutorials/images/equinix-metal-project-id.png and /dev/null differ diff --git a/tutorials/images/equinix-metal-request-ip-block.png b/tutorials/images/equinix-metal-request-ip-block.png deleted file mode 100644 index 97db2afc..00000000 Binary files a/tutorials/images/equinix-metal-request-ip-block.png and /dev/null differ diff --git a/tutorials/images/equinix-metal-vnet-with-tag-terraform.png b/tutorials/images/equinix-metal-vnet-with-tag-terraform.png deleted file mode 100644 index e40e8c93..00000000 Binary files a/tutorials/images/equinix-metal-vnet-with-tag-terraform.png and /dev/null differ diff --git a/tutorials/images/equinix-metal-vnet-with-tag.png b/tutorials/images/equinix-metal-vnet-with-tag.png deleted file mode 100644 index d2b05347..00000000 Binary files a/tutorials/images/equinix-metal-vnet-with-tag.png and /dev/null differ diff --git a/tutorials/images/equinix-request-c3-small-server.png b/tutorials/images/equinix-request-c3-small-server.png deleted file mode 100644 index 3b42bced..00000000 Binary files a/tutorials/images/equinix-request-c3-small-server.png and /dev/null differ diff --git a/tutorials/images/ezgif.com-gif-maker.gif b/tutorials/images/ezgif.com-gif-maker.gif deleted file mode 100644 index f8e7e862..00000000 Binary files a/tutorials/images/ezgif.com-gif-maker.gif and /dev/null differ diff --git a/tutorials/images/gcp-concept-traffic-flows.png b/tutorials/images/gcp-concept-traffic-flows.png deleted file mode 100644 index cc8e5a03..00000000 Binary files a/tutorials/images/gcp-concept-traffic-flows.png and /dev/null differ diff --git a/tutorials/images/gcp-firewall-rule.png b/tutorials/images/gcp-firewall-rule.png deleted file mode 100644 index 8b7c9585..00000000 Binary files a/tutorials/images/gcp-firewall-rule.png and /dev/null differ diff --git a/tutorials/images/gcp-netris-create-sg.png b/tutorials/images/gcp-netris-create-sg.png deleted file mode 100644 index e9b8e657..00000000 Binary files a/tutorials/images/gcp-netris-create-sg.png and /dev/null differ diff --git a/tutorials/images/gcp-netris-enable-site-mesh.png b/tutorials/images/gcp-netris-enable-site-mesh.png deleted file mode 100644 index 9b7c2b60..00000000 Binary files a/tutorials/images/gcp-netris-enable-site-mesh.png and /dev/null differ diff --git a/tutorials/images/gcp-netris-ipam-lo.png b/tutorials/images/gcp-netris-ipam-lo.png deleted file mode 100644 index 06bfeddb..00000000 Binary files a/tutorials/images/gcp-netris-ipam-lo.png and /dev/null differ diff --git a/tutorials/images/gcp-netris-provision-sg.png b/tutorials/images/gcp-netris-provision-sg.png deleted file mode 100644 index 8c738638..00000000 Binary files a/tutorials/images/gcp-netris-provision-sg.png and /dev/null differ diff --git a/tutorials/images/gcp-netris-site-create.png b/tutorials/images/gcp-netris-site-create.png deleted file mode 100644 index 19b2f732..00000000 Binary files a/tutorials/images/gcp-netris-site-create.png and /dev/null differ diff --git a/tutorials/images/gcp-netris-site-mesh-status.png b/tutorials/images/gcp-netris-site-mesh-status.png deleted file mode 100644 index 6f23791e..00000000 Binary files a/tutorials/images/gcp-netris-site-mesh-status.png and /dev/null differ diff --git a/tutorials/images/gcp-netris-static-route.png b/tutorials/images/gcp-netris-static-route.png deleted file mode 100644 index e2ec8aa8..00000000 Binary files a/tutorials/images/gcp-netris-static-route.png and /dev/null differ diff --git a/tutorials/images/gcp-softgate-deployed.png b/tutorials/images/gcp-softgate-deployed.png deleted file mode 100644 index 1db91328..00000000 Binary files a/tutorials/images/gcp-softgate-deployed.png and /dev/null differ diff --git a/tutorials/images/gcp-vpc-routes-created.png b/tutorials/images/gcp-vpc-routes-created.png deleted file mode 100644 index f574abbf..00000000 Binary files a/tutorials/images/gcp-vpc-routes-created.png and /dev/null differ diff --git a/tutorials/images/gcp-vpc-subnet-to-netris.png b/tutorials/images/gcp-vpc-subnet-to-netris.png deleted file mode 100644 index db551ea3..00000000 Binary files a/tutorials/images/gcp-vpc-subnet-to-netris.png and /dev/null differ diff --git a/tutorials/images/inventory_softgate.png b/tutorials/images/inventory_softgate.png deleted file mode 100644 index 9700b0da..00000000 Binary files a/tutorials/images/inventory_softgate.png and /dev/null differ diff --git a/tutorials/images/local-public-asn.png b/tutorials/images/local-public-asn.png deleted file mode 100644 index 22ffb71e..00000000 Binary files a/tutorials/images/local-public-asn.png and /dev/null differ diff --git a/tutorials/images/manage-vnet.gif b/tutorials/images/manage-vnet.gif deleted file mode 100644 index f8e7e862..00000000 Binary files a/tutorials/images/manage-vnet.gif and /dev/null differ diff --git a/tutorials/images/net-ebgp-section-location.png b/tutorials/images/net-ebgp-section-location.png deleted file mode 100644 index 80d19d12..00000000 Binary files a/tutorials/images/net-ebgp-section-location.png and /dev/null differ diff --git a/tutorials/images/netris-controller-installed.png b/tutorials/images/netris-controller-installed.png deleted file mode 100644 index a6851e2b..00000000 Binary files a/tutorials/images/netris-controller-installed.png and /dev/null differ diff --git a/tutorials/images/netris-create-common-subnets.png b/tutorials/images/netris-create-common-subnets.png deleted file mode 100644 index b47c8e95..00000000 Binary files a/tutorials/images/netris-create-common-subnets.png and /dev/null differ diff --git a/tutorials/images/netris-create-equinix-metal-site.png b/tutorials/images/netris-create-equinix-metal-site.png deleted file mode 100644 index 39734075..00000000 Binary files a/tutorials/images/netris-create-equinix-metal-site.png and /dev/null differ diff --git a/tutorials/images/netris-create-nat-rule.png b/tutorials/images/netris-create-nat-rule.png deleted file mode 100644 index 28c59139..00000000 Binary files a/tutorials/images/netris-create-nat-rule.png and /dev/null differ diff --git a/tutorials/images/netris-creating-vnet-for-equinix-metal.png b/tutorials/images/netris-creating-vnet-for-equinix-metal.png deleted file mode 100644 index 98fdbd91..00000000 Binary files a/tutorials/images/netris-creating-vnet-for-equinix-metal.png and /dev/null differ diff --git a/tutorials/images/netris-enable-elb.png b/tutorials/images/netris-enable-elb.png deleted file mode 100644 index 36e75664..00000000 Binary files a/tutorials/images/netris-enable-elb.png and /dev/null differ diff --git a/tutorials/images/netris-ipam-nat.png b/tutorials/images/netris-ipam-nat.png deleted file mode 100644 index d7ff2449..00000000 Binary files a/tutorials/images/netris-ipam-nat.png and /dev/null differ diff --git a/tutorials/images/netris-l4-load-balancer.png b/tutorials/images/netris-l4-load-balancer.png deleted file mode 100644 index e6e466f6..00000000 Binary files a/tutorials/images/netris-l4-load-balancer.png and /dev/null differ diff --git a/tutorials/images/netris-vnet-ready-in-equinix-metal.png b/tutorials/images/netris-vnet-ready-in-equinix-metal.png deleted file mode 100644 index c537e657..00000000 Binary files a/tutorials/images/netris-vnet-ready-in-equinix-metal.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-api-credential.png b/tutorials/images/phoenixnap-api-credential.png deleted file mode 100644 index 23cdf89b..00000000 Binary files a/tutorials/images/phoenixnap-api-credential.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-concept-public-network.png b/tutorials/images/phoenixnap-concept-public-network.png deleted file mode 100644 index eb2ee8c3..00000000 Binary files a/tutorials/images/phoenixnap-concept-public-network.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-concept-solution-traffic-flows.png b/tutorials/images/phoenixnap-concept-solution-traffic-flows.png deleted file mode 100644 index 0e58af3d..00000000 Binary files a/tutorials/images/phoenixnap-concept-solution-traffic-flows.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-dns-cloudflare.png b/tutorials/images/phoenixnap-dns-cloudflare.png deleted file mode 100644 index 2d45337d..00000000 Binary files a/tutorials/images/phoenixnap-dns-cloudflare.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-l4lb.png b/tutorials/images/phoenixnap-l4lb.png deleted file mode 100644 index e445fd0e..00000000 Binary files a/tutorials/images/phoenixnap-l4lb.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-nat-dnat.png b/tutorials/images/phoenixnap-nat-dnat.png deleted file mode 100644 index 5c2c8678..00000000 Binary files a/tutorials/images/phoenixnap-nat-dnat.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-nat-masquerade.png b/tutorials/images/phoenixnap-nat-masquerade.png deleted file mode 100644 index 8a882dcc..00000000 Binary files a/tutorials/images/phoenixnap-nat-masquerade.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-nat-snat.png b/tutorials/images/phoenixnap-nat-snat.png deleted file mode 100644 index f83b4104..00000000 Binary files a/tutorials/images/phoenixnap-nat-snat.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-netris-create-common-subnets.png b/tutorials/images/phoenixnap-netris-create-common-subnets.png deleted file mode 100644 index 0b25e81e..00000000 Binary files a/tutorials/images/phoenixnap-netris-create-common-subnets.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-netris-creating-vnet.png b/tutorials/images/phoenixnap-netris-creating-vnet.png deleted file mode 100644 index 9554bbfc..00000000 Binary files a/tutorials/images/phoenixnap-netris-creating-vnet.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-netris-ipam-lb-purpose-slash-28.png b/tutorials/images/phoenixnap-netris-ipam-lb-purpose-slash-28.png deleted file mode 100644 index 6eaad541..00000000 Binary files a/tutorials/images/phoenixnap-netris-ipam-lb-purpose-slash-28.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-netris-ipam-lb-purpose.png b/tutorials/images/phoenixnap-netris-ipam-lb-purpose.png deleted file mode 100644 index f024de06..00000000 Binary files a/tutorials/images/phoenixnap-netris-ipam-lb-purpose.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-netris-ipam-nat-purpose-slash-28.png b/tutorials/images/phoenixnap-netris-ipam-nat-purpose-slash-28.png deleted file mode 100644 index 46ec2cac..00000000 Binary files a/tutorials/images/phoenixnap-netris-ipam-nat-purpose-slash-28.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-netris-ipam-nat-purpose.png b/tutorials/images/phoenixnap-netris-ipam-nat-purpose.png deleted file mode 100644 index e0206cf6..00000000 Binary files a/tutorials/images/phoenixnap-netris-ipam-nat-purpose.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-netris-ipam-synced-slash-28.png b/tutorials/images/phoenixnap-netris-ipam-synced-slash-28.png deleted file mode 100644 index 8c6fcbfb..00000000 Binary files a/tutorials/images/phoenixnap-netris-ipam-synced-slash-28.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-netris-ipam-synced.png b/tutorials/images/phoenixnap-netris-ipam-synced.png deleted file mode 100644 index a102be88..00000000 Binary files a/tutorials/images/phoenixnap-netris-ipam-synced.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-netris-vnet-ready.png b/tutorials/images/phoenixnap-netris-vnet-ready.png deleted file mode 100644 index 794a4a18..00000000 Binary files a/tutorials/images/phoenixnap-netris-vnet-ready.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-request-ctl-server.png b/tutorials/images/phoenixnap-request-ctl-server.png deleted file mode 100644 index 9d035e77..00000000 Binary files a/tutorials/images/phoenixnap-request-ctl-server.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-request-ip-allocation-slash-28.png b/tutorials/images/phoenixnap-request-ip-allocation-slash-28.png deleted file mode 100644 index 145e7db0..00000000 Binary files a/tutorials/images/phoenixnap-request-ip-allocation-slash-28.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-request-ip-allocation.png b/tutorials/images/phoenixnap-request-ip-allocation.png deleted file mode 100644 index 1c4beebb..00000000 Binary files a/tutorials/images/phoenixnap-request-ip-allocation.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-reserved-ips.png b/tutorials/images/phoenixnap-reserved-ips.png deleted file mode 100644 index 815a10d8..00000000 Binary files a/tutorials/images/phoenixnap-reserved-ips.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-site-create.png b/tutorials/images/phoenixnap-site-create.png deleted file mode 100644 index 6ce0021b..00000000 Binary files a/tutorials/images/phoenixnap-site-create.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-softgate-nodes-created.png b/tutorials/images/phoenixnap-softgate-nodes-created.png deleted file mode 100644 index b3f65b8b..00000000 Binary files a/tutorials/images/phoenixnap-softgate-nodes-created.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-softgate-nodes-creation.png b/tutorials/images/phoenixnap-softgate-nodes-creation.png deleted file mode 100644 index 388f903b..00000000 Binary files a/tutorials/images/phoenixnap-softgate-nodes-creation.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-softgate-nodes-green.png b/tutorials/images/phoenixnap-softgate-nodes-green.png deleted file mode 100644 index 570870bc..00000000 Binary files a/tutorials/images/phoenixnap-softgate-nodes-green.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-vnet-import-a-new-server-with-ip.png b/tutorials/images/phoenixnap-vnet-import-a-new-server-with-ip.png deleted file mode 100644 index d11fec21..00000000 Binary files a/tutorials/images/phoenixnap-vnet-import-a-new-server-with-ip.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-vnet-import-a-new-server.png b/tutorials/images/phoenixnap-vnet-import-a-new-server.png deleted file mode 100644 index 4d091b62..00000000 Binary files a/tutorials/images/phoenixnap-vnet-import-a-new-server.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-vnet-imported-new-server.png b/tutorials/images/phoenixnap-vnet-imported-new-server.png deleted file mode 100644 index 2d706c5e..00000000 Binary files a/tutorials/images/phoenixnap-vnet-imported-new-server.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-vnet-managed-vnet.png b/tutorials/images/phoenixnap-vnet-managed-vnet.png deleted file mode 100644 index d4075cf5..00000000 Binary files a/tutorials/images/phoenixnap-vnet-managed-vnet.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-vnet-ssh-to-server.png b/tutorials/images/phoenixnap-vnet-ssh-to-server.png deleted file mode 100644 index 61dce121..00000000 Binary files a/tutorials/images/phoenixnap-vnet-ssh-to-server.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-vnet-unmanaged-vnet.png b/tutorials/images/phoenixnap-vnet-unmanaged-vnet.png deleted file mode 100644 index 3e4b0105..00000000 Binary files a/tutorials/images/phoenixnap-vnet-unmanaged-vnet.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-vnet-with-tag-terraform.png b/tutorials/images/phoenixnap-vnet-with-tag-terraform.png deleted file mode 100644 index d0adc873..00000000 Binary files a/tutorials/images/phoenixnap-vnet-with-tag-terraform.png and /dev/null differ diff --git a/tutorials/images/phoenixnap-vnet-with-tag.png b/tutorials/images/phoenixnap-vnet-with-tag.png deleted file mode 100644 index f8ef08dc..00000000 Binary files a/tutorials/images/phoenixnap-vnet-with-tag.png and /dev/null differ diff --git a/tutorials/images/softgate-green.png b/tutorials/images/softgate-green.png deleted file mode 100644 index 5043c928..00000000 Binary files a/tutorials/images/softgate-green.png and /dev/null differ diff --git a/tutorials/images/softgate-nodes-created-in-equinix.png b/tutorials/images/softgate-nodes-created-in-equinix.png deleted file mode 100644 index 21a8cd44..00000000 Binary files a/tutorials/images/softgate-nodes-created-in-equinix.png and /dev/null differ diff --git a/tutorials/images/softgate-nodes-recognized-in-netris.png b/tutorials/images/softgate-nodes-recognized-in-netris.png deleted file mode 100644 index bfcba948..00000000 Binary files a/tutorials/images/softgate-nodes-recognized-in-netris.png and /dev/null differ diff --git a/tutorials/images/softgate-one-liner-provisioning.png b/tutorials/images/softgate-one-liner-provisioning.png deleted file mode 100644 index f1c72da2..00000000 Binary files a/tutorials/images/softgate-one-liner-provisioning.png and /dev/null differ diff --git a/tutorials/images/switch_fabric_vpc.png b/tutorials/images/switch_fabric_vpc.png deleted file mode 100644 index a6068a92..00000000 Binary files a/tutorials/images/switch_fabric_vpc.png and /dev/null differ diff --git a/tutorials/images/topology_1.png b/tutorials/images/topology_1.png deleted file mode 100644 index 351dd5af..00000000 Binary files a/tutorials/images/topology_1.png and /dev/null differ diff --git a/tutorials/images/unmanaged-vlan-equinix.png b/tutorials/images/unmanaged-vlan-equinix.png deleted file mode 100644 index 26f5d2a1..00000000 Binary files a/tutorials/images/unmanaged-vlan-equinix.png and /dev/null differ diff --git a/tutorials/images/unmanaged-vnet.png b/tutorials/images/unmanaged-vnet.png deleted file mode 100644 index 1d9afc47..00000000 Binary files a/tutorials/images/unmanaged-vnet.png and /dev/null differ diff --git a/tutorials/images/upgrading_sonic_folder_listing.png b/tutorials/images/upgrading_sonic_folder_listing.png deleted file mode 100644 index 10825b7e..00000000 Binary files a/tutorials/images/upgrading_sonic_folder_listing.png and /dev/null differ diff --git a/tutorials/images/upstream-dmz-logical.png b/tutorials/images/upstream-dmz-logical.png deleted file mode 100644 index 6a0be1d5..00000000 Binary files a/tutorials/images/upstream-dmz-logical.png and /dev/null differ diff --git a/tutorials/images/upstream-dmz-physical.png b/tutorials/images/upstream-dmz-physical.png deleted file mode 100644 index a3d2637c..00000000 Binary files a/tutorials/images/upstream-dmz-physical.png and /dev/null differ diff --git a/tutorials/images/vnet.png b/tutorials/images/vnet.png deleted file mode 100644 index 5a8fe318..00000000 Binary files a/tutorials/images/vnet.png and /dev/null differ diff --git a/tutorials/images/vpc-anywhere-add-default-route.png b/tutorials/images/vpc-anywhere-add-default-route.png deleted file mode 100644 index cb756fa3..00000000 Binary files a/tutorials/images/vpc-anywhere-add-default-route.png and /dev/null differ diff --git a/tutorials/images/vpc-anywhere-add-subnet.png b/tutorials/images/vpc-anywhere-add-subnet.png deleted file mode 100644 index 577b2273..00000000 Binary files a/tutorials/images/vpc-anywhere-add-subnet.png and /dev/null differ diff --git a/tutorials/images/vpc-anywhere-add-v-net.png b/tutorials/images/vpc-anywhere-add-v-net.png deleted file mode 100644 index 53d14d89..00000000 Binary files a/tutorials/images/vpc-anywhere-add-v-net.png and /dev/null differ diff --git a/tutorials/images/vpc-anywhere-check-site-default.png b/tutorials/images/vpc-anywhere-check-site-default.png deleted file mode 100644 index 5f133ebd..00000000 Binary files a/tutorials/images/vpc-anywhere-check-site-default.png and /dev/null differ diff --git a/tutorials/images/vpc-anywhere-edit-dot1q-and-vlan-range-default-site.png b/tutorials/images/vpc-anywhere-edit-dot1q-and-vlan-range-default-site.png deleted file mode 100644 index 837ed6ed..00000000 Binary files a/tutorials/images/vpc-anywhere-edit-dot1q-and-vlan-range-default-site.png and /dev/null differ diff --git a/tutorials/images/vpc-anywhere-edit-vlan-range-default-site.png b/tutorials/images/vpc-anywhere-edit-vlan-range-default-site.png deleted file mode 100644 index 50531fb0..00000000 Binary files a/tutorials/images/vpc-anywhere-edit-vlan-range-default-site.png and /dev/null differ diff --git a/tutorials/images/vpc-anywhere-ipam-allocation.png b/tutorials/images/vpc-anywhere-ipam-allocation.png deleted file mode 100644 index 649c00b3..00000000 Binary files a/tutorials/images/vpc-anywhere-ipam-allocation.png and /dev/null differ diff --git a/tutorials/images/vpc-anywhere-ipam-l4lb-subnet.png b/tutorials/images/vpc-anywhere-ipam-l4lb-subnet.png deleted file mode 100644 index 337e6373..00000000 Binary files a/tutorials/images/vpc-anywhere-ipam-l4lb-subnet.png and /dev/null differ diff --git a/tutorials/images/vpc-anywhere-ipam-nat-subnet.png b/tutorials/images/vpc-anywhere-ipam-nat-subnet.png deleted file mode 100644 index 02343674..00000000 Binary files a/tutorials/images/vpc-anywhere-ipam-nat-subnet.png and /dev/null differ diff --git a/tutorials/images/vpc-anywhere-l4lb.png b/tutorials/images/vpc-anywhere-l4lb.png deleted file mode 100644 index f5d39737..00000000 Binary files a/tutorials/images/vpc-anywhere-l4lb.png and /dev/null differ diff --git a/tutorials/images/vpc-anywhere-nat-dnat.png b/tutorials/images/vpc-anywhere-nat-dnat.png deleted file mode 100644 index e2c1487a..00000000 Binary files a/tutorials/images/vpc-anywhere-nat-dnat.png and /dev/null differ diff --git a/tutorials/images/vpc-anywhere-nat-masquerade.png b/tutorials/images/vpc-anywhere-nat-masquerade.png deleted file mode 100644 index d5118ed4..00000000 Binary files a/tutorials/images/vpc-anywhere-nat-masquerade.png and /dev/null differ diff --git a/tutorials/images/vpc-anywhere-nat-snat.png b/tutorials/images/vpc-anywhere-nat-snat.png deleted file mode 100644 index 4f2658c7..00000000 Binary files a/tutorials/images/vpc-anywhere-nat-snat.png and /dev/null differ diff --git a/tutorials/images/vpc-anywhere-sg-to-sg-experimental.png b/tutorials/images/vpc-anywhere-sg-to-sg-experimental.png deleted file mode 100644 index 9e7275f1..00000000 Binary files a/tutorials/images/vpc-anywhere-sg-to-sg-experimental.png and /dev/null differ diff --git a/tutorials/images/vpc-anywhere-softgates-green.png b/tutorials/images/vpc-anywhere-softgates-green.png deleted file mode 100644 index bb919d31..00000000 Binary files a/tutorials/images/vpc-anywhere-softgates-green.png and /dev/null differ diff --git a/tutorials/images/vpc-anywhere-solution-traffic-flows.png b/tutorials/images/vpc-anywhere-solution-traffic-flows.png deleted file mode 100644 index bbc1ad06..00000000 Binary files a/tutorials/images/vpc-anywhere-solution-traffic-flows.png and /dev/null differ diff --git a/tutorials/images/vpc-anywhere-upstream-bgp-internet-logical.png b/tutorials/images/vpc-anywhere-upstream-bgp-internet-logical.png deleted file mode 100644 index 42730fe0..00000000 Binary files a/tutorials/images/vpc-anywhere-upstream-bgp-internet-logical.png and /dev/null differ diff --git a/tutorials/images/vpc-anywhere-upstream-bgp-internet-physical.png b/tutorials/images/vpc-anywhere-upstream-bgp-internet-physical.png deleted file mode 100644 index 8504d542..00000000 Binary files a/tutorials/images/vpc-anywhere-upstream-bgp-internet-physical.png and /dev/null differ diff --git a/tutorials/images/vpc-anywhere-upstream-bgp-router-logical.png b/tutorials/images/vpc-anywhere-upstream-bgp-router-logical.png deleted file mode 100644 index 2096aeac..00000000 Binary files a/tutorials/images/vpc-anywhere-upstream-bgp-router-logical.png and /dev/null differ diff --git a/tutorials/images/vpc-anywhere-upstream-bgp-router-physical.png b/tutorials/images/vpc-anywhere-upstream-bgp-router-physical.png deleted file mode 100644 index 423d159a..00000000 Binary files a/tutorials/images/vpc-anywhere-upstream-bgp-router-physical.png and /dev/null differ diff --git a/tutorials/images/vpc-anywhere-vnet-experimental.png b/tutorials/images/vpc-anywhere-vnet-experimental.png deleted file mode 100644 index 50408639..00000000 Binary files a/tutorials/images/vpc-anywhere-vnet-experimental.png and /dev/null differ diff --git a/tutorials/images/vpc-anywhere-vnet.png b/tutorials/images/vpc-anywhere-vnet.png deleted file mode 100644 index 3249bf18..00000000 Binary files a/tutorials/images/vpc-anywhere-vnet.png and /dev/null differ diff --git a/tutorials/images/vpc_concept.png b/tutorials/images/vpc_concept.png deleted file mode 100644 index 21aef9ef..00000000 Binary files a/tutorials/images/vpc_concept.png and /dev/null differ diff --git a/tutorials/inventory-setup.rst b/tutorials/inventory-setup.rst deleted file mode 100644 index 48cb9e7b..00000000 --- a/tutorials/inventory-setup.rst +++ /dev/null @@ -1,46 +0,0 @@ -############### -Inventory setup -############### - -The Inventory section includes Netris-managed devices and allows you to add, edit, or delete network switches and SoftGates. -The initial setup of the Netris managed fabric consists of a three-step process: - -* Create Inventory Profiles -* Add Switches -* Add Softgates - -.. note:: - You can also add new devices in the Topology view. - - -**Inventory profiles** - -Inventory profiles enable security hardening for inventory devices. By default, all traffic flow destined for a switch or SoftGate is allowed. However, once an inventory profile is attached to a device, it denies all traffic destined for the device except for Netris-defined and user-defined custom flows. Generated rules include: - -* SSH from user-defined subnets -* NTP from user-defined NTP services -* DNS from user-defined DNS servers -* Custom user-defined rules - -The Netris Controller includes a preconfigured Inventory profile named "default-inventory-profile." You can either edit this profile or create your own. - -**SoftGate creation** - -Each SoftGate node needs to be added to the Netris Controller inventory. -Network → Inventory → +Add - -.. image:: images/inventory_softgate.png - :align: center - -**Switch creation** - -Each Switch node needs to be added to the Netris Controller inventory. -Network → Inventory → +Add - -.. image:: images/inventory_switch.png - :align: center - - - - - diff --git a/tutorials/ipam-setup.rst b/tutorials/ipam-setup.rst deleted file mode 100644 index 99c8ee65..00000000 --- a/tutorials/ipam-setup.rst +++ /dev/null @@ -1,53 +0,0 @@ -########## -IPAM setup -########## - - -Netris IPAM enables users to manage their IP addresses and monitor pool usage effectively. It features a hierarchical view to facilitate various subnetting tasks. -Users must first assign specific roles (purposes) to each subnet or address before they can utilize these subnets in services such as V-Net, NAT, Load Balancing, etc.. -Each VPC has its own IPAM table. - -**Create allocations** - -There are two primary types of IP prefixes: allocations and subnets. Allocations consist of IP ranges assigned to an organization through RIR/LIR or private IP ranges intended for network use. Subnets, on the other hand, are prefixes that will be utilized in various services. Subnets always fall under allocations, while allocations do not have parent subnets. - -In addition to the predefined subnets, the Netris Controller also includes predefined allocations, consisting of private IP addresses defined in RFC 1918 - 10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16. If you intend to create subnets that fall outside of these predefined allocations, you should first create allocations that encompass those subnets. - -.. image:: images/ipam_allocation.png - :align: center - -**Create subnets for devices** - -You will require two subnets for your devices: one for loopback IP addresses and another for the management network. Note that device subnets must reside in the System VPC. - -.. image:: images/ipam_mgmt_subnet.png - :align: center - -.. image:: images/ipam_loopback_subnet.png - :align: center - - -**Create subnets for V-Nets** - -Create at least one subnet with the Common purpose to use it for a new V-Net. IP addresses from this subnet will be assigned to your servers. - -.. image:: images/ipam_common_subnet.png - :align: center - - -**Create subnets for Load-balancing service** - -If you plan to use load-balancing services, you should first define subnet(s) from which IP addresses will be assigned for Virtual IP (frontend). - -.. image:: images/ipam_l4lb_subnet.png - :align: center - - -**Create subnets for NAT service** - -If you plan to perform network address translation (NAT), you must first create subnets for this purpose. - -.. image:: images/ipam_nat_subnet.png - :align: center - - diff --git a/tutorials/more-features.rst b/tutorials/more-features.rst deleted file mode 100644 index eea8662f..00000000 --- a/tutorials/more-features.rst +++ /dev/null @@ -1,8 +0,0 @@ -============= -More features -============= - -:doc:`Access lists` - -Static routing, Site Mesh (VPN) and Routing on the host features can be found under :doc:`Network Policies`. - diff --git a/tutorials/netris-managed-fabric-overview.rst b/tutorials/netris-managed-fabric-overview.rst deleted file mode 100644 index 312c2128..00000000 --- a/tutorials/netris-managed-fabric-overview.rst +++ /dev/null @@ -1,18 +0,0 @@ -############################## -Netris managed fabric Overview -############################## - -Introduction ------------- - -VPC gateways (SoftGate) with Netris managed fabric is a comprehensive solution for operating physical networks as if they were cloud-based. By abstracting the complexities of granular network configuration, Netris enables you to operate your physical network using a top-down approach, similar to cloud management, instead of the traditional box-by-box operation. - -Concept -------- - -The Netris managed fabric is a switch fabric that employs EVPN technology for enhanced configuration and performance. The Netris Switch Agent should be installed and operational within the user space of the switch's network operating system (NOS). The agent is responsible for automatically generating specific switch configurations based on service requirements and policies defined in the Netris Controller. The Netris managed fabric delivers high capacity, redundancy, resilience, and high availability, along with traffic filtering based on access lists for optimal network performance. - -Netris SoftGate, known as VPC gateway, is a software for enabling border routing, Layer-4 Load Balancing, Network Address Translation (NAT), DHCP, and site-to-site VPN function on a regular x86 server with a SmartNIC card or without it. - -.. image:: /tutorials/images/switch_fabric_vpc.png - :align: center diff --git a/tutorials/netris-switch-agent-installation.rst b/tutorials/netris-switch-agent-installation.rst deleted file mode 100644 index d40c83a6..00000000 --- a/tutorials/netris-switch-agent-installation.rst +++ /dev/null @@ -1,5 +0,0 @@ -################################ -Netris Switch Agent Installation -################################ - -The Netris Switch Agent is compatible with several Network Operating Systems. :doc:`Here` is a list of these systems, along with installation guides for each one. Install the Netris Agent and come back to this tutorial. diff --git a/tutorials/topology-setup.rst b/tutorials/topology-setup.rst deleted file mode 100644 index ad564919..00000000 --- a/tutorials/topology-setup.rst +++ /dev/null @@ -1,18 +0,0 @@ -############## -Topology setup -############## - -The topology manager is used for describing and monitoring the desired network topology. Netris software will configure the underlying network devices according to this topology dynamically and will watch against potential failures. Wire your switches in accordance with the topology view. - -Right-click on the desired device and choose "Create Link". Select switch-ports for current and remote nodes. - -.. image:: images/topology.png - :align: center - -.. image:: images/topology_create_link.png - :align: center - -.. image:: images/topology_completed.png - :align: center - -Once the links have been defined, the network is automatically configured as long as physical connectivity is in place and Netris Agents can communicate with the Netris Controller. diff --git a/tutorials/vpc-gateways-with-managed-fabric.rst b/tutorials/vpc-gateways-with-managed-fabric.rst deleted file mode 100644 index c2d688ad..00000000 --- a/tutorials/vpc-gateways-with-managed-fabric.rst +++ /dev/null @@ -1,75 +0,0 @@ -================================================ -Getting Started with Switch-Fabric Manager & VPC -================================================ - -.. toctree:: - :maxdepth: 2 - - netris-managed-fabric-overview - - -.. toctree:: - :maxdepth: 2 - - ../installation/controller-k3s-air-gap-ha - -.. toctree:: - :maxdepth: 2 - - new-site-setup - -.. toctree:: - :maxdepth: 2 - - vpc-setup - -.. toctree:: - :maxdepth: 2 - - ipam-setup - -.. toctree:: - :maxdepth: 2 - - inventory-setup - -.. toctree:: - :maxdepth: 2 - - topology-setup - - -.. toctree:: - :maxdepth: 2 - - ../netris-softgate-HS - -.. toctree:: - :maxdepth: 2 - - netris-switch-agent-installation - -.. toctree:: - :maxdepth: 2 - - connecting-fabric-to-isp - -.. toctree:: - :maxdepth: 2 - - connecting-servers-fabric - -.. toctree:: - :maxdepth: 2 - - enabling-nat-services - -.. toctree:: - :maxdepth: 2 - - enabling-load-balancing-services - -.. toctree:: - :maxdepth: 2 - - more-features diff --git a/tutorials/vpc-setup.rst b/tutorials/vpc-setup.rst deleted file mode 100644 index ec4ee8fc..00000000 --- a/tutorials/vpc-setup.rst +++ /dev/null @@ -1,15 +0,0 @@ -######### -VPC setup -######### - -The Netris VPC offers you the ability to operate your resources within a logically segregated virtual network. You can create, edit, and remove VPCs as needed. The VPC acts as a VRF in traditional networking, providing the ability to employ overlapping IP ranges across various VPCs while maintaining secure management and operation of resources. - -Netris Controller is preconfigured with a default system VPC-1. Use the default VPC, and create additional VPCs as needed in the future. - -.. image:: images/vpc_concept.png - :align: center - -To create VPC go to Network → VPC → +Add - -.. image:: images/vpc_add.png - :align: center diff --git a/upgrading-netris.rst b/upgrading-netris.rst index 9f4621c0..0ec64d84 100644 --- a/upgrading-netris.rst +++ b/upgrading-netris.rst @@ -28,10 +28,6 @@ Always have a backup, just in case anything hypothetically goes wrong. SSH to th Ensure that SQL file ``db-snapshot.sql`` is generated and present in the current directory. -.. note:: - - An SQL dump is enough for this basic upgrade scenario, however detailed backup & restore procedure is described in :ref:`here`. - Stop Netris Agents ------------------ @@ -67,7 +63,7 @@ Check your current version Before upgrading the Netris Controller, take a note of the "*Netris Version*" by navigating to *Settings → General* in the Controller web interface. The current version number may be used in case of the hypothetical need to perform a rollback procedure. -.. image:: /tutorials/images/netris_version_example.png +.. image:: images/netris_version_example.png :align: center :alt: Netris Version Example @@ -136,7 +132,7 @@ Upgrade the switch & SoftGate agents by copying the one-liner from the "*Install to copy/paste into the right devices. -.. image:: /tutorials/images/install_agent.gif +.. image:: images/install_agent.gif :align: center :alt: Install Agent diff --git a/vnet.rst b/vnet.rst index 01e6fb8f..9517466e 100644 --- a/vnet.rst +++ b/vnet.rst @@ -15,9 +15,15 @@ V-Net Introduction ---------------- -A **V-Net (Virtual Network)** is a Netris construct for grouping switch ports into a defined network segment—much like a traditional VLAN or a public cloud subnet. +A **V-Net (Virtual Network)** is a Netris construct for grouping switch ports into a defined network segment—much like a traditional VLAN or a public cloud subnet. It is a virtual networking service that provides Layer-2 (unrouted) or Layer-3 (routed) virtual network segments in a Netris VPC. V-Net is assigned to one VPC and one or multiple sites. Your endpoints (servers, VMs) are connected to V-Nets. -To build a V-Net you only need to supply **a list of switch ports**, **a name**, **parent** :doc:`VPC `, **and site(s)**. Optionally IP subnet, gateway, and DHCP settings. +To build a V-Net you need to supply + +* a list of switch ports +* a name +* parent :ref:`VPC ` +* :doc:`site(s) ` +* Optionally IP subnet, gateway, and DHCP settings. Netris, having already configured the EVPN underlay, then automatically pushes the entire under-the-hood V-Net configuration to every Ethernet switch and DPU in the fabric: diff --git a/vpc-gateways-with-managed-fabric.rst b/vpc-gateways-with-managed-fabric.rst new file mode 100644 index 00000000..fa95891a --- /dev/null +++ b/vpc-gateways-with-managed-fabric.rst @@ -0,0 +1,18 @@ +================================================ +Getting Started with Switch-Fabric Manager & VPC +================================================ + +* :doc:`../introduction` +* :doc:`../installation/controller-k3s-air-gap-ha` +* :doc:`../site` +* :ref:`vpc_def` +* :ref:`ipam_def_vpc` +* :ref:`topology-management` +* :ref:`topology-manager` +* :doc:`../netris-softgate-HS` +* :doc:`../switch-agent-installation` +* :ref:`Connecting Netris fabric to ISP ` +* :doc:`Connecting servers to Netris fabric (adding ports to V-Net) <../vnet>` +* :ref:`Enabling NAT services ` +* :doc:`Enabling Load-balancing services <../l4-load-balancer>` +* :doc:`../acls` diff --git a/vpc.rst b/vpc.rst deleted file mode 100644 index 05eb70cf..00000000 --- a/vpc.rst +++ /dev/null @@ -1,88 +0,0 @@ -.. meta:: - :description: Netris VPC - -====================== -Netris VPC -====================== - -The Netris VPC offers you the ability to operate your resources within a logically segregated virtual network. You can create, edit, and remove VPCs as needed. The VPC acts as a VRF in traditional networking, providing the flexibility to employ overlapping IP ranges across various VPCs while maintaining secure management and operation of resources. - -Netris Controller is preconfigured with a default system VPC-1. Use the default VPC, and create additional VPCs as needed in the future. - -The following diagram shows a VPC concept in the Netris Controller. - -.. image:: images/vpc_diagram.png - :align: center - :alt: VPC diagram - -VPC is the highest entity in the hierarchy and it spreads over all Sites. -Take a look at the VPC features and services. - -Sites ------ - -For each individual deployment/region, you should define a Site. All network components and resources should be associated with their respective Site and VPC. - -Physically connected sites function like an availability zone. This means that two V-Nets (Subnets) will communicate using the direct link, and even a single V-Net can span within an availability zone. Sites that are not physically connected function like regions. And Netris SiteMesh, a Wireguard-based site-to-site VPN, can be used to enable communication between these regions. - - -IPAM ----- - -You have the ability to create IP Allocations and Subnet assignments for a VPC, and these may overlap between different VPCs. A Subnet can be assigned to multiple sites if you aim to extend your V-Net across various locations. - - -V-Nets ------- - -V-Net is a virtual networking service that provides Layer-2 (unrouted) or Layer-3 (routed) virtual network segments in VPC. V-Net is assigned to one VPC and one or multiple sites. Your endpoints (servers, VMs) are connected to V-Nets. - -**Note: multisite feature requires a direct physical link between Sites.** - -External connections --------------------- - -You can connect your VPC to ISP providers or other segments of your network using Netris E-BGP service, or statically by defining a V-Net and using Net->Routes (for natively integrated Bare Metal Cloud Providers please refer to the provider-specific tutorial, as external connections usually establish automatically - -SiteMesh connections --------------------- - -Connect your VPCs over an automatic Wireguard-based Site-to-Site VPN across multiple Sites if you don't have a direct link between those Sites. - -**Note: works only in the system default VPC (limitation is planned to be lifted in Netris v. 4.1.0).** - - -NAT services ------------- -SNAT allows your endpoints to communicate with the Internet. DNAT is also available. - -**Note: works only in the system default VPC (limitation is planned to be lifted in Netris v. 4.1.0).** - -Load-balancing service ----------------------- - -Use L4LB service to share the load between your endpoints. - -**Note: works only in the system default VPC (limitation is planned to be lifted in Netris v. 4.1.0).** - - -Access lists ------------- - -ACLs provide a layer of security that acts as a firewall for controlling traffic in and out of one or more subnets. - -**Note: works only in the system default VPC (limitation is planned to be lifted in Netris v. 4.1.0).** - -Working with Netris VPC ------------------------ - -You have the flexibility to create and manage your VPCs using any of the interfaces listed below: - -* Web interface of the Netris Controller -* Terraform Netris provider -* Kubernetes Integration -* REST API - - - -