Long-Term Supported Versions

    Innovation Versions

      Best Practices

      Huge Page Configuration


      StratoVirt supports the configuration of huge pages for VMs. Compared with the traditional 4K memory page mode, huge page memory can effectively reduce the number of TLB misses and page fault interrupts, significantly improving the performance of memory-intensive services.


      • The directory to which the huge pages are mounted must be an absolute path.
      • Memory huge pages can be configured only during startup.
      • Only static huge pages are supported.
      • Configure huge pages on the host before use.
      • To use the huge page feature, ensure that the VM memory size is an integer multiple of huge page size.

      Mutually Exclusive Features

      • If huge pages are configured, the balloon feature becomes invalid.

      Configuration Methods

      Configuring Huge Pages on the Host

      Mount the huge page file system to a specified directory. /path/to/hugepages is the user-defined empty directory.

      $ mount -t hugetlbfs hugetlbfs /path/to/hugepages
      Setting the Number of Huge Pages
      • Set the number of static huge pages. num indicates the specified number.

        $ sysctl vm.nr_hugepages=num
      • Query huge page statistics.

        $ cat /proc/meminfo | grep Hugepages

        To view statistics about huge pages of other sizes, view the related information in the /sys/kernel/mm/hugepages/hugepages-*/ directory.

      Notice Configure the StratoVirt memory specifications and huge pages based on the huge page usage. If the huge page resources are insufficient, the VM fails to be started.

      Huge Page Configuration During StratoVirt Startup

      • CLI

        -mem-path /page/to/hugepages

        In the preceding command, /page/to/hugepages indicates the directory to which the huge page file system is mounted. Only absolute paths are supported.

      • JSON file

            "machine-config": {
                "mem_path": "/page/to/hugepages",

        In the preceding command, /page/to/hugepages indicates the directory to which the huge page file system is mounted. Only absolute paths are supported.

      Note Typical configuration: Set mem-path in the StratoVirt command line to the huge page file system mount directory. The StratoVirt huge page feature is recommended for the typical configuration.

      Performance Improvement

      Memory Noise Floor

      To achieve the optimal memory noise floor, developers can use the methods provided by WIKI on the StratoVirt homepage for compilation and testing.


      Cold Startup Time

      To reduce the cold startup time, developers can also use the methods provided on by WIKI on the StratoVirt homepage to perform compilation tests.


      Bug Catching

      Buggy Content

      Bug Description

      Submit As Issue

      It's a little complicated....

      I'd like to ask someone.


      Just a small problem.

      I can fix it online!

      Bug Type
      Specifications and Common Mistakes

      ● Misspellings or punctuation mistakes;

      ● Incorrect links, empty cells, or wrong formats;

      ● Chinese characters in English context;

      ● Minor inconsistencies between the UI and descriptions;

      ● Low writing fluency that does not affect understanding;

      ● Incorrect version numbers, including software package names and version numbers on the UI.


      ● Incorrect or missing key steps;

      ● Missing prerequisites or precautions;

      ● Ambiguous figures, tables, or texts;

      ● Unclear logic, such as missing classifications, items, and steps.


      ● Technical principles, function descriptions, or specifications inconsistent with those of the software;

      ● Incorrect schematic or architecture diagrams;

      ● Incorrect commands or command parameters;

      ● Incorrect code;

      ● Commands inconsistent with the functions;

      ● Wrong screenshots.

      Risk Warnings

      ● Lack of risk warnings for operations that may damage the system or important data.

      Content Compliance

      ● Contents that may violate applicable laws and regulations or geo-cultural context-sensitive words and expressions;

      ● Copyright infringement.

      How satisfied are you with this document

      Not satisfied at all
      Very satisfied
      Click to create an issue. An issue template will be automatically generated based on your feedback.
      Bug Catching
      编组 3备份