Skip to content

Commit 23040ab

Browse files
authored
Merge branch 'main' into update-text-and-images-for-Installation-Guide-of-VMWare-to-7.0.3
2 parents b356a96 + b6830bb commit 23040ab

File tree

4 files changed

+58
-5
lines changed

4 files changed

+58
-5
lines changed

source/adminguide/hosts.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -246,7 +246,7 @@ devices on a KVM host. The script is located in the
246246
``/usr/share/cloudstack-common/scripts/vm/`` directory on the host. The script
247247
relies on the ``lspci`` & ``xmlstarlet`` command to discover the GPU devices
248248
and their status on the host. So, for the discovery to be successful, the
249-
``lspci`` & ``xmlstarlet`` commands needs to be installed on the host.
249+
``lspci`` & ``xmlstarlet`` should be installed on the host.
250250

251251
.. parsed-literal::
252252
@@ -266,7 +266,7 @@ and their status on the host. So, for the discovery to be successful, the
266266
=============================== ================== =======================
267267
Legacy: SR-IOV not supported `mdev` Yes
268268
SR-IOV supported `mdev` Yes
269-
SR-IOV supported `Vendor specific` No
269+
SR-IOV supported `Vendor specific` Yes
270270
Multi Instance GPU No
271271
=============================== ================== =======================
272272

source/adminguide/service_offerings.rst

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -306,7 +306,9 @@ To create a new compute offering:
306306
- **GPU Display**: Whether to use the GPU device attached to the guest instance for display.
307307
This is applicable only for KVM hypervisor. Depending on the OS and display configuration,
308308
the user might need to set ``video.hardware`` to ``none`` in the instance's settings to
309-
use CPVM for display.
309+
use CPVM for display. To set the ``video.hardware`` setting, navigate to
310+
the instance's details page in the CloudStack UI, click on the
311+
"Settings" tab, and add/or update the ``video.hardware`` setting to ``none``.
310312

311313
- **Public**: Indicate whether the compute offering should be
312314
available to all domains or only some domains. Choose Yes to make it

source/installguide/hypervisor/kvm.rst

Lines changed: 20 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -165,6 +165,19 @@ KVM Instances.
165165
is the selected/active one (in case you had a previous Java version already installed)
166166
with ``alternatives --config java``, after CloudStack agent is installed.
167167

168+
.. note::
169+
SUSE Linux Enterprise Server 15 (SP7) requires the following steps to install Java 17 and prepare the host.
170+
171+
.. parsed-literal::
172+
173+
SUSEConnect --product sle-module-legacy/15.7/x86_64
174+
zypper install java-17-openjdk-17.0.15.0-150400.3.54.1
175+
SUSEConnect --product PackageHub/15.7/x86_64
176+
zypper install rng-tools
177+
wget https://download.opensuse.org/repositories/openSUSE:/Leap:/15.2/standard/noarch/timezone-java-2020a-lp152.2.1.noarch.rpm
178+
rpm -ivh timezone-java-2020a-lp152.2.1.noarch.rpm
179+
180+
168181
Configure package repository
169182
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
170183

@@ -229,7 +242,7 @@ information.
229242
230243
[cloudstack]
231244
name=cloudstack
232-
baseurl=http://download.cloudstack.org/suse/|version|/
245+
baseurl=http://download.cloudstack.org/suse/$releasever/|version|/
233246
enabled=1
234247
gpgcheck=0
235248
@@ -298,6 +311,11 @@ In SUSE:
298311
299312
$ zypper install cloudstack-agent
300313
314+
SUSE Linux Enterprise Server 15 (SP7) requires the following entry to be made in the /etc/cloudstack/agent/agent.properties file; the clock speed can be set to match the host CPU.
315+
316+
.. parsed-literal::
317+
318+
host.cpu.manual.speed.mhz=2350
301319
302320
The host is now ready to be added to a cluster. This is covered in a
303321
later section, see :ref:`adding-a-host`. It is
@@ -472,7 +490,7 @@ cloudstack-agent and should already be installed.
472490
473491
#LIBVIRTD_ARGS="--listen"
474492
475-
Configure libvirt to connect to libvirtd and not to per-driver daemons, especially important on newer distros such as EL9 and Ubuntu 24.04.
493+
Configure libvirt to connect to libvirtd and not to per-driver daemons, especially important on newer distros such as EL9, SUSE 15 SP7 and Ubuntu 24.04.
476494
Edit ``/etc/libvirt/libvirt.conf`` and add the following:
477495

478496
.. parsed-literal::

source/installguide/optional_installation.rst

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -114,6 +114,39 @@ For storing certificates, admins can create and configure a java keystore file
114114
and configure the same in the server.properties file as illustrated above.
115115

116116

117+
Health Checks and Monitoring (Optional)
118+
---------------------------------------
119+
120+
CloudStack has a plugin for exporting metrics in the format that Prometheus can consume.
121+
This is done by enabling the following configuration parameters in the Global Settings.
122+
123+
.. parsed-literal::
124+
125+
# cloudmonkey update configuration name=prometheus.exporter.enable value=true
126+
# cloudmonkey update configuration name=prometheus.exporter.port value=9595
127+
# cloudmonkey update configuration name=prometheus.exporter.allowed.ips value="127.0.0.1,192.168.0.10"
128+
129+
.. note::
130+
These settings are available to be configured via the CloudStack UI as well.
131+
CloudStack Management needs to be restarted for the changes to take effect.
132+
Replace the mock IP address 192.168.0.10 with the actual IP address of the Prometheus server.
133+
134+
.. warning::
135+
A list of addresses can be provided as a comma separated list. It does NOT accept CIDR notation.
136+
137+
Then, configure prometheus to start pulling metrics by adding the following configuration to ``/etc/prometheus/prometheus.yml``.
138+
139+
.. parsed-literal::
140+
141+
- job_name: 'management'
142+
static_configs:
143+
- targets: ['192.168.0.20:9595']
144+
145+
.. note::
146+
Replace the mock IP address 192.168.0.20 with the actual IP address of the Management server.
147+
Public dashboards are available in the Grafana repository for visualizing CloudStack Management metrics.
148+
149+
117150
Database Replication (Optional)
118151
-------------------------------
119152

0 commit comments

Comments
 (0)