diff --git a/__tests__/crawler.test.js b/__tests__/crawler.test.js index d9cba037b0..19ca294334 100644 --- a/__tests__/crawler.test.js +++ b/__tests__/crawler.test.js @@ -200,7 +200,8 @@ test('Crawl the docs and execute tests', async () => { 'https://sysctl-explorer.net/net/ipv4/fib_multipath_hash_policy/', 'https://calico-docs.mcp.kapa.ai', 'https://docs.tigera.io/img/calico-logo-2026-badge.png', - 'https://microk8s.io/docs/clustering' // TEMP + 'http://www.w3.org/2000/svg', // Appears in SVG file 'xmlns', doesn't need checking + 'https://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html' // TEMP ]; const lc = linkChecker(); diff --git a/calico-enterprise/getting-started/bare-metal/about.mdx b/calico-enterprise/getting-started/bare-metal/about.mdx index 4ea852755f..1de32d36d9 100644 --- a/calico-enterprise/getting-started/bare-metal/about.mdx +++ b/calico-enterprise/getting-started/bare-metal/about.mdx @@ -2,6 +2,9 @@ description: Install Calico on non-cluster hosts and VMs --- +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + # Install Calico on non-cluster hosts and VMs ## Big picture @@ -41,9 +44,19 @@ To learn how to restrict traffic to/from hosts and VMs using Calico network poli If $[prodname] is installed on a cluster, you already have a datastore. -- Non-cluster host or VM meets $[prodname] [system requirements](../install-on-clusters/requirements.mdx) - - Ensure that your node OS includes the `ipset` and `conntrack` kernel dependencies. +- Node requirements for non-cluster hosts and VMs: + - x86-64 v3 microarchitecture. + You can check this via the program interpreter on the node: + ```bash + /lib64/ld-linux-x86-64.so.2 --help + ``` + If you see a line that says `x86-64-v3 (supported, searched)`, your processor supports the required microarchitecture. + - The following host operating systems are supported: + - RHEL 8 and RHEL 9 + - Ubuntu 22.04 and 24.04 + - Debian 12 and Debian 13 + - Your operating system includes the `ipset` and `conntrack` kernel dependencies. +- For everything else, your non-cluster host or VM meets $[prodname] [system requirements](../install-on-clusters/requirements.mdx) ## How to @@ -91,21 +104,41 @@ To learn how to restrict traffic to/from hosts and VMs using Calico network poli ### Set up your non-cluster host or VM -1. Configure the Calico Enterprise repository. - +1. Download the Calico Enterprise repository to work with your Linux distro. + + ```bash - curl -sfL $[rpmsUrl]/calico_enterprise.repo -o /etc/yum.repos.d/calico-enterprise.repo + curl -sfL $[rhelPkgUrl]/calico_enterprise.repo -o /etc/yum.repos.d/calico-enterprise.repo ``` - - Only Red Hat Enterprise Linux 8 and 9 x86-64 operating systems are supported in this version of $[prodname]. - + + + 1. Download the appropriate sources file for your operating system: + ```bash + curl -fsSL -o calico-enterprise.sources $[debPkgUrl]/$(lsb_release -cs).sources + ``` + 1. Copy the file into your apt sources directory: + ```bash + sudo cp calico-enterprise.sources /etc/apt/sources.list.d/ + ``` + 1. Retrieve the updated package index: + ```bash + sudo apt-get update + ``` + + 1. Install Calico node and fluent-bit log forwarder packages. - - - Use `dnf` to install the `calico-node` and `calico-fluent-bit` packages: - - ```bash - dnf install calico-node calico-fluent-bit - ``` + + + ```bash + dnf install calico-node calico-fluent-bit + ``` + + + ```bash + sudo apt install calico-node calico-fluent-bit + ``` + + 1. Copy the `kubeconfig` created in cluster setup step 2 to host folder `/etc/calico/kubeconfig`. @@ -128,7 +161,9 @@ For HA mode to function correctly, a correctly configured load balancer (LB) is The LB must detect failures, redirect traffic to the passive cluster, and restore traffic to the active cluster once it is healthy. Without a proper configuration, HA mode will not work as expected. -Your hosts or VMs are inherently HA-ready once you completed the setup steps. They automatically connect to the appropriate cluster. +Your hosts or VMs are inherently HA-ready once you completed the setup steps. +They automatically connect to the appropriate cluster. + To enable HA mode, system administrators must perform the following steps: - Deploy and maintain both clusters: Provision and manage both the active and passive Kubernetes clusters. diff --git a/calico-enterprise/variables.js b/calico-enterprise/variables.js index f38ea5c45a..c510d4d830 100644 --- a/calico-enterprise/variables.js +++ b/calico-enterprise/variables.js @@ -9,7 +9,8 @@ const variables = { openSourceVersion: releases[0].calico.minor_version.slice(1), baseUrl: '/calico-enterprise/next', filesUrl: 'https://downloads.tigera.io/ee/master', - rpmsUrl: 'https://downloads.tigera.io/ee/rpms/' + releases[0].title.slice(0, 5), + rhelPkgUrl: 'https://downloads.tigera.io/ee/rpms/' + releases[0].title.slice(0, 5), + debPkgUrl: 'https://downloads.tigera.io/ee/debs/' + releases[0].title.slice(0, 5), tutorialFilesURL: 'https://docs.tigera.io/files', tmpScriptsURL: 'https://docs.tigera.io/calico-enterprise/next', windowsScriptsURL: 'https://raw.githubusercontent.com/kubernetes-sigs/sig-windows-tools/master/hostprocess', diff --git a/calico-enterprise_versioned_docs/version-3.23-1/getting-started/bare-metal/about.mdx b/calico-enterprise_versioned_docs/version-3.23-1/getting-started/bare-metal/about.mdx index 4ea852755f..9c7a02f126 100644 --- a/calico-enterprise_versioned_docs/version-3.23-1/getting-started/bare-metal/about.mdx +++ b/calico-enterprise_versioned_docs/version-3.23-1/getting-started/bare-metal/about.mdx @@ -2,6 +2,9 @@ description: Install Calico on non-cluster hosts and VMs --- +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + # Install Calico on non-cluster hosts and VMs ## Big picture @@ -41,9 +44,19 @@ To learn how to restrict traffic to/from hosts and VMs using Calico network poli If $[prodname] is installed on a cluster, you already have a datastore. -- Non-cluster host or VM meets $[prodname] [system requirements](../install-on-clusters/requirements.mdx) - - Ensure that your node OS includes the `ipset` and `conntrack` kernel dependencies. +- Node requirements for non-cluster hosts and VMs: + - x86-64 v3 microarchitecture. + You can check this via the program interpreter on the node: + ```bash + /lib64/ld-linux-x86-64.so.2 --help + ``` + If you see a line that says `x86-64-v3 (supported, searched)`, your processor supports the required microarchitecture. + - The following host operating systems are supported: + - RHEL 8 and RHEL 9 + - Ubuntu 22.04 and 24.04 + - Debian 12 and Debian 13 + - Your operating system includes the `ipset` and `conntrack` kernel dependencies. +- For everything else, your non-cluster host or VM meets $[prodname] [system requirements](../install-on-clusters/requirements.mdx) ## How to @@ -91,21 +104,41 @@ To learn how to restrict traffic to/from hosts and VMs using Calico network poli ### Set up your non-cluster host or VM -1. Configure the Calico Enterprise repository. - +1. Download the Calico Enterprise repository to work with your Linux distro. + + ```bash - curl -sfL $[rpmsUrl]/calico_enterprise.repo -o /etc/yum.repos.d/calico-enterprise.repo + curl -sfL $[rhelPkgUrl]/calico_enterprise.repo -o /etc/yum.repos.d/calico-enterprise.repo ``` - - Only Red Hat Enterprise Linux 8 and 9 x86-64 operating systems are supported in this version of $[prodname]. - + + + 1. Download the appropriate sources file for your operating system: + ```bash + curl -fsSL -o calico-enterprise.sources $[debPkgUrl]/$(lsb_release -cs).sources + ``` + 1. Copy the file into your apt sources directory: + ```bash + sudo cp calico-enterprise.sources /etc/apt/sources.list.d/ + ``` + 1. Retrieve the updated package index: + ```bash + sudo apt-get update + ``` + + 1. Install Calico node and fluent-bit log forwarder packages. - - - Use `dnf` to install the `calico-node` and `calico-fluent-bit` packages: - - ```bash - dnf install calico-node calico-fluent-bit - ``` + + + ```bash + dnf install calico-node calico-fluent-bit + ``` + + + ```bash + sudo apt install calico-node calico-fluent-bit + ``` + + 1. Copy the `kubeconfig` created in cluster setup step 2 to host folder `/etc/calico/kubeconfig`. @@ -128,7 +161,10 @@ For HA mode to function correctly, a correctly configured load balancer (LB) is The LB must detect failures, redirect traffic to the passive cluster, and restore traffic to the active cluster once it is healthy. Without a proper configuration, HA mode will not work as expected. -Your hosts or VMs are inherently HA-ready once you completed the setup steps. They automatically connect to the appropriate cluster. + +Your hosts or VMs are inherently HA-ready once you completed the setup steps. +They automatically connect to the appropriate cluster. + To enable HA mode, system administrators must perform the following steps: - Deploy and maintain both clusters: Provision and manage both the active and passive Kubernetes clusters. diff --git a/calico-enterprise_versioned_docs/version-3.23-1/variables.js b/calico-enterprise_versioned_docs/version-3.23-1/variables.js index 5e331c0352..2a856f5e63 100644 --- a/calico-enterprise_versioned_docs/version-3.23-1/variables.js +++ b/calico-enterprise_versioned_docs/version-3.23-1/variables.js @@ -9,7 +9,8 @@ const variables = { openSourceVersion: releases[0].calico.minor_version.slice(1), baseUrl: '/calico-enterprise/3.23', filesUrl: 'https://downloads.tigera.io/ee/v3.23.0-1.0', - rpmsUrl: 'https://downloads.tigera.io/ee/rpms/' + releases[0].title.slice(0, 5), + rhelPkgUrl: 'https://downloads.tigera.io/ee/rpms/' + releases[0].title.slice(0, 5), + debPkgUrl: 'https://downloads.tigera.io/ee/debs/' + releases[0].title.slice(0, 5), tutorialFilesURL: 'https://docs.tigera.io/files', tmpScriptsURL: 'https://docs.tigera.io/calico-enterprise/3.23', windowsScriptsURL: 'https://raw.githubusercontent.com/kubernetes-sigs/sig-windows-tools/master/hostprocess',