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

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions modules/telco-ran-crs-cluster-tuning.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -11,12 +11,12 @@
|====
Component,Reference CR,Description,Optional
Cluster capabilities,`example-sno.yaml`,Representative SiteConfig CR to install single-node OpenShift with the RAN DU profile,No
Console disable,`ConsoleOperatorDisable.yaml`,Disables the Console Operator.,No
Disconnected registry,`09-openshift-marketplace-ns.yaml`,Defines a dedicated namespace for managing the OpenShift Operator Marketplace.,No
Disconnected registry,`DefaultCatsrc.yaml`,Configures the catalog source for the disconnected registry.,No
Disconnected registry,`DisableOLMPprof.yaml`,Disables performance profiling for OLM.,No
Disconnected registry,`DisconnectedIDMS.yaml`,Configures disconnected registry image content source policy.,No
Disconnected registry,`OperatorHub.yaml`,"Optional, for multi-node clusters only. Configures the OperatorHub in OpenShift, disabling all default Operator sources. Not required for single-node OpenShift installs with marketplace capability disabled.",No
Monitoring configuration,`ReduceMonitoringFootprint.yaml`,"Reduces the monitoring footprint by disabling Alertmanager and Telemeter, and sets Prometheus retention to 24 hours",No
Network diagnostics disable,`DisableSnoNetworkDiag.yaml`,Configures the cluster network settings to disable built-in network troubleshooting and diagnostic features.,No
Console disable,`cluster-tuning/console-disable/ConsoleOperatorDisable.yaml`,Disables the Console Operator.,No
Disconnected registry,`extra-manifest/09-openshift-marketplace-ns.yaml`,Defines a dedicated namespace for managing the OpenShift Operator Marketplace.,No
Disconnected registry,`disconnected-registry/DefaultCatsrc.yaml`,Configures the catalog source for the disconnected registry.,No
Disconnected registry,`cluster-tuning/DisableOLMPprof.yaml`,Disables performance profiling for OLM.,No
Disconnected registry,`disconnected-registry/DisconnectedIDMS.yaml`,Configures disconnected registry image content source policy.,No
Disconnected registry,`cluster-tuning/operator-hub/OperatorHub.yaml`,"Optional, for multi-node clusters only. Configures the OperatorHub in OpenShift, disabling all default Operator sources. Not required for single-node OpenShift installs with marketplace capability disabled.",No
Monitoring configuration,`cluster-tuning/monitoring-configuration/ReduceMonitoringFootprint.yaml`,"Reduces the monitoring footprint by disabling Alertmanager and Telemeter, and sets Prometheus retention to 24 hours",No
Network diagnostics disable,`cluster-tuning/disabling-network-diagnostics/DisableSnoNetworkDiag.yaml`,Configures the cluster network settings to disable built-in network troubleshooting and diagnostic features.,No
|====
104 changes: 53 additions & 51 deletions modules/telco-ran-crs-day-2-operators.adoc

Large diffs are not rendered by default.

