From dbd46c1fd10dfd645a1e0d0d875aca2ca44068c6 Mon Sep 17 00:00:00 2001 From: HHDocs Date: Mon, 22 Jan 2024 21:22:23 +0000 Subject: [PATCH] Deployed d85430f to dev with MkDocs 1.5.3 and mike 1.1.2 --- dev/404.html | 20 + dev/architecture/fabric/index.html | 20 + dev/architecture/overview/index.html | 20 + dev/concepts/overview/index.html | 20 + dev/contribute/docs/index.html | 20 + dev/contribute/overview/index.html | 20 + dev/getting-started/download/index.html | 43 +- dev/index.html | 20 + dev/install-upgrade/build-wiring/index.html | 22 +- dev/install-upgrade/config/index.html | 1239 +++++++++++++++++ dev/install-upgrade/onie-update/index.html | 22 +- dev/install-upgrade/overview/index.html | 23 +- dev/install-upgrade/requirements/index.html | 20 + .../supported-devices/index.html | 20 + dev/reference/api/index.html | 20 + dev/reference/cli/index.html | 20 + dev/release-notes/index.html | 164 ++- dev/search/search_index.json | 2 +- dev/sitemap.xml | 55 +- dev/sitemap.xml.gz | Bin 435 -> 439 bytes dev/troubleshooting/overview/index.html | 20 + dev/user-guide/connections/index.html | 97 +- dev/user-guide/devices/index.html | 20 + dev/user-guide/external/index.html | 20 + dev/user-guide/harvester/index.html | 20 + dev/user-guide/overview/index.html | 20 + dev/user-guide/vpcs/index.html | 39 +- dev/vlab/demo/index.html | 20 + dev/vlab/overview/index.html | 40 +- dev/vlab/running/index.html | 42 +- master/install-upgrade/config/index.html | 16 + 31 files changed, 2097 insertions(+), 47 deletions(-) create mode 100644 dev/install-upgrade/config/index.html create mode 100644 master/install-upgrade/config/index.html diff --git a/dev/404.html b/dev/404.html index 1353f91..c59e02f 100644 --- a/dev/404.html +++ b/dev/404.html @@ -562,6 +562,26 @@ +
  • + + + + + Fabric Configuration + + + + +
    • + + + + + + + + +
  • diff --git a/dev/architecture/fabric/index.html b/dev/architecture/fabric/index.html index ed877b5..12f0b9b 100644 --- a/dev/architecture/fabric/index.html +++ b/dev/architecture/fabric/index.html @@ -584,6 +584,26 @@ +
  • + + + + + Fabric Configuration + + + + +
    • + + + + + + + + +
  • diff --git a/dev/architecture/overview/index.html b/dev/architecture/overview/index.html index c7f8730..14b216b 100644 --- a/dev/architecture/overview/index.html +++ b/dev/architecture/overview/index.html @@ -584,6 +584,26 @@ +
  • + + + + + Fabric Configuration + + + + +
    • + + + + + + + + +
  • diff --git a/dev/concepts/overview/index.html b/dev/concepts/overview/index.html index 71d08b9..d0bee71 100644 --- a/dev/concepts/overview/index.html +++ b/dev/concepts/overview/index.html @@ -679,6 +679,26 @@ +
  • + + + + + Fabric Configuration + + + + +
    • + + + + + + + + +
  • diff --git a/dev/contribute/docs/index.html b/dev/contribute/docs/index.html index 2027647..db702f2 100644 --- a/dev/contribute/docs/index.html +++ b/dev/contribute/docs/index.html @@ -582,6 +582,26 @@ +
  • + + + + + Fabric Configuration + + + + +
    • + + + + + + + + +
  • diff --git a/dev/contribute/overview/index.html b/dev/contribute/overview/index.html index 41a15f7..b891caf 100644 --- a/dev/contribute/overview/index.html +++ b/dev/contribute/overview/index.html @@ -584,6 +584,26 @@ +
  • + + + + + Fabric Configuration + + + + +
    • + + + + + + + + +
  • diff --git a/dev/getting-started/download/index.html b/dev/getting-started/download/index.html index df4e883..e4d0e8e 100644 --- a/dev/getting-started/download/index.html +++ b/dev/getting-started/download/index.html @@ -400,6 +400,13 @@ Downloading the software +
    • + +
  • + + Next steps + +
    • @@ -638,6 +645,26 @@ +
  • + + + + + Fabric Configuration + + + + +
    • + + + + + + + + +
  • @@ -1156,6 +1183,13 @@ Downloading the software +
    • + +
  • + + Next steps + +
    • @@ -1202,13 +1236,20 @@

    Downloading the software

    curl -fsSL https://i.hhdev.io/oras | bash

    Currently only Linux x86 is supported for running hhfab.

    +

    Next steps

    +
    Last update: - December 22, 2023 + January 22, 2024
    Created: diff --git a/dev/index.html b/dev/index.html index 5901a35..c83cf95 100644 --- a/dev/index.html +++ b/dev/index.html @@ -592,6 +592,26 @@ +
  • + + + + + Fabric Configuration + + + + +
    • + + + + + + + + +
  • diff --git a/dev/install-upgrade/build-wiring/index.html b/dev/install-upgrade/build-wiring/index.html index 38d396f..f03e077 100644 --- a/dev/install-upgrade/build-wiring/index.html +++ b/dev/install-upgrade/build-wiring/index.html @@ -18,7 +18,7 @@ - + @@ -594,6 +594,26 @@ +
  • + + + + + Fabric Configuration + + + + +
    • + + + + + + + + +
  • diff --git a/dev/install-upgrade/config/index.html b/dev/install-upgrade/config/index.html new file mode 100644 index 0000000..70986c4 --- /dev/null +++ b/dev/install-upgrade/config/index.html @@ -0,0 +1,1239 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Fabric Configuration - Open Network Fabric + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + + + + Skip to content + + +
    +
    + + + +
    + + + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    + + + + + + + + + + + + +

    Fabric Configuration

    +
      +
    • --fabric-mode <mode-name (collapsed-core or spine-leaf) - Fabric mode to use, default is spine-leaf; in case + of collapsed-core mode, there will be no VXLAN configured and only 2 switches will be used
      • +
    • --ntp-servers <servers>- Comma-separated list of NTP servers to use, default is + time.cloudflare.com,time1.google.com,time2.google.com,time3.google.com,time4.google.com, it'll be used for both + control nodes and switches
      • +
    • --dhcpd <mode-name> (isc or hedgehog) - DHCP server to use, default is isc; hedgehog DHCP server enables + use of on-demand DHCP for multiple IPv4/VLAN namespaces and overlapping IP ranges as well as adds DHCP leases + into the Fabric API
      • +
    +

    You can find more information about using hhfab init in the help message by running it with --help flag.

    + +
    +
    + + + Last update: + January 22, 2024 + +
    + Created: + January 22, 2024 + + +     +
    + + + + + + +
    +
    + + + + +
    + + + +
    + + + +
    +
    +
    +
    + +
    + + + + + + + + + + \ No newline at end of file diff --git a/dev/install-upgrade/onie-update/index.html b/dev/install-upgrade/onie-update/index.html index 623bcfc..01b125e 100644 --- a/dev/install-upgrade/onie-update/index.html +++ b/dev/install-upgrade/onie-update/index.html @@ -15,7 +15,7 @@ - + @@ -583,6 +583,26 @@ + +
  • + + + + + Fabric Configuration + + + + +
    • + + + + + + + + diff --git a/dev/install-upgrade/overview/index.html b/dev/install-upgrade/overview/index.html index 1218c7d..3f0533f 100644 --- a/dev/install-upgrade/overview/index.html +++ b/dev/install-upgrade/overview/index.html @@ -652,6 +652,26 @@ +
  • + + + + + Fabric Configuration + + + + +
    • + + + + + + + + +
  • @@ -1228,6 +1248,7 @@

    Main steps

    1. Install hhfab on the machines with access to internet
      1. Prepare Wiring Diagram
        2. +
      2. Select Fabric Configuration
      3. Build Control Node configuration and installer
      2. @@ -1302,7 +1323,7 @@

      Install Control Node

      Last update: - December 22, 2023 + January 22, 2024
      Created: diff --git a/dev/install-upgrade/requirements/index.html b/dev/install-upgrade/requirements/index.html index 0f03c12..2d87b2b 100644 --- a/dev/install-upgrade/requirements/index.html +++ b/dev/install-upgrade/requirements/index.html @@ -645,6 +645,26 @@ +
    2. + + + + + Fabric Configuration + + + + +
      3. + + + + + + + + +
    3. diff --git a/dev/install-upgrade/supported-devices/index.html b/dev/install-upgrade/supported-devices/index.html index 7b1bdc4..167ae2d 100644 --- a/dev/install-upgrade/supported-devices/index.html +++ b/dev/install-upgrade/supported-devices/index.html @@ -638,6 +638,26 @@ +
    4. + + + + + Fabric Configuration + + + + +
      5. + + + + + + + + +
    5. diff --git a/dev/reference/api/index.html b/dev/reference/api/index.html index ac50c2f..960fa1a 100644 --- a/dev/reference/api/index.html +++ b/dev/reference/api/index.html @@ -584,6 +584,26 @@ +
    6. + + + + + Fabric Configuration + + + + +
      7. + + + + + + + + +
    7. diff --git a/dev/reference/cli/index.html b/dev/reference/cli/index.html index a4ecc1a..5063626 100644 --- a/dev/reference/cli/index.html +++ b/dev/reference/cli/index.html @@ -584,6 +584,26 @@ +
    8. + + + + + Fabric Configuration + + + + +
      9. + + + + + + + + +
    9. diff --git a/dev/release-notes/index.html b/dev/release-notes/index.html index c30fe4c..6cd9aa0 100644 --- a/dev/release-notes/index.html +++ b/dev/release-notes/index.html @@ -584,6 +584,26 @@ +
    10. + + + + + Fabric Configuration + + + + +
      11. + + + + + + + + +
    11. @@ -1011,6 +1031,61 @@ @@ -1467,18 +1527,41 @@

      Management

      ip: 172.30.20.1/31 port: s5248-01/Ethernet0
    • -

    External

    -

    Connection to the external systems, e.g. edge/provider routers.

    +

    Connecting Fabric to outside world

    +

    Provides connectivity to the outside world, e.g. internet, other networks or some other systems such as DHCP, NTP, LMA, +AAA services.

    +

    StaticExternal

    +

    Simple way to connect things like DHCP server directly to the Fabric by connecting it to specific switch ports.

    apiVersion: wiring.githedgehog.com/v1alpha2
 kind: Connection
 metadata:
