starlingx/docs
Code Issues Proposed changes

Platform Single Core adjustments

Browse Source 
Story: 2010087
Task: 46549

Signed-off-by: Elisamara Aoki Goncalves <elisamaraaoki.goncalves@windriver.com>
Change-Id: Id469742647334004658699bae3623cc5cc6cb3a5
This commit is contained in:
Elisamara Aoki Goncalves 2022-12-16 10:29:53 -03:00
parent cf755b146c
commit 41b8ec0b60
3 changed files with 64 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
doc/source/_includes/single-physical-core-for-platform-function-in-all-in-one-deployments-bec61d5a13f4.rest Normal file
View File

@ -0,0 +1,2 @@
.. deploy-begin
.. deploy-end

1
doc/source/node_management/kubernetes/index-node-mgmt-kub-5ff5993b9c60.rst
View File

@ -98,6 +98,7 @@ Configuring CPU core behaviour
configuring_cpu_core_assignments/configuring-cpu-core-assignments
configuring_cpu_core_assignments/changing-the-hyper-threading-status
host-cpu-mhz-parameters-configuration-d9ccf907ede0
single-physical-core-for-platform-function-in-all-in-one-deployments-bec61d5a13f4
------------------------
Host memory provisioning

61
doc/source/node_management/kubernetes/single-physical-core-for-platform-function-in-all-in-one-deployments-bec61d5a13f4.rst Normal file
View File

@ -0,0 +1,61 @@
.. _single-physical-core-for-platform-function-in-all-in-one-deployments-bec61d5a13f4:
====================================================================
Single Physical Core for Platform Function in All-In-One Deployments
====================================================================
The platform core usage was optimized to operate on a single physical core with
two logical cores in Hyper-Threading enabled for All-In-One deployments.
During a fresh install of All-In-One systems (non-system-controller) the system
will be configured to operate with a single physical core for the platform
function when Hyper-Threading CPU functionality is enabled. In case of
Hyper-Threading is disabled the system will keep current behavior allocating
two physical cores for platform function.
The use of single physical core for platform function is only suitable for
Intel® 4th Generation Xeon® Scalable Processors or above and should not be
configured for previous Intel® Xeon® CPU families. For All-In-One systems with
older generation processors, two physical cores (or more) must be configured.
The System does not automatically configures the number of physical cores based
on the CPU type, the user should perform this configuration. The default is
Single Core when HT is enabled.
System recommendations and limitations will be available through the |org|
System Engineering Guidelines.
.. note::
During an upgrade process, the CPU platform configuration will be retained.
The number of cores allocated to the platform function can be changed through
the system API and thru deployment manager.
System API:
#. Lock hosts
.. code-block:: none
system host-lock <host>
#. Set cores reserved to platform
.. code-block:: none
system host-cpu-modify -f platform -p<processor#> <#-of-physical-cores> <host>
#. Unlock host
.. code-block:: none
system host-unlock <host>
.. only:: partner
.. include:: /_includes/single-physical-core-for-platform-function-in-all-in-one-deployments-bec61d5a13f4.rest
:start-after: deploy-begin
:end-before: deploy-end