Long-Term Supported 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备份