Skip to content

Create SLE Minimal VM article - #771

Open
eromanova97 wants to merge 2 commits into
mainfrom
DOCTEAM-2162
Open

Create SLE Minimal VM article#771
eromanova97 wants to merge 2 commits into
mainfrom
DOCTEAM-2162

Conversation

@eromanova97

@eromanova97 eromanova97 commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

PR creator: Description

Create SLE Minimal VM article for v16.
note: I restructured the guide based on several Jira tickets/bugs that were created for the Minimal VM (separating cloud-init vs non-cloud-init, adding Combustion details, etc.)

PR creator: Are there any relevant issues/feature requests?

Previews

SLES4SAP: SAP-Minimal-VM_en.pdf
SLES: SLES-Minimal-VM_en.pdf

@grisu48 grisu48 left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is good work!

I have added some suggestions here. My wording is not the best, so please feel free to edit the suggestions to make it better understandable.

Thank you for the documentation!

Comment thread concepts/minimal-vm-intro.xml Outdated
Comment thread concepts/minimal-vm-vs-sles.xml Outdated
Comment thread concepts/minimal-vm-intro.xml Outdated
Comment thread concepts/minimal-vm-get.xml Outdated
Comment thread tasks/minimal-vm-without-cloud-init.xml Outdated
Comment on lines +65 to +71
<term>Migration</term>
<listitem>
<para>
Because &leap; &minvm; and &sleminvm; are similar, it is easy to migrate from one to the
other.
<!-- need to confirm this is true for sles4sap as well-->
</para>

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I need confirmation if this is a supported flow, as per: https://suse.slack.com/archives/C02CAFDT3MY/p1787210248680399?thread_ts=1787148862.242729&cid=C02CAFDT3MY

if not, I will remove it from the documentation.

<listitem>
<para>
You want to know what &minvm; can do for you.
General familiarity with &productname;

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For some reason the layout in the PDF is a bit wrong:

Image

</para>
<para>
<literal>kvm-and-xen</literal> for &kvm; and &xen; hypervisors
<!-- Xen needs confirmation for x86_64 in SLE 16 -->

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, I'm also not sure about official support. From a technical PoV it should work at least.

<term>Deployment with cloud-init</term>
<listitem>
<para>
Cloud platforms: The cloud image is configured automatically on first boot by

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The Cloud images actually contain jeos-firstboot as well, as fallback in case there was no cloud-init configuration supplied. So this could potentially be merged with the section below.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh good to know! Thank you, I will rephare the documentation to have this clear 👍

<itemizedlist>
<listitem>
<para>
Interactive (default): The &jeosfirstboot; wizard prompts you to set timezone,

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As usual, there is an exception: On s390x-(dasd|fba|fcp) flavors (targeting z/VM), jeos-firstboot cannot be used (x3270 terminal not supported), so systemd-firstboot is used instead

<para>
Because &leap; &minvm; and &sleminvm; are similar, it is easy to migrate from one to the
other.
<!-- need to confirm this is true for sles4sap as well-->

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Probably not - there is no Leap 4 SAP

<listitem>
<para>
24&nbsp;GB Linux file system
24&nbsp;GB &rootuser; file system in non-cloud deployments

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think &rootuser; fits this context

<para>
Reboot the system or use the <command>sysctl --system</command>
command to enable core dumps.
A dynamically sized &rootuser; file system in cloud deployments

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same here

<para>
For further information, refer to
<link xlink:href="https://documentation.suse.com/sles/html/SLES-all/cha-tuning-systemd-coredump.html"/>.
To add space, either extend the existing disk from the virtual host, or add a secondary

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe mention that the initrd will automatically try to resize the / partition and filesystem to fill the disk on every boot (until the initrd is rebuilt and no longer contains kiwi-repart)?

</para>
</warning>
<para>
When creating users, keep in mind that logging in with a password is disabled by default, and

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

local logins may still use passwords and for e.g. the dracut emergency shell it's still necessary

during the first boot.
</para>
<example xml:id="qemu-guest-agent">
<title>Add <package>qemu-guest-agent</package> and start a service</title>

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: That's already installed on all Cloud images

@Vogtinator

Copy link
Copy Markdown
Member

(I'm not fully done with the review yet, just submitted the comments I already wrote)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants