From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 3F50743719; Wed, 20 Dec 2023 10:25:10 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 2DBC140689; Wed, 20 Dec 2023 10:25:10 +0100 (CET) Received: from NAM11-BN8-obe.outbound.protection.outlook.com (mail-bn8nam11on2041.outbound.protection.outlook.com [40.107.236.41]) by mails.dpdk.org (Postfix) with ESMTP id 7621C40266 for ; Wed, 20 Dec 2023 10:25:08 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=k7J6Nlhzwji3+BFlm8QXu0G1y0sLejOBBo5vPKFQ0s8g1E0cWVNsy1r5/YUJTJOW2DQP4SZuWyl+Rql0+nsDWt2AgQ5MxjOBVqa/LJlyXSwqqXpIFsC2FxVxlqQXOyaZabDbTTqtip/yzrjhRxaFN+I7FYXg5qxGIu/ckuFDJAUUSiDBA04qksqPnMNToZSKs1wCi0+47PmYh1x5rsmOkJXswvtPzVRItNT6eGqj9kpwSqAPHHj117EBL4HzqWsaX4IgMpRuy9tj3S85iL94PgOl0jwSfwsc3BZ/yb2+CqPixG2mUqyUhmtjKAqvhdlwidEhi3CFYl5cXT2eYlwOpQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=V0jNDmsv12sfZTMllJLcrXJnfh4gOEDgWXXK3yv7Xo8=; b=eP7kjAbFBq4JJcQ1JpdlS4yrM5s7E51DeZKpDLw/vXikZ9n6f1UCtHwfE2iIOI9pMy6JJd/rl7amujiNSkNQk8WZQEW14LhUb0hQkwxHVUHsikuTaiN3um44Ytzu12CsYaWK6jFTVT0GH3trsoQLYa7l0uMfyIkZwu0ok2qT8tEeC9OxQpnB8o810bRs4/y2kVNRUQavGTNTmHFsWlWENBMVEmuzAHHAf14r4uMF/gTE1dVwRzJ8WPlzLJli4uECPn0/dcDfMTe6BSC77fRsPr1op3d9x7QthBzn8nq70scTuQ/baDKjm4vsfuiBRkwtzljWowvnHHWq9OFPPD+VCA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=amd.com; dmarc=pass action=none header.from=amd.com; dkim=pass header.d=amd.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amd.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=V0jNDmsv12sfZTMllJLcrXJnfh4gOEDgWXXK3yv7Xo8=; b=u4WiJY8Ajdj3nKfIkZ3EicodgfjR2E5RVN31PJzLla6DyWnjUFP8HaHMMh+dRTbsMc3QR1FAMKkcNY7ZHu2gVvHsG2u/dhb4Cqm//H8b8RM3q43g0T5nNIacHLOsbCs8V06W93061E5jVYFA5bODcXeQquqzByxJQXndMmhQvTE= Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=amd.com; Received: from MN2PR12MB3085.namprd12.prod.outlook.com (2603:10b6:208:c5::29) by LV3PR12MB9329.namprd12.prod.outlook.com (2603:10b6:408:21c::9) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7091.38; Wed, 20 Dec 2023 09:25:05 +0000 Received: from MN2PR12MB3085.namprd12.prod.outlook.com ([fe80::579d:6ed5:68a6:3cba]) by MN2PR12MB3085.namprd12.prod.outlook.com ([fe80::579d:6ed5:68a6:3cba%3]) with mapi id 15.20.7113.016; Wed, 20 Dec 2023 09:25:05 +0000 Content-Type: multipart/alternative; boundary="------------hdjE7ctMA5CR7aAPyj9TmWhT" Message-ID: <9bce5b2f-a283-44da-b04b-d56e9f6df076@amd.com> Date: Wed, 20 Dec 2023 14:54:57 +0530 User-Agent: Mozilla Thunderbird Subject: Re: [RFC] doc/linux_gsg: add amd configuration section From: "Varghese, Vipin" To: dev@dpdk.org Cc: Neerav.Parikh@amd.com, Ferruh.Yigit@amd.com, Clinton.France@amd.com References: <20231010153409.1701-1-vipin.varghese@amd.com> Content-Language: en-US In-Reply-To: <20231010153409.1701-1-vipin.varghese@amd.com> X-ClientProxiedBy: PN2PR01CA0207.INDPRD01.PROD.OUTLOOK.COM (2603:1096:c01:e9::18) To MN2PR12MB3085.namprd12.prod.outlook.com (2603:10b6:208:c5::29) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: MN2PR12MB3085:EE_|LV3PR12MB9329:EE_ X-MS-Office365-Filtering-Correlation-Id: 238c7151-e182-4d03-2cb2-08dc013d8d28 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: ncYd0YMyLa4x47V9xpLBoxEu4KusiYYpLbV+9iZ3CZxTPIj//H5KI/yD8moa8VUZFMPPvPRIPwpYH1mEs5uIAkkGJZEyhhQW9A8fXkwGe01xxVrJ6Al9EDwqhrh0RGSQvn8K61Jv+MAeiK2AoSZL0IAvfp0fdjqEbcc2o4EgHGFciwndIWSxyC8uQMW/nFcM40YD9YoiydbGeG2C8plZdnMvHXsNZZIAUZhIl0WtcR7qbfxjGLXNHa5IktfYcPhsqYTQqOP+/vLl+Z9yqoJ8I2q1NBIMUJm01cewmne3VB1L/FuABPj1EbMG85nFXHVF55vMQ3Jcopo/Zpj/26DYG5/noCZycds6UZSC84dBaGJyPqTZeg96P2IWmaB/jWS/GhkBE/Id0z7+Mlk6w9e5L+rlzuT2UtQDd7SDvW2fw0+fGwvpyZ5vFqes87NbQFVZfgn7KnRJabxB20Am7Rq9bj0ag6Q3M3qdsYgMfUZw+32CpAcQ4JQKorZNtGk0u6zH+rpk30QmRVou4Tf+K+d4KBTcVi/nG2NQmJMv/fOm50SOZRZp4C+4tHPjs5uI0itlhhh3LTyzhtpT8P5ii8DB1+uRIxt3ogIQsRtTcgPRUbUolFoCoP+yUoyErDBiiSBiSPamwJX4D0B9T3bB9/YCbjFtazEAN4MR28yQ0scGdcedF1OEbaNPvqbDxMa3CSOt X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:MN2PR12MB3085.namprd12.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230031)(366004)(136003)(376002)(396003)(39860400002)(346002)(230922051799003)(230273577357003)(230173577357003)(1800799012)(451199024)(64100799003)(186009)(166002)(86362001)(2906002)(6666004)(4326008)(8936002)(8676002)(66946007)(66476007)(5660300002)(66556008)(6916009)(316002)(31686004)(38100700002)(31696002)(478600001)(6486002)(66899024)(41300700001)(26005)(53546011)(6512007)(2616005)(36756003)(83380400001)(33964004)(6506007)(45980500001)(43740500002); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?dXR0U3FnSmgxY29UQXp0YlZWYkppSWtaRVp1WWpwQWZGaytMZVBxYnhnc2lm?= =?utf-8?B?d2VhUXRvbHZQSjQ5aVRLN09ONlB0c1Q2RHI5OHI2b2ZZOFNLMGFXd1FTUzBO?= =?utf-8?B?MzltcG82MUF2RkdDMk4zN0Q0amlyYzRuUGxuRDBCa1BtdkZ2QjkvckwyUysz?= =?utf-8?B?cm5WSTY1YWU3TXIxbGJYTnhzK2ZSRlZHb1BSR2I5d21iaXJhOFFJWUF2bmhT?= =?utf-8?B?MFBGNW1YSGV0WkxvUFRNdWFKdC9QYjhycEVaQWJ2ZTc2azB4aTc3RFJ4cUJh?= =?utf-8?B?RTA5MEEyZm5BeG9JSzAraVpFUysxTWJaejdHOERTVDl6NDVmUUMrc3NvUXZS?= =?utf-8?B?bDAwamdhb3NHd1pKSHZHczFSM2JlcGN2dERrM2UvVnB1b0JyNzlKLzJNU3lp?= =?utf-8?B?RUtvWEVHWktVL3pHem1ERyttVXFSajAxNXl5eXNndGxRNERJK3cyalZDQ1NU?= =?utf-8?B?am5DblFvYWs5UDQ0YlpXN2FQaXN1eHBwWVFRR2Z1TzBHajh2ZzY0OUptVnc5?= =?utf-8?B?ZVZuUlQzUE9OQlN6dEhocE1QMlpUS2VBOFRBa1hjWWZLOHZYQU9DWld6R0RK?= =?utf-8?B?SDdXeHVkaVl4dy9HYnBXOWI2UkxCV2tiT1lZczdBNDY0OWJCbmxSNFRBNXlX?= =?utf-8?B?SWtaVXdQV0tTQ2k4VU1ROWhOdi83OS9YVzYrT2g0enZlKzNjaHRlT3EweHJE?= =?utf-8?B?Z3IyMEZmU3VOZSs1SFIyS05HcDdwZWlMZlZUdVA1ZC9nZFBWWm5YcGZralVS?= =?utf-8?B?QUgrWGpTanBHQS9vaDg4Wnd0YW9OcUdZWVhSMDY2YnU0SGk5SlhKbDI5RGMz?= =?utf-8?B?cDBXZlpSS3VKbm5ueUlrN1FnMTJwYjVSUWFYalBzVU9tTEhxb01MV0cwQ0Jm?= =?utf-8?B?Umt0d2JiOVRBM3VZMGZGQ3B6eUMwTGdUbitvNERxUVVHNmRISEFXc1BBRkhJ?= =?utf-8?B?anQxQWFIai9yQi9PSkJyYzA5U1daSk84YkNxbkNRNkJhV0ZqODNNYXROUEtC?= =?utf-8?B?V3hXd1cxa21LdWROV0JpZUNlcVRhUllmS1Zuc042ZjF6TG9FT1lsUXNBa2Rx?= =?utf-8?B?NHRROGJCUG5PaFE3UlprZ0VvQ0tHSTJxNWEzVmR3UVErTDMrTXdwUmhJMnVJ?= =?utf-8?B?aHIzTFFVaEVCektkaGJJc1UzMFN6WE9LbXZ5YzEzelB5T0JWalVXRWNUZVFw?= =?utf-8?B?Z3BydXNxdWJmanhtS1g4OUhHN1dwUC9McjIvMFlYdXlUQzh0NitrR3k3Sm1J?= =?utf-8?B?OUtIak91OHdPTENSOW1DeUN3V1JZYlRja2ZETGlxaDZxR25vQWY3SXZRcWlO?= =?utf-8?B?NlhURmZDZFhZOVNiamtWR3JuRGZEcVdEN0MyMVMxQVpEVnRnWGc0SXlUTGxa?= =?utf-8?B?WVBRWDlJaUdSNE9Xb3pML01pVlNBeUE4ZEJlZXFzZkZYVEY0bi85aGRlTUk2?= =?utf-8?B?N05EMXdLVUYwbXV1bytwRVo5VTQ4TERqQllMdThUenVSNW1LMjJOcFhWOW5t?= =?utf-8?B?aXlhOGRWaUNUVUtHTUFqRnBjRFo5VlNWVlFsU05hLytJcjl3WlpRR050bjVz?= =?utf-8?B?UmIyMzFSZmZMaWlyTkhPQkNoYkRYOEhmN0tzUFdJa1JXc3BVdWw4U2NXbUkz?= =?utf-8?B?bXpJV0hTc09DaVRsV2NjbG5VTnJMRkVvaytnWU95UUpSRTFnZTRGVVBNaUt0?= =?utf-8?B?M2p5Y3pXZHNmMjNibmZPYjlMTHF6YXVqU0g2SXRKQjhGMFlRY1NlVCtGQ2pB?= =?utf-8?B?RmhJL0Myc0xoL0ZWU0tlTXVzb2ZqSTNWUlhnQVIvYjRLYUNLZFpKeFRma1RP?= =?utf-8?B?TS9NREZxb3VvOUEvUUcxbmRpYUkyQ1RIUWpYUTA5UFNhSHV4bGtSNWFIa2lh?= =?utf-8?B?U3pVYWwzTUxwdVkvY04yZnhkdUZ4OUhkU2dZeVhhTVkyQnZzUks5RnJJZWNQ?= =?utf-8?B?WWdpTFNkcUxUbjhxNW1kdHJhbW5LVm1tSWRRcFUyNllGWDg2VFZiM241ajlM?= =?utf-8?B?MnhBOC96bCtFOGU0cWYrb2RjMXlzZzA0OVBDT2wvRnVJYjF0cENIeUxHWHNz?= =?utf-8?B?NXZuRndXNlp5cEdyMFNkQmp4K2RxVldaRTh2VmlWN1VXeVlGd1YzTndwZGNO?= =?utf-8?Q?RDH0MlUylP6OjarMpdEcOUY/p?= X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-Network-Message-Id: 238c7151-e182-4d03-2cb2-08dc013d8d28 X-MS-Exchange-CrossTenant-AuthSource: MN2PR12MB3085.namprd12.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 20 Dec 2023 09:25:05.5991 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: rPErF41OZeZojf/+h1AoDATcJHmE1+jXJV5QLk03DCRtFqIrd0iYEyK7ol9PbnuLZij9tDdErG1p6EaG6EYp3g== X-MS-Exchange-Transport-CrossTenantHeadersStamped: LV3PR12MB9329 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org --------------hdjE7ctMA5CR7aAPyj9TmWhT Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Got `Superseded` is there a new version shared for `AMD tuning guide`? On 10/10/2023 9:04 PM, Vipin Varghese wrote: > Caution: This message originated from an External Source. Use proper caution when opening attachments, clicking links, or responding. > > > Add AMD EPYC SoC tuning guide as new setcion of linux getting > started guide. > > Signed-off-by: Vipin Varghese > --- > doc/guides/linux_gsg/amd_platform.rst | 63 +++++++++++++++++++++++++++ > doc/guides/linux_gsg/index.rst | 1 + > 2 files changed, 64 insertions(+) > create mode 100644 doc/guides/linux_gsg/amd_platform.rst > > diff --git a/doc/guides/linux_gsg/amd_platform.rst b/doc/guides/linux_gsg/amd_platform.rst > new file mode 100644 > index 0000000000..cdb535e9c0 > --- /dev/null > +++ b/doc/guides/linux_gsg/amd_platform.rst > @@ -0,0 +1,63 @@ > +.. SPDX-License-Identifier: BSD-3-Clause > + Copyright(c) 2023 Advanced Micro Devices, Inc. All rights reserved. > + > +How to get best performance on AMD platform > +=========================================== > + > +This document shares step-by-step guide for configuring AMD EPYC SoC across various families for getting best performance for DPDK applications. > +Various factors like BIOS, Numa Per Socket, Memory per Numa, near-far from IO device affects the overall performance. > + > +These are covered in various sections of tuning guides shared below. > + > + > +Tuning Guide for AMD EPYC SoC > +----------------------------- > + > +#. `MILAN`_ > + > +#. `GENOA`_ > + > +#. `BERGAMO|SIENNA`_ > + > + > +General Requirements > +-------------------- > + > +Memory > +~~~~~~ > + > +Refer `Memory Configuration` section for SoC specific details. > + > +Note: general thumb rule is to ensure that each memory channel has at least one memory DIMM populated. The ideal memory size for each is at least 8|16|32 GB ECC modules. > + > + > +BIOS > +---- > + > +Refer `BIOS Performance` section in tuning guide for recommended settings. > + > + > +Linux Grub > +---------- > + > +Refer `Linux OS & Kernel` in tuning guide for recommended settings. > + > + > +NIC and Accelerator > +------------------- > + > +AMD EPYC supports PCIe Generation of 1|2|3|4|5 depending upon SoC families. For best performance ensure the right slots are used which provides adequate bandwidth. > + > +Use ``lspci`` to check the speed of a PCI slot :: > + > + lspci -s 41:00.0 -vv | grep LnkSta > + > + LnkSta: Speed 16GT/s, Width x16, TrErr- Train- SlotClk+ DLActive- ... > + LnkSta2: Current De-emphasis Level: -6dB, EqualizationComplete+ ... > + > + > +Compiler > +------- > + > +Refer `Compiler Flags` for recommended version and `-march` flags. > + > diff --git a/doc/guides/linux_gsg/index.rst b/doc/guides/linux_gsg/index.rst > index c3e67bf9ec..ecdaf35eec 100644 > --- a/doc/guides/linux_gsg/index.rst > +++ b/doc/guides/linux_gsg/index.rst > @@ -21,3 +21,4 @@ Getting Started Guide for Linux > linux_eal_parameters > enable_func > nic_perf_intel_platform > + amd_platform > -- > 2.34.1 > --------------hdjE7ctMA5CR7aAPyj9TmWhT Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: 7bit

