Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions asciidoc/components/linux-micro.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,9 @@ SUSE Edge uses the <<components-eib,Edge Image Builder>> to preconfigure the SUS
SUSE Linux Micro comes with Cockpit to allow the local management of the host through a Web application.

This service is disabled by default but can be started by enabling the systemd service `cockpit.socket`.
As cockpit forbids root login by default, the creation of a user with administrative privileges is recommended, refer to the {link-micro-official-docs}[SUSE Linux Micro official documentation] for more information.



== Known issues

Expand Down
2 changes: 1 addition & 1 deletion asciidoc/components/longhorn.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ SUSE Storage is a lightweight, reliable, and user-friendly distributed block sto

If you are following this guide, it assumes that you have the following already available:

* At least one host with SUSE Linux Micro {version-sl-micro} installed; this can be physical or virtual
* At least one host with SUSE Linux Micro {version-operatingsystem} installed; this can be physical or virtual
* A Kubernetes cluster installed; either K3s or RKE2
* Helm

Expand Down
2 changes: 1 addition & 1 deletion asciidoc/edge-book/version-matrix.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ endif::[]
[options="header"]
|======
| Name | Version | Chart Version
| SUSE Linux Micro | {version-sl-micro} | N/A
| SUSE Linux Micro | {version-operatingsystem} | N/A
| Rancher Prime | {version-rancher-prime} | {version-rancher-prime}
| Fleet | {version-fleet} | {version-fleet-chart}
| K3s | {version-kubernetes-k3s} | N/A
Expand Down
26 changes: 17 additions & 9 deletions asciidoc/edge-book/versions.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -13,14 +13,6 @@
:version-edge: 3.4
:version-edge-registry: 3.4

// == SUSE Linux Micro ==
:micro-base-image-raw: SL-Micro.x86_64-6.1-Base-GM.raw
:micro-base-rt-image-raw: SL-Micro.x86_64-6.1-Base-RT-GM.raw
:micro-base-rt-image-iso: SL-Micro.x86_64-6.1-Base-RT-SelfInstall-GM.install.iso
:micro-base-image-iso: SL-Micro.x86_64-6.1-Base-SelfInstall-GM.install.iso
:micro-default-image-iso: SL-Micro.x86_64-6.1-Default-SelfInstall-GM.install.iso
:version-sl-micro: 6.1

// == Multi-Linux Manager ==
:version-mlm: 5.0.5

Expand Down Expand Up @@ -75,7 +67,7 @@
:version-kubernetes-k3s: v1.33.3+k3s1
:version-kubernetes-rke2: v1.33.3+rke2r1

:version-operatingsystem: 6.1
:version-operatingsystem: 6.2

:version-akri-chart: 304.0.0+up0.12.20
:version-akri-dashboard-extension-chart: 304.0.2+up1.3.1
Expand Down Expand Up @@ -105,6 +97,22 @@
// https://doc.crds.dev/github.com/metal3-io/cluster-api-provider-metal3/infrastructure.cluster.x-k8s.io/Metal3MachineTemplate/[email protected]#spec-template-spec-hostSelector-matchLabels
:version-capi-provider-metal3: [email protected]

// ============================================================================
// Derived Version Entries
//
// The following are derived from previously defined versions, ensure they
// are not using elements defined below them
//
// ============================================================================

// == SUSE Linux Micro ==
:micro-base-image-raw: SL-Micro.x86_64-{version-operatingsystem}-Base-GM.raw
:micro-base-rt-image-raw: SL-Micro.x86_64-{version-operatingsystem}-Base-RT-GM.raw
:micro-base-rt-image-iso: SL-Micro.x86_64-{version-operatingsystem}-Base-RT-SelfInstall-GM.install.iso
:micro-base-image-iso: SL-Micro.x86_64-{version-operatingsystem}-Base-SelfInstall-GM.install.iso
:micro-default-image-iso: SL-Micro.x86_64-{version-operatingsystem}-Default-SelfInstall-GM.install.iso


// ============================================================================
// Manual Version Entries
//
Expand Down
14 changes: 7 additions & 7 deletions asciidoc/guides/kiwi-builder-images.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -24,23 +24,23 @@ This process makes use of https://osinside.github.io/kiwi/[Kiwi] to run the imag
* "*Default*" - A SUSE Linux Micro disk image based on the "Base" above but with a few more tools, including the virtualization stack, Cockpit and salt-minion.
* "*Default-SelfInstall*" - A SelfInstall image based on the "Default" above

See https://documentation.suse.com/sle-micro/{version-sl-micro}/html/Micro-deployment-images/index.html#alp-images-installer-type[SUSE Linux Micro {version-sl-micro}] documentation for more details.
See https://documentation.suse.com/sle-micro/{version-operatingsystem}/html/Micro-deployment-images/index.html#alp-images-installer-type[SUSE Linux Micro {version-operatingsystem}] documentation for more details.

NOTE: This process works for both {x86-64} and {aarch64} architectures but it is necessary to use a build host with the same architecture of the images being built. In other words, to build an {aarch64} image, it is required to use an {aarch64} build host, and vice-versa for {x86-64} - cross-builds are not supported at this time.

== Prerequisites

Kiwi image builder requires the following:

* A SUSE Linux Micro {version-sl-micro} host ("build system") with the same architecture of the image being built.
* A SUSE Linux Micro {version-operatingsystem} host ("build system") with the same architecture of the image being built.
* The build system needs to be already registered via `SUSEConnect` (the registration is used to pull the latest packages from the SUSE repositories)
* An internet connection that can be used to pull the required packages. If connected via proxy, the build host needs to be pre-configured.
* SELinux needs to be disabled on the build host (as SELinux labelling takes place in the container and it can conflict with the host policy)
* At least 10GB free disk space to accommodate the container image, the build root, and the resulting output image(s)

== Getting Started

Due to certain limitations, it is currently required to disable SELinux. Connect to the SUSE Linux Micro {version-sl-micro} image build host and ensure SELinux is disabled:
Due to certain limitations, it is currently required to disable SELinux. Connect to the SUSE Linux Micro {version-operatingsystem} image build host and ensure SELinux is disabled:

[,console]
----
Expand Down Expand Up @@ -88,10 +88,10 @@ After a few minutes the images can be found in the local output directory:
INFO: Image build successful, generated images are available in the 'output' directory.

# ls -1 output/
SLE-Micro.x86_64-{version-sl-micro}.changes
SLE-Micro.x86_64-{version-sl-micro}.packages
SLE-Micro.x86_64-{version-sl-micro}.raw
SLE-Micro.x86_64-{version-sl-micro}.verified
SLE-Micro.x86_64-{version-operatingsystem}.changes
SLE-Micro.x86_64-{version-operatingsystem}.packages
SLE-Micro.x86_64-{version-operatingsystem}.raw
SLE-Micro.x86_64-{version-operatingsystem}.verified
build
kiwi.result
kiwi.result.json
Expand Down
8 changes: 1 addition & 7 deletions asciidoc/product/atip-automated-provision.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -123,7 +123,6 @@ image:
operatingSystem:
kernelArgs:
- ignition.platform.id=openstack
- net.ifnames=1
systemd:
disable:
- rebootmgr
Expand Down Expand Up @@ -152,11 +151,7 @@ For the production environments, it is recommended to use the SSH keys that can
====
`arch: x86_64` is the architecture of the image. For arm64 architecture, use `arch: aarch64`.

`net.ifnames=1` enables https://documentation.suse.com/smart/network/html/network-interface-predictable-naming/index.html[Predictable Network Interface Naming]

This matches the default configuration for the metal3 chart, but the setting must match the configured chart `predictableNicNames` value.

Also note `ignition.platform.id=openstack` is mandatory, without this argument SLEMicro configuration via ignition will fail in the Metal^3^ automated flow.
Note `ignition.platform.id=openstack` is mandatory, without this argument SLEMicro configuration via ignition will fail in the Metal^3^ automated flow.
====

[#add-custom-script-growfs]
Expand Down Expand Up @@ -240,7 +235,6 @@ image:
operatingSystem:
kernelArgs:
- ignition.platform.id=openstack
- net.ifnames=1
systemd:
disable:
- rebootmgr
Expand Down
11 changes: 5 additions & 6 deletions asciidoc/product/atip-features.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -123,14 +123,14 @@ This provides an example of kernel arguments for a 32-core Intel server, includi
[,shell]
----
$ cat /proc/cmdline
BOOT_IMAGE=/boot/vmlinuz-6.4.0-9-rt root=UUID=77b713de-5cc7-4d4c-8fc6-f5eca0a43cf9 skew_tick=1 rd.timeout=60 rd.retry=45 console=ttyS1,115200 console=tty0 default_hugepagesz=1G hugepagesz=1G hugepages=40 hugepagesz=2M hugepages=0 ignition.platform.id=openstack intel_iommu=on iommu=pt irqaffinity=0,31,32,63 isolcpus=domain,nohz,managed_irq,1-30,33-62 nohz_full=1-30,33-62 nohz=on mce=off net.ifnames=0 nosoftlockup nowatchdog nmi_watchdog=0 quiet rcu_nocb_poll rcu_nocbs=1-30,33-62 rcupdate.rcu_cpu_stall_suppress=1 rcupdate.rcu_expedited=1 rcupdate.rcu_normal_after_boot=1 rcupdate.rcu_task_stall_timeout=0 rcutree.kthread_prio=99 security=selinux selinux=1 idle=poll
BOOT_IMAGE=/boot/vmlinuz-6.4.0-9-rt root=UUID=77b713de-5cc7-4d4c-8fc6-f5eca0a43cf9 skew_tick=1 rd.timeout=60 rd.retry=45 console=ttyS1,115200 console=tty0 default_hugepagesz=1G hugepagesz=1G hugepages=40 hugepagesz=2M hugepages=0 ignition.platform.id=openstack intel_iommu=on iommu=pt irqaffinity=0,31,32,63 isolcpus=domain,nohz,managed_irq,1-30,33-62 nohz_full=1-30,33-62 nohz=on mce=off nosoftlockup nowatchdog nmi_watchdog=0 quiet rcu_nocb_poll rcu_nocbs=1-30,33-62 rcupdate.rcu_cpu_stall_suppress=1 rcupdate.rcu_expedited=1 rcupdate.rcu_normal_after_boot=1 rcupdate.rcu_task_stall_timeout=0 rcutree.kthread_prio=99 security=selinux selinux=1 idle=poll
----

Here is another configuration example for a 64-core AMD server. Among the 128 logical processors (`0-127`), first 8 cores (`0-7`) are designated for housekeeping, while the remaining 120 cores (`8-127`) are pinned for the applications:
[,shell]
----
$ cat /proc/cmdline
BOOT_IMAGE=/boot/vmlinuz-6.4.0-9-rt root=UUID=575291cf-74e8-42cf-8f2c-408a20dc00b8 skew_tick=1 console=ttyS1,115200 console=tty0 default_hugepagesz=1G hugepagesz=1G hugepages=40 hugepagesz=2M hugepages=0 ignition.platform.id=openstack amd_iommu=on iommu=pt irqaffinity=0-7 isolcpus=domain,nohz,managed_irq,8-127 nohz_full=8-127 rcu_nocbs=8-127 mce=off nohz=on net.ifnames=0 nowatchdog nmi_watchdog=0 nosoftlockup quiet rcu_nocb_poll rcupdate.rcu_cpu_stall_suppress=1 rcupdate.rcu_expedited=1 rcupdate.rcu_normal_after_boot=1 rcupdate.rcu_task_stall_timeout=0 rcutree.kthread_prio=99 security=selinux selinux=1 idle=poll
BOOT_IMAGE=/boot/vmlinuz-6.4.0-9-rt root=UUID=575291cf-74e8-42cf-8f2c-408a20dc00b8 skew_tick=1 console=ttyS1,115200 console=tty0 default_hugepagesz=1G hugepagesz=1G hugepages=40 hugepagesz=2M hugepages=0 ignition.platform.id=openstack amd_iommu=on iommu=pt irqaffinity=0-7 isolcpus=domain,nohz,managed_irq,8-127 nohz_full=8-127 rcu_nocbs=8-127 mce=off nohz=on nowatchdog nmi_watchdog=0 nosoftlockup quiet rcu_nocb_poll rcupdate.rcu_cpu_stall_suppress=1 rcupdate.rcu_expedited=1 rcupdate.rcu_normal_after_boot=1 rcupdate.rcu_task_stall_timeout=0 rcutree.kthread_prio=99 security=selinux selinux=1 idle=poll
----

[#cpu-pinning-host]
Expand Down Expand Up @@ -209,7 +209,7 @@ Edit the `/etc/default/grub` file with above parameters and the file will look l

[,shell]
----
GRUB_CMDLINE_LINUX="BOOT_IMAGE=/boot/vmlinuz-6.4.0-9-rt root=UUID=77b713de-5cc7-4d4c-8fc6-f5eca0a43cf9 skew_tick=1 rd.timeout=60 rd.retry=45 console=ttyS1,115200 console=tty0 default_hugepagesz=1G hugepagesz=1G hugepages=40 hugepagesz=2M hugepages=0 ignition.platform.id=openstack intel_iommu=on iommu=pt irqaffinity=0,31,32,63 isolcpus=domain,nohz,managed_irq,1-30,33-62 nohz_full=1-30,33-62 nohz=on mce=off net.ifnames=0 nosoftlockup nowatchdog nmi_watchdog=0 quiet rcu_nocb_poll rcu_nocbs=1-30,33-62 rcupdate.rcu_cpu_stall_suppress=1 rcupdate.rcu_expedited=1 rcupdate.rcu_normal_after_boot=1 rcupdate.rcu_task_stall_timeout=0 rcutree.kthread_prio=99 security=selinux selinux=1 idle=poll"
GRUB_CMDLINE_LINUX="BOOT_IMAGE=/boot/vmlinuz-6.4.0-9-rt root=UUID=77b713de-5cc7-4d4c-8fc6-f5eca0a43cf9 skew_tick=1 rd.timeout=60 rd.retry=45 console=ttyS1,115200 console=tty0 default_hugepagesz=1G hugepagesz=1G hugepages=40 hugepagesz=2M hugepages=0 ignition.platform.id=openstack intel_iommu=on iommu=pt irqaffinity=0,31,32,63 isolcpus=domain,nohz,managed_irq,1-30,33-62 nohz_full=1-30,33-62 nohz=on mce=off nosoftlockup nowatchdog nmi_watchdog=0 quiet rcu_nocb_poll rcu_nocbs=1-30,33-62 rcupdate.rcu_cpu_stall_suppress=1 rcupdate.rcu_expedited=1 rcupdate.rcu_normal_after_boot=1 rcupdate.rcu_task_stall_timeout=0 rcutree.kthread_prio=99 security=selinux selinux=1 idle=poll"
----

Update the GRUB configuration:
Expand Down Expand Up @@ -1206,7 +1206,7 @@ To enable the parameters, add them to the `/etc/default/grub` file:

[,shell]
----
GRUB_CMDLINE_LINUX="BOOT_IMAGE=/boot/vmlinuz-6.4.0-9-rt root=UUID=77b713de-5cc7-4d4c-8fc6-f5eca0a43cf9 skew_tick=1 rd.timeout=60 rd.retry=45 console=ttyS1,115200 console=tty0 default_hugepagesz=1G hugepagesz=1G hugepages=40 hugepagesz=2M hugepages=0 ignition.platform.id=openstack intel_iommu=on iommu=pt irqaffinity=0,31,32,63 isolcpus=domain,nohz,managed_irq,1-30,33-62 nohz_full=1-30,33-62 nohz=on mce=off net.ifnames=0 nosoftlockup nowatchdog nmi_watchdog=0 quiet rcu_nocb_poll rcu_nocbs=1-30,33-62 rcupdate.rcu_cpu_stall_suppress=1 rcupdate.rcu_expedited=1 rcupdate.rcu_normal_after_boot=1 rcupdate.rcu_task_stall_timeout=0 rcutree.kthread_prio=99 security=selinux selinux=1 idle=poll"
GRUB_CMDLINE_LINUX="BOOT_IMAGE=/boot/vmlinuz-6.4.0-9-rt root=UUID=77b713de-5cc7-4d4c-8fc6-f5eca0a43cf9 skew_tick=1 rd.timeout=60 rd.retry=45 console=ttyS1,115200 console=tty0 default_hugepagesz=1G hugepagesz=1G hugepages=40 hugepagesz=2M hugepages=0 ignition.platform.id=openstack intel_iommu=on iommu=pt irqaffinity=0,31,32,63 isolcpus=domain,nohz,managed_irq,1-30,33-62 nohz_full=1-30,33-62 nohz=on mce=off nosoftlockup nowatchdog nmi_watchdog=0 quiet rcu_nocb_poll rcu_nocbs=1-30,33-62 rcupdate.rcu_cpu_stall_suppress=1 rcupdate.rcu_expedited=1 rcupdate.rcu_normal_after_boot=1 rcupdate.rcu_task_stall_timeout=0 rcutree.kthread_prio=99 security=selinux selinux=1 idle=poll"
----

Update the GRUB configuration and reboot the system to apply the changes:
Expand Down Expand Up @@ -1300,7 +1300,7 @@ Modify the GRUB file `/etc/default/grub` to add them to the kernel command line:

[,shell]
----
GRUB_CMDLINE_LINUX="BOOT_IMAGE=/boot/vmlinuz-6.4.0-9-rt root=UUID=77b713de-5cc7-4d4c-8fc6-f5eca0a43cf9 skew_tick=1 rd.timeout=60 rd.retry=45 console=ttyS1,115200 console=tty0 default_hugepagesz=1G hugepagesz=1G hugepages=40 hugepagesz=2M hugepages=0 ignition.platform.id=openstack intel_iommu=on iommu=pt irqaffinity=0,31,32,63 isolcpus=domain,nohz,managed_irq,1-30,33-62 nohz_full=1-30,33-62 nohz=on mce=off net.ifnames=0 nosoftlockup nowatchdog nmi_watchdog=0 quiet rcu_nocb_poll rcu_nocbs=1-30,33-62 rcupdate.rcu_cpu_stall_suppress=1 rcupdate.rcu_expedited=1 rcupdate.rcu_normal_after_boot=1 rcupdate.rcu_task_stall_timeout=0 rcutree.kthread_prio=99 security=selinux selinux=1 idle=poll"
GRUB_CMDLINE_LINUX="BOOT_IMAGE=/boot/vmlinuz-6.4.0-9-rt root=UUID=77b713de-5cc7-4d4c-8fc6-f5eca0a43cf9 skew_tick=1 rd.timeout=60 rd.retry=45 console=ttyS1,115200 console=tty0 default_hugepagesz=1G hugepagesz=1G hugepages=40 hugepagesz=2M hugepages=0 ignition.platform.id=openstack intel_iommu=on iommu=pt irqaffinity=0,31,32,63 isolcpus=domain,nohz,managed_irq,1-30,33-62 nohz_full=1-30,33-62 nohz=on mce=off nosoftlockup nowatchdog nmi_watchdog=0 quiet rcu_nocb_poll rcu_nocbs=1-30,33-62 rcupdate.rcu_cpu_stall_suppress=1 rcupdate.rcu_expedited=1 rcupdate.rcu_normal_after_boot=1 rcupdate.rcu_task_stall_timeout=0 rcutree.kthread_prio=99 security=selinux selinux=1 idle=poll"
----

Update the GRUB configuration and reboot the system to apply the changes:
Expand Down Expand Up @@ -1711,7 +1711,6 @@ operatingSystem:
timezone: America/New_York
kernelArgs:
- ignition.platform.id=openstack
- net.ifnames=1
systemd:
disable:
- rebootmgr
Expand Down
4 changes: 2 additions & 2 deletions asciidoc/quickstart/eib.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -24,14 +24,14 @@ For more information, read the <<components-eib,Edge Image Builder Introduction>

[WARNING]
====
Edge Image Builder {version-eib} supports customizing SUSE Linux Micro {version-sl-micro} images.
Edge Image Builder {version-eib} supports customizing SUSE Linux Micro {version-operatingsystem} images.
Older versions, such as SUSE Linux Enterprise Micro 5.5, or 6.0 are not supported.
====

== Prerequisites
* An {x86-64} build host machine (physical or virtual) running SLES 15 SP6.
* The Podman container engine
* A SUSE Linux Micro {version-sl-micro} SelfInstall ISO image created using the <<guides-kiwi-builder-images,Kiwi Builder procedure>>
* A SUSE Linux Micro {version-operatingsystem} SelfInstall ISO image created using the <<guides-kiwi-builder-images,Kiwi Builder procedure>>

[NOTE]
====
Expand Down
7 changes: 1 addition & 6 deletions asciidoc/quickstart/metal3.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -231,7 +231,6 @@ operatingSystem:
- 10.0.0.2
kernelArgs:
- ignition.platform.id=openstack
- net.ifnames=1
systemd:
disable:
- rebootmgr
Expand All @@ -256,11 +255,7 @@ For the production environments, it is recommended to use the SSH keys that can

[NOTE]
====
`net.ifnames=1` enables https://documentation.suse.com/smart/network/html/network-interface-predictable-naming/index.html[Predictable Network Interface Naming]

This matches the default configuration for the Metal^3^ chart, but the setting must match the configured chart `predictableNicNames` value.

Also note that `ignition.platform.id=openstack` is mandatory - without this argument SUSE Linux Micro configuration via ignition will fail in the Metal^3^ automated flow.
Note that `ignition.platform.id=openstack` is mandatory - without this argument SUSE Linux Micro configuration via ignition will fail in the Metal^3^ automated flow.

The `time` section is optional but it is highly recommended to be configured to avoid potential issues with certificates and clock skew. The values provided in this example are for illustrative purposes only. Please adjust them to fit your specific requirements.
====
Expand Down
Loading