On 9/20/2023 4:48 PM, David Young wrote: > --- > .../getting_started_guide/system_setup.rst | 195 ++++++++++++++++++ > 1 file changed, 195 insertions(+) > create mode 100644 doc/guides/getting_started_guide/system_setup.rst > > diff --git a/doc/guides/getting_started_guide/system_setup.rst > b/doc/guides/getting_started_guide/system_setup.rst > new file mode 100644 > index 0000000000..fa9d249ec7 > --- /dev/null > +++ b/doc/guides/getting_started_guide/system_setup.rst > @@ -0,0 +1,195 @@ > +.. SPDX-License-Identifier: BSD-3-Clause > + Copyright(c) 2010-2025 Intel Corporation. > + > +.. _memory_setup: > + > +.. |reg| unicode:: U+000AE > + > +Setting up a System to Run DPDK Applications > +============================================ > + > +This section provides step-by-step instructions for setting up your system > to run DPDK applications. It covers system configurations for Linux, FreeBSD, > and Windows. Each section details the necessary memory and device setups for > these operating systems. > + > +Navigate to the section that corresponds to your operating system to begin > the setup process. > +
Not sure above sentences adds value. > +.. contents:: Table of Contents > + :local: > + > +System Setup for Linux > +---------------------- > + > +Memory Setup: Reserving Hugepages > +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ > + > +For Linux, DPDK requires hugepages be reserved for its use on the system. To > check if hugepages are are on your system, you can run the following command:: > + > + grep HugePages_Total /proc/meminfo > + > +If hugepages are not reserved, you will need to reserve them by following > these steps: > + > +1. Determine the number of hugepages you want to allocate. For example, to > allocate 1024 hugepages of 2MB each, you can use the following command:: > + > + echo 1024 | sudo tee > /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages > + > +2. To make the hugepages configuration persistent across reboots, add the > following line to your `/etc/sysctl.conf` file, adjusting the number of > hugepages as needed:: > + > + vm.nr_hugepages = 1024 > + > +3. Most distributions make hugepages available via `/dev/hugepages`, so this > step may not be necessary. If you need to manually mount the hugepages > filesystem, add the following line to your `/etc/fstab` file:: > + > + nodev /mnt/huge hugetlbfs defaults 0 0 > + > + Then, create the mount directory and mount the filesystem:: > + > + mkdir -p /mnt/huge > + mount -a > + > We have './usertools/dpdk-hugepages.py' script for this, which I am using regularly. Script is wrapper to what described above, so I think good to explain basics, but also may worth mentioning from script, it is more user friendly than above instructions.