-  name: s5248-03--external--5835
+  name: third-party-dhcp-server--static-external--s5248-04
   namespace: default
 spec:
-  external:
-    link: # Defines a single link between a switch and an external system
+  staticExternal:
+    link:
       switch:
-        port: s5248-03/Ethernet3
+        port: s5248-04/Ethernet1 # switch port to use
+        ip: 172.30.50.5/24 # IP address that will be assigned to the switch port
+        vlan: 1005 # Optional VLAN ID to use for the switch port, if 0 - no VLAN is configured
+        subnets: # List of subnets that will be routed to the switch port using static routes and next hop
+          - 10.99.0.1/24
+          - 10.199.0.100/32
+        nextHop: 172.30.50.1 # Next hop IP address that will be used when configuring static routes for the "subnets" list
+
    +

    External

    +

    Connection to the external systems, e.g. edge/provider routers using BGP peering and configuring Inbound/Outbound +communities as well as granularly controlling what's getting advertised and which routes are accepted.

    +
    apiVersion: wiring.githedgehog.com/v1alpha2
+kind: Connection
+metadata:
+  name: s5248-03--external--5835
+  namespace: default
+spec:
+  external:
+    link: # Defines a single link between a switch and an external system
+      switch:
+        port: s5248-03/Ethernet3
    @@ -1486,7 +1569,7 @@

    December 22, 2023 + January 22, 2024
    Created: diff --git a/dev/user-guide/devices/index.html b/dev/user-guide/devices/index.html index 16e0bc4..e3f7906 100644 --- a/dev/user-guide/devices/index.html +++ b/dev/user-guide/devices/index.html @@ -584,6 +584,26 @@ +
  • + + + + + Fabric Configuration + + + + +
    • + + + + + + + + +
  • diff --git a/dev/user-guide/external/index.html b/dev/user-guide/external/index.html index 1c3ad89..c46e7fc 100644 --- a/dev/user-guide/external/index.html +++ b/dev/user-guide/external/index.html @@ -584,6 +584,26 @@ +
  • + + + + + Fabric Configuration + + + + +
    • + + + + + + + + +
  • diff --git a/dev/user-guide/harvester/index.html b/dev/user-guide/harvester/index.html index 50eaee5..e08d9a4 100644 --- a/dev/user-guide/harvester/index.html +++ b/dev/user-guide/harvester/index.html @@ -584,6 +584,26 @@ +
  • + + + + + Fabric Configuration + + + + +
    • + + + + + + + + +
  • diff --git a/dev/user-guide/overview/index.html b/dev/user-guide/overview/index.html index 9cfd510..6ce4cdf 100644 --- a/dev/user-guide/overview/index.html +++ b/dev/user-guide/overview/index.html @@ -584,6 +584,26 @@ +
  • + + + + + Fabric Configuration + + + + +
    • + + + + + + + + +
  • diff --git a/dev/user-guide/vpcs/index.html b/dev/user-guide/vpcs/index.html index 7dec1e5..8c659ad 100644 --- a/dev/user-guide/vpcs/index.html +++ b/dev/user-guide/vpcs/index.html @@ -584,6 +584,26 @@ +
  • + + + + + Fabric Configuration + + + + +
    • + + + + + + + + +
  • @@ -1236,16 +1256,21 @@

    ipv4Namespace: default # Limits to which subnets could be used by VPC to guarantee non-overlapping IPv4 ranges vlanNamespace: default # Limits to which switches VPC could be attached to guarantee non-overlapping VLANs subnets: - default: # Each subnet is named - dhcp: # On-demand DHCP server - enable: true + default: # Each subnet is named, "default" subnet isn't required, but actively used by CLI + dhcp: + enable: true # On-demand DHCP server range: # Optionally, start/end range could be specified start: 10.10.1.10 subnet: 10.10.1.0/24 # User-defined subnet from ipv4 namespace vlan: "1001" # User-defined VLAN from vlan namespace - another-subnet: # Minimal configuration is just a name, subnet and VLAN - subnet: 10.10.100.0/24 - vlan: "1100" + thrird-party-dhcp: # Another subnet + dhcp: + relay: 10.99.0.100/24 # Use third-party DHCP server (DHCP relay configuration), access to it could be enabled using StaticExternal connection + subnet: "10.10.2.0/24" + vlan: "1002" + another-subnet: # Minimal configuration is just a name, subnet and VLAN + subnet: 10.10.100.0/24 + vlan: "1100"

    VPCAttachment

    Represents a specific VPC subnet assignemnt to the Connection object which means exact server port to a VPC binding. @@ -1320,7 +1345,7 @@

    VLANNamespace

    Last update: - December 22, 2023 + January 22, 2024
    Created: diff --git a/dev/vlab/demo/index.html b/dev/vlab/demo/index.html index 3fc878a..cce800b 100644 --- a/dev/vlab/demo/index.html +++ b/dev/vlab/demo/index.html @@ -659,6 +659,26 @@ +
  • + + + + + Fabric Configuration + + + + +
    • + + + + + + + + +
  • diff --git a/dev/vlab/overview/index.html b/dev/vlab/overview/index.html index f5defdc..861304a 100644 --- a/dev/vlab/overview/index.html +++ b/dev/vlab/overview/index.html @@ -464,6 +464,13 @@ Installing prerequisites +
    • + +
  • + + Next steps + +
    • @@ -645,6 +652,26 @@ +
  • + + + + + Fabric Configuration + + + + +
    • + + + + + + + + +
  • @@ -1170,6 +1197,13 @@ Installing prerequisites +
    • + +
  • + + Next steps + +
    • @@ -1270,13 +1304,17 @@

    Installing prerequisites

    INFO: /dev/kvm exists KVM acceleration can be used +

    Next steps

    +
    Last update: - December 22, 2023 + January 22, 2024
    Created: diff --git a/dev/vlab/running/index.html b/dev/vlab/running/index.html index 56e4377..a68f864 100644 --- a/dev/vlab/running/index.html +++ b/dev/vlab/running/index.html @@ -512,6 +512,13 @@ Reset VLAB + + +
  • + + Next steps + +
    • @@ -673,6 +680,26 @@ +
  • + + + + + Fabric Configuration + + + + +
    • + + + + + + + + +
  • @@ -1226,6 +1253,13 @@ Reset VLAB +
    • + +
  • + + Next steps + +
    • @@ -1294,6 +1328,8 @@

    Initialize VLAB

    01:21:53 WRN Wiring is not hydrated, hydrating reason="error validating wiring: ASN not set for switch leaf-01" 01:21:53 INF Initialized preset=vlab fabricMode=spine-leaf config=.hhfab/config.yaml wiring=.hhfab/wiring.yaml
    +

    Additionally, you can do extra Fabric configuration using flags on init command or by passing config file, more +information about it is available in the Fabric Configuration section.

    Once you have initialized the VLAB you need to download all artifacts and build the installer using hhfab build command. It will automatically download all required artifacts from the OCI registry and build the installer as well as all other prerequisites for running the VLAB.

    @@ -1506,13 +1542,17 @@

    Getting main Fabric objects

    Reset VLAB

    To reset VLAB and start over just remove the .hhfab directory and run hhfab init again.

    +

    Next steps

    +
    Last update: - December 22, 2023 + January 22, 2024
    Created: diff --git a/master/install-upgrade/config/index.html b/master/install-upgrade/config/index.html new file mode 100644 index 0000000..5115f4f --- /dev/null +++ b/master/install-upgrade/config/index.html @@ -0,0 +1,16 @@ + + + + + Redirecting + + + + + Redirecting to ../../../dev/install-upgrade/config/... + + \ No newline at end of file