This is an automated email from the ASF dual-hosted git repository.
nvazquez pushed a commit to branch 4.20
in repository https://gitbox.apache.org/repos/asf/cloudstack-documentation.git
The following commit(s) were added to refs/heads/4.20 by this push:
new ac474765 Updated configuration details for Management and KVM Agent
services (#623)
ac474765 is described below
commit ac474765b58e704cafe5383224eeadf43e78e96b
Author: Suresh Kumar Anaparti <[email protected]>
AuthorDate: Wed Feb 18 19:22:33 2026 +0530
Updated configuration details for Management and KVM Agent services (#623)
* Updated configuration details for Management and KVM Agent services
* indentation correction
* review changes
* Update for usage server and ssvm, and move tuning to dir
---
source/adminguide/index.rst | 2 +-
.../adminguide/tuning/disable_omit_stack_trace.rst | 55 ++++++++++++++++++++++
source/adminguide/{ => tuning}/tuning.rst | 3 ++
source/installguide/hypervisor/kvm.rst | 47 ++++++++++++++++++
4 files changed, 106 insertions(+), 1 deletion(-)
diff --git a/source/adminguide/index.rst b/source/adminguide/index.rst
index a3aad694..9bfe226b 100644
--- a/source/adminguide/index.rst
+++ b/source/adminguide/index.rst
@@ -176,7 +176,7 @@ Tuning
.. toctree::
:maxdepth: 4
- tuning
+ tuning/tuning
Events and Troubleshooting
diff --git a/source/adminguide/tuning/disable_omit_stack_trace.rst
b/source/adminguide/tuning/disable_omit_stack_trace.rst
new file mode 100644
index 00000000..79e7b887
--- /dev/null
+++ b/source/adminguide/tuning/disable_omit_stack_trace.rst
@@ -0,0 +1,55 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+
+Disable Omit Stack Trace
+------------------------
+
+The JVM, by default stops printing some stack traces in the logs. To enable
printing full stack traces at all times:
+
+#. Edit the following configuration file for the respective service to disable
there and restart it:
+
+ - For cloudstack-management.service in the Management Server:
+
+ .. code:: bash
+
+ /etc/default/cloudstack-management
+
+ - For cloudstack-usage.service in the Usage Server:
+
+ .. code:: bash
+
+ /etc/default/cloudstack-usage
+
+ - For cloudstack-agent.service in the KVM Host:
+
+ .. code:: bash
+
+ /etc/default/cloudstack-agent
+
+ - For cloud.service in the SSVM:
+
+ .. code:: bash
+
+ /usr/local/cloud/systemvm/_run.sh
+
+#. Add the command-line parameter -XX:-OmitStackTraceInFastThrow to disable
the omit stack trace flag in the JVM so that all
+ the stack traces are always printed on the logs. This flag is enabled by
default in the JVM to omit the stack traces
+ for certain exceptions that are thrown frequently. Printing of the stack
traces might impact performance, and is not
+ recommended for production, so it's better to disable this flag for
troubleshooting or debugging purposes when required.
+
+ .. code:: bash
+
+ JAVA_OPTS="... -XX:-OmitStackTraceInFastThrow"
diff --git a/source/adminguide/tuning.rst b/source/adminguide/tuning/tuning.rst
similarity index 99%
rename from source/adminguide/tuning.rst
rename to source/adminguide/tuning/tuning.rst
index bb214602..bc8cb35d 100644
--- a/source/adminguide/tuning.rst
+++ b/source/adminguide/tuning/tuning.rst
@@ -57,6 +57,9 @@ For more information about memory issues, see "FAQ: Memory"
at `Tomcat
Wiki. <http://wiki.apache.org/tomcat/FAQ/Memory>`_
+.. include:: disable_omit_stack_trace.rst
+
+
Set Database Buffer Pool Size
-----------------------------
diff --git a/source/installguide/hypervisor/kvm.rst
b/source/installguide/hypervisor/kvm.rst
index d450a459..5c0ec09a 100644
--- a/source/installguide/hypervisor/kvm.rst
+++ b/source/installguide/hypervisor/kvm.rst
@@ -310,6 +310,53 @@ sudoers file:
cloudstack ALL=NOPASSWD: /usr/bin/cloudstack-setup-agent
Defaults:cloudstack !requiretty
+Limit Resources For the Agent Service
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+#. Edit the cloudstack-agent.service file at:
+
+ .. code:: bash
+
+ /usr/lib/systemd/system/cloudstack-agent.service
+
+#. You can set the following resource controls in the cloudstack-agent service:
+
+ - Limit the number of file descriptors
+
+ The default configuration is usually higher, set to a lower number
explicitly when required. It is observed
+ that the average FDs for a host with 40 VMs was 380, we can reserve +20%
based on the requirement. Example
+ shown below.
+
+ .. code:: bash
+
+ LimitNOFILE=1500
+
+ - Limit the memory usage
+
+ You can limit the memory usage. For example, set to 2500MB (2500 * 1024 *
1024 bytes) as shown below.
+
+ .. code:: bash
+
+ MemoryMax=2500M
+
+ - Limit the CPU quota
+
+ You can control the CPU allocation. For example, set to allow 2 full cores
worth of CPU time as shown below.
+
+ .. code:: bash
+
+ CPUQuota=200%
+
+#. Reload and restart the cloudstack-agent service after changing any of the
resource controls:
+
+ .. code:: bash
+
+ sudo systemctl daemon-reload
+ sudo systemctl restart cloudstack-agent
+
+
+.. include:: ../../adminguide/tuning/disable_omit_stack_trace.rst
+
Configure CPU model for KVM guest (Optional)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