32 changes: 16 additions & 16 deletions modules/telco-ran-crs-machine-configuration.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -10,20 +10,20 @@
[cols="4*", options="header", format=csv]
|====
Component,Reference CR,Description,Optional
Container runtime (crun),`enable-crun-master.yaml`,Configures the container runtime (crun) for control plane nodes.,No
Container runtime (crun),`enable-crun-worker.yaml`,Configures the container runtime (crun) for worker nodes.,No
CRI-O wipe disable,`99-crio-disable-wipe-master.yaml`,Disables automatic CRI-O cache wipe following a reboot for on control plane nodes.,No
CRI-O wipe disable,`99-crio-disable-wipe-worker.yaml`,Disables automatic CRI-O cache wipe following a reboot for on worker nodes.,No
Kdump enable,`06-kdump-master.yaml`,Configures kdump crash reporting on control plane nodes.,No
Kdump enable,`06-kdump-worker.yaml`,Configures kdump crash reporting on worker nodes.,No
Kubelet configuration and container mount hiding,`01-container-mount-ns-and-kubelet-conf-master.yaml`,Configures a mount namespace for sharing container-specific mounts between kubelet and CRI-O on control plane nodes.,No
Kubelet configuration and container mount hiding,`01-container-mount-ns-and-kubelet-conf-worker.yaml`,Configures a mount namespace for sharing container-specific mounts between kubelet and CRI-O on worker nodes.,No
One-shot time sync,`99-sync-time-once-master.yaml`,Synchronizes time once on control plane nodes.,No
One-shot time sync,`99-sync-time-once-worker.yaml`,Synchronizes time once on worker nodes.,No
SCTP,`03-sctp-machine-config-master.yaml`,Loads the SCTP kernel module on control plane nodes.,Yes
SCTP,`03-sctp-machine-config-worker.yaml`,Loads the SCTP kernel module on worker nodes.,Yes
Set RCU normal,`08-set-rcu-normal-master.yaml`,Disables rcu_expedited by setting rcu_normal after the control plane node has booted.,No
Set RCU normal,`08-set-rcu-normal-worker.yaml`,Disables rcu_expedited by setting rcu_normal after the worker node has booted.,No
SRIOV-related kernel arguments,`07-sriov-related-kernel-args-master.yaml`,Enables SR-IOV support on control plane nodes.,No
SRIOV-related kernel arguments,`07-sriov-related-kernel-args-worker.yaml`,Enables SR-IOV support on worker nodes.,No
Container runtime (crun),`optional-extra-manifest/enable-crun-master.yaml`,Configures the container runtime (crun) for control plane nodes.,No
Container runtime (crun),`optional-extra-manifest/enable-crun-worker.yaml`,Configures the container runtime (crun) for worker nodes.,No
CRI-O wipe disable,`extra-manifest/99-crio-disable-wipe-master.yaml`,Disables automatic CRI-O cache wipe following a reboot for on control plane nodes.,No
CRI-O wipe disable,`extra-manifest/99-crio-disable-wipe-worker.yaml`,Disables automatic CRI-O cache wipe following a reboot for on worker nodes.,No
Kdump enable,`extra-manifest/06-kdump-master.yaml`,Configures kdump crash reporting on master nodes.,No
Kdump enable,`extra-manifest/06-kdump-worker.yaml`,Configures kdump crash reporting on worker nodes.,No
Kubelet configuration and container mount hiding,`extra-manifest/01-container-mount-ns-and-kubelet-conf-master.yaml`,Configures a mount namespace for sharing container-specific mounts between kubelet and CRI-O on control plane nodes.,No
Kubelet configuration and container mount hiding,`extra-manifest/01-container-mount-ns-and-kubelet-conf-worker.yaml`,Configures a mount namespace for sharing container-specific mounts between kubelet and CRI-O on worker nodes.,No
One-shot time sync,`extra-manifest/99-sync-time-once-master.yaml`,Synchronizes time once on master nodes.,No
One-shot time sync,`extra-manifest/99-sync-time-once-worker.yaml`,Synchronizes time once on worker nodes.,No
SCTP,`extra-manifest/03-sctp-machine-config-master.yaml`,Loads the SCTP kernel module on master nodes.,Yes
SCTP,`extra-manifest/03-sctp-machine-config-worker.yaml`,Loads the SCTP kernel module on worker nodes.,Yes
Set RCU normal,`extra-manifest/08-set-rcu-normal-master.yaml`,Disables rcu_expedited by setting rcu_normal after the control plane node has booted.,No
Set RCU normal,`extra-manifest/08-set-rcu-normal-worker.yaml`,Disables rcu_expedited by setting rcu_normal after the worker node has booted.,No
SRIOV-related kernel arguments,`extra-manifest/07-sriov-related-kernel-args-master.yaml`,Enables SR-IOV support on master nodes.,No
SRIOV-related kernel arguments,`extra-manifest/07-sriov-related-kernel-args-worker.yaml`,Enables SR-IOV support on worker nodes.,No
|====
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ Workloads::


Resources::
The maximum number of running pods in the system, inclusive of application workload and {product-title} pods, is 120.
The maximum number of running pods in the system, inclusive of application workload and {product-title} pods, is 160.

Resource utilization::
+
Expand Down Expand Up @@ -70,10 +70,10 @@ You might need to allocate additional cluster resources to meet these requiremen
--

