-
Notifications
You must be signed in to change notification settings - Fork 31
CLOS-3583: Update physical memory limit documentation #281
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: master
Are you sure you want to change the base?
Conversation
Add information about configuring a system-wide lower bound for pmem limit
docs/cloudlinuxos/limits/README.md
Outdated
|
|
||
| #### Physical memory lower bound | ||
|
|
||
| CloudLinux OS allows administrators to configure a lower bound (minimum value) for physical memory (PMEM) limits to prevent setting limits that are too low and could cause application instability. When a lower bound is configured, any attempt to set a PMEM limit below this threshold will be rejected with an error message. This helps ensure that hosting accounts always have sufficient memory allocated for basic application requirements, preventing performance issues and unexpected application failures. The lower bound is enforced system-wide and applies to all limit-setting operations, whether performed through command-line tools or control panel integrations. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
will be rejected with an error message
"... displayed by CLI tool or Cloudlinux Manager UI".
This way we explain what to expect from UX standpoint.
docs/cloudlinuxos/limits/README.md
Outdated
|
|
||
| #### Physical memory lower bound | ||
|
|
||
| CloudLinux OS allows administrators to configure a lower bound (minimum value) for physical memory (PMEM) limits to prevent setting limits that are too low and could cause application instability. When a lower bound is configured, any attempt to set a PMEM limit below this threshold will be rejected with an error message. This helps ensure that hosting accounts always have sufficient memory allocated for basic application requirements, preventing performance issues and unexpected application failures. The lower bound is enforced system-wide and applies to all limit-setting operations, whether performed through command-line tools or control panel integrations. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
system-wide
I would format this with bold font.
| <div class="notranslate"> | ||
|
|
||
| ``` | ||
| lvectl --set-pmem-lower-bound 512M |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
lvectl
This may be too late to ask, but why did we decide to make it configurable via 2 CLI tools instead of only one? :)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
cloudlinux-limits can be used from the CLI, however it is an interface for the UI mainly. It only works with --json flag (for other options as well) and might be useful if in the future we decide to have the ability to set this lower bound from the UI. Initially I implemented it only for lvectl and Roman requested to do the same for cloudlinux-limits
|
|
||
| The lower bound value accepts standard memory format notations (e.g., <span class="notranslate">`512M`</span>, <span class="notranslate">`1G`</span>, <span class="notranslate">`2048M`</span>). | ||
|
|
||
| The configured PMEM lower bound value is stored in the <span class="notranslate">`/etc/sysconfig/limits_lower_bounds`</span> configuration file. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Makes sense to indicate what is the default value out of the box i.e. not configured.
Add information about configuring a system-wide lower bound for pmem limit