Got `Superseded` is there a new version shared for `AMD tuning guide`?

On 10/10/2023 9:04 PM, Vipin Varghese wrote:
Caution: This message originated from an External Source. Use proper caution when opening attachments, clicking links, or responding.


Add AMD EPYC SoC tuning guide as new setcion of linux getting
started guide.

Signed-off-by: Vipin Varghese <vipin.varghese@amd.com>
---
 doc/guides/linux_gsg/amd_platform.rst | 63 +++++++++++++++++++++++++++
 doc/guides/linux_gsg/index.rst        |  1 +
 2 files changed, 64 insertions(+)
 create mode 100644 doc/guides/linux_gsg/amd_platform.rst

diff --git a/doc/guides/linux_gsg/amd_platform.rst b/doc/guides/linux_gsg/amd_platform.rst
new file mode 100644
index 0000000000..cdb535e9c0
--- /dev/null
+++ b/doc/guides/linux_gsg/amd_platform.rst
@@ -0,0 +1,63 @@
+..  SPDX-License-Identifier: BSD-3-Clause
+    Copyright(c) 2023 Advanced Micro Devices, Inc. All rights reserved.
+
+How to get best performance on AMD platform
+===========================================
+
+This document shares step-by-step guide for configuring AMD EPYC SoC across various families for getting best performance for DPDK applications.
+Various factors like BIOS, Numa Per Socket, Memory per Numa, near-far from IO device affects the overall performance.
+
+These are covered in various sections of tuning guides shared below.
+
+
+Tuning Guide for AMD EPYC SoC
+-----------------------------
+
+#. `MILAN <https://www.amd.com/content/dam/amd/en/documents/epyc-technical-docs/tuning-guides/data-plane-development-kit-tuning-guide-amd-epyc7003-series-processors.pdf>`_
+
+#. `GENOA <https://www.amd.com/content/dam/amd/en/documents/epyc-technical-docs/tuning-guides/58017-amd-epyc-9004-tg-data-plane-dpdk.pdf>`_
+
+#. `BERGAMO|SIENNA <https://www.amd.com/content/dam/amd/en/documents/epyc-technical-docs/tuning-guides/58310_amd-epyc-8004-tg-data-plane-dpdk.pdf>`_
+
+
+General Requirements
+--------------------
+
+Memory
+~~~~~~
+
+Refer `Memory Configuration` section for SoC specific details.
+
+Note: general thumb rule is to ensure that each memory channel has at least one memory DIMM populated. The ideal memory size for each is at least 8|16|32 GB ECC modules.
+
+
+BIOS
+----
+
+Refer `BIOS Performance` section in tuning guide for recommended settings.
+
+
+Linux Grub
+----------
+
+Refer `Linux OS & Kernel` in tuning guide for recommended settings.
+
+
+NIC and Accelerator
+-------------------
+
+AMD EPYC supports PCIe Generation of 1|2|3|4|5 depending upon SoC families. For best performance ensure the right slots are used which provides adequate bandwidth.
+
+Use ``lspci`` to check the speed of a PCI slot ::
+
+      lspci -s 41:00.0 -vv | grep LnkSta
+
+      LnkSta: Speed 16GT/s, Width x16, TrErr- Train- SlotClk+ DLActive- ...
+      LnkSta2: Current De-emphasis Level: -6dB, EqualizationComplete+ ...
+
+
+Compiler
+-------
+
+Refer `Compiler Flags` for recommended version and `-march` flags.
+
diff --git a/doc/guides/linux_gsg/index.rst b/doc/guides/linux_gsg/index.rst
index c3e67bf9ec..ecdaf35eec 100644
--- a/doc/guides/linux_gsg/index.rst
+++ b/doc/guides/linux_gsg/index.rst
@@ -21,3 +21,4 @@ Getting Started Guide for Linux
     linux_eal_parameters
     enable_func
     nic_perf_intel_platform
+    amd_platform
--
2.34.1
--------------hdjE7ctMA5CR7aAPyj9TmWhT--