Reference application workload characteristics::
. Uses 15 pods and 30 containers for the vRAN application including its management and control functions
. Uses an average of 2 `ConfigMap` and 4 `Secret` CRs per pod
. Uses a maximum of 10 exec probes with a frequency of not less than 10 seconds
. Incremental application load on the kube-apiserver is less than or equal to 10% of the cluster platform usage
. Uses 75 pods across 5 namespaces with 4 containers per pod for the vRAN application including its management and control functions
. Creates 30 `ConfigMap` CRs and 30 `Secret` CRs per namespace
. Uses no exec probes
. Uses a secondary network
+
[NOTE]
====
Expand All @@ -85,7 +85,7 @@ $ query=avg_over_time(pod:container_cpu_usage:sum{namespace="openshift-kube-apis
----
====
. Application logs are not collected by the platform log collector.
. Aggregate traffic on the primary CNI is less than 8 Mbps
. Aggregate traffic on the primary CNI is up to 30 Mbps and up to 5 Gbps on the secondary network

Hub cluster management characteristics::
+
Expand Down
2 changes: 1 addition & 1 deletion modules/telco-ran-gitops-operator-and-ztp-plugins.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
= GitOps Operator and {ztp}

New in this release::
* https://issues.redhat.com/browse/CNF-9183[GA support for ACM PolicyGenerator with gitops/ZTP (as recommended reference)]
* No reference design updates in this release

Description::
+
Expand Down
4 changes: 3 additions & 1 deletion modules/telco-ran-ptp-operator.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,9 @@ Limits and requirements::
* Limited to 3 Westport channel NIC configurations for T-GM

Engineering considerations::
* RAN DU RDS configurations are provided for ordinary clocks, boundary clocks, grandmaster clocks, and highly available dual NIC boundary clocks.
* * Example RAN DU RDS configurations are provided for:
** T-GM, T-BC, and T-TSC
** Variations with and without HA
* PTP fast event notifications use `ConfigMap` CRs to persist subscriber details.
* Hierarchical event subscription as described in the O-RAN specification is not supported for PTP events.
* The PTP fast events REST API v1 is end of life.
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ You manage cluster configuration and upgrades declaratively by applying `Policy`

The recommended method for {sno} cluster installation is the image-based installation approach, available in MCE, using the `ClusterInstance` CR for cluster definition.

The recommended method for {sno} cluster upgrade is the image-based upgrade method.
Image-based upgrade is the recommended method for {sno} cluster upgrade.
--

Limits and requirements::
Expand Down
2 changes: 1 addition & 1 deletion modules/telco-ran-sr-iov-operator.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
= SR-IOV Operator

New in this release::
* https://issues.redhat.com/browse/CNF-12813[Support moving failed policy in resource injector to failed for SR-IOV operator]
* No reference design updates in this release

Description::
The SR-IOV Operator provisions and configures the SR-IOV CNI and device plugins.
Expand Down
7 changes: 0 additions & 7 deletions modules/telco-ref-design-overview.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -18,13 +18,6 @@ Following the RDS minimizes high severity escalations and improves application s
5G use cases are evolving and your workloads are continually changing.
Red Hat is committed to iterating over the telco core and RAN DU RDS to support evolving requirements based on customer and partner feedback.

[NOTE]
====
Support for an ARM based platform is currently a Developer Preview feature for {product-title} 4.19.
All information is subject to change on release.
For more details, see the following Red Hat knowledge base article : https://access.redhat.com/articles/7118870[How to use ARM platform hardware in OpenShift 4.19 Telco RDS (Developer Preview)]
====

The reference configuration includes the configuration of the far edge clusters and hub cluster components.

The reference configurations in this document are deployed using a centrally managed hub cluster infrastructure as shown in the following image.
Expand Down
11 changes: 5 additions & 6 deletions modules/ztp-telco-ran-software-versions.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -18,24 +18,23 @@ The Red Hat telco RAN DU {product-version} solution has been validated using the
|4.19

|Cluster Logging Operator
|6.2^1^
|6.2

|Local Storage Operator
|4.19
|4.20

|OpenShift API for Data Protection (OADP)
|1.5

|PTP Operator
|4.19
|4.20

|SR-IOV Operator
|4.19
|4.20

|SRIOV-FEC Operator
|2.11

|Lifecycle Agent
|4.19
|4.20
|====
[1] This table will be updated when the aligned Cluster Logging Operator version 6.3 is released.
2 changes: 1 addition & 1 deletion scalability_and_performance/telco-ran-du-rds.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -176,6 +176,6 @@ include::modules/using-cluster-compare-telco-ran.adoc[leveloffset=+1]

include::modules/ztp-telco-ran-software-versions.adoc[leveloffset=+1]

include::modules/ztp-telco-hub-cluster-software-versions.adoc[leveloffset=+1]
//include::modules/ztp-telco-hub-cluster-software-versions.adoc[leveloffset=+1]

:!telco-ran: