<?xml version="1.0" encoding="UTF-8" standalone="no"?>

<!-- file: templates/articles/assembly.xml -->

<?xml-model href="https://cdn.docbook.org/schema/5.2/rng/assemblyxi.rnc"

type="application/relax-ng-compact-syntax"?>

<!DOCTYPE assembly

[

<!ENTITY % entities SYSTEM "../common/generic-entities.ent">

%entities;

]>

<!-- refers to legacy doc: <add github link to legacy doc piece, if applicable> -->

<!-- point back to this document with a similar comment added to your legacy doc piece -->

<!-- refer to README.md for file and id naming conventions -->

<assembly version="5.2" xml:lang="en"

xmlns:xlink="http://www.w3.org/1999/xlink"

xmlns:trans="http://docbook.org/ns/transclusion"

xmlns:its="http://www.w3.org/2005/11/its"

xmlns="http://docbook.org/ns/docbook">

<!-- Concept files -->

<resources>

<resource xml:id="_deployment-about-pre-built-images" href="../concepts/deployment-about-pre-built-images.xml">

<description>About pre-built images</description>

</resource>

<resource xml:id="_configure-combustion" href="../concepts/configure-combustion.xml">

<description>About &combustion;</description>

</resource>

<resource xml:id="_configure-ignition" href="../concepts/configure-ignition.xml">

<description>About &ignition;</description>

</resource>

<resource xml:id="_deployment-first-boot-detection" href="../concepts/deployment-first-boot-detection.xml">

<description>First boot detection</description>

</resource>

<resource xml:id="_deployment-efiboot-record" href="../concepts/deployment-efiboot-record.xml">

<description>Adjusting UEFI boot</description>

</resource>

</resources>

<!-- Tasks -->

<resources>

<resource xml:id="_deployment-raw-procedure" href="../tasks/deployment-raw-procedure.xml">

<description>Raw disk image deployment</description>

</resource>

<resource xml:id="_deployment-preparing-configuration-device" href="../tasks/deployment-preparing-configuration-device.xml">

<description>Preparing the configuration device</description>

</resource>

<resource xml:id="_deployment-jeos-firstboot" href="../tasks/deployment-jeos-firstboot.xml">

<description>&jeos; firstboot</description>

</resource>

<resource xml:id="_convert-yaml-to-json" href="../tasks/convert-yaml-to-json.xml">

<description>Butane usage</description>

</resource>

<resource xml:id="_deployment-reencryption" href="../tasks/deployment-reencryption.xml">

<description>Reencrypting disk</description>

</resource>

<resource xml:id="_deployment-registering-system" href="../tasks/deployment-registering-system.xml">

<description>System registration</description>

</resource>

<resource xml:id="_deployment-adding-users" href="../tasks/deployment-adding-users.xml">

<description>Adding users</description>

</resource>

</resources>

<!-- References -->

<resources>

<resource xml:id="_ignition-configuration" href="../references/ignition-configuration.xml">

<description>Ignition usage</description>

</resource>

<resource xml:id="_combustion-configuration" href="../references/combustion-configuration.xml">

<description>Combustion usage</description>

</resource>

</resources>

<!-- Legal -->

<resources>

<resource href="../common/legal.xml" xml:id="_legal">

<description>Legal Notice</description>

</resource>

<resource href="../common/license_gfdl1.2.xml" xml:id="_gfdl">

<description>GNU Free Documentation License</description>

</resource>

</resources>

<!-- S T R U C T U R E -->

<structure renderas="article" xml:id="deployment-raw-images" xml:lang="en">

<merge>

<title>Deploying &productnameshort; Using a Raw Disk Image on Bare Metal</title>

<!-- Create changelog to enable versioning; add most recent entries at the top. -->

<!-- History -->

<revhistory xml:id="rh-deployment-raw-images">

<revision><date>2024-11-10</date>

<revdescription>

<para>

Initial version

</para>

</revdescription>

</revision>

</revhistory>

<!-- Maintainer -->

<meta name="maintainer" content="[email protected]" its:translate="no"/>

<!-- this does not work yet. Use the dm tags listed below for now

<meta name="bugtracker" its:translate="no">

<phrase role="url">https://bugzilla.suse.com/enter_bug.cgi</phrase>

<phrase role="component">Non-product-specific documentation</phrase>

<phrase role="product">Smart Docs</phrase>

<phrase role="assignee">[email protected]</phrase>

</meta>

-->

<!-- not supported, yet. Use dm: tag for now

<meta name="translation" its:translate="no">

<phrase role="trans">yes</phrase>

<phrase role="language">de-de,cs-cz</phrase>

</meta>

-->

<!-- Architecture -->

<meta name="architecture" its:translate="no">

<phrase>&x86-64;</phrase>

<phrase>&power;</phrase>

</meta>

<!-- Productname & Version -->

<meta name="productname" its:translate="no">

<productname version="6.1">&slm;</productname>

</meta>

<!-- Search -->

<meta name="title" its:translate="yes">Deploying &productnameshort; raw images</meta>

<meta name="description" its:translate="yes">The article covers the steps needed to deploy a

&productnameshort; raw disk image to your system.</meta>

<!-- Social Media -->

<meta name="social-descr" its:translate="yes">The procedure of deploying raw disk images.</meta>

<!-- Task -->

<meta name="task" its:translate="no">

<phrase>Deployment</phrase>

<phrase>Installation</phrase>

</meta>

<!-- Series -->

<meta name="series" its:translate="no">Products &amp; Solutions</meta>

<dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">

<dm:bugtracker>

<dm:url>https://bugzilla.suse.com/enter_bug.cgi</dm:url>

<dm:component>Documentation</dm:component>

<dm:product>SUSE Linux Micro 6.1</dm:product>

<dm:assignee>[email protected]</dm:assignee>

</dm:bugtracker>

<dm:translation>yes</dm:translation>

</dm:docmanager>

<abstract>

<variablelist>

<varlistentry>

<term>WHAT?</term>

<listitem>

<para>

&productname; provides raw images (also referred to as

pre-built images) that can be deployed directly to your device

storage: a memory card, a USB flash disk or a hard disk. The

type of device you can deploy the image to is determined by

your specific hardware. Refer to your vendor's documentation

for guidance.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>WHY?</term>

<listitem>

<para>

You need to know how to deploy &productnameshort; on your

system.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>EFFORT</term>

<listitem>

<para>

It takes approximately 20 minutes to read the article.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>GOAL</term>

<listitem>

<para>

&productnameshort; is successfully deployed on your system.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>REQUIREMENTS</term>

<listitem>

<itemizedlist>

<listitem>

<para>

Understanding for which environment the raw disk image is

suited. For details, refer to the Introduction to

&productnameshort; article.

</para>

</listitem>

<listitem>

<para>

A device with at least 20&nbsp;GB disk space, where you deploy the raw image and where

&productnameshort; will run

</para>

</listitem>

<listitem>

<para>

Optionally, a configuration medium, for example, a USB

flash disk.

</para>

</listitem>

</itemizedlist>

</listitem>

</varlistentry>

</variablelist>

</abstract>

</merge>

<!-- pull in all the topic files you need -->

<!-- pick the appropriate type of include to match your needs -->

<!-- pull in a topic as is -->

<module resourceref="_deployment-about-pre-built-images" renderas="section">

<module resourceref="_deployment-first-boot-detection" renderas="section">

<merge>

<abstract>

<para/>

</abstract>

</merge>

</module>

</module>

<module resourceref="_deployment-preparing-configuration-device" renderas="section">

<module resourceref="_configure-ignition" renderas="section">

<module resourceref="_ignition-configuration" renderas="section"/>

</module>

<module resourceref="_configure-combustion" renderas="section">

<module resourceref="_combustion-configuration" renderas="section"/>

</module>

</module>

<module resourceref="_deployment-raw-procedure" renderas="section">

<merge>

<abstract>

<para/>

</abstract>

</merge>

<module resourceref="_deployment-jeos-firstboot" renderas="section"/>

</module>

<module renderas="section" xml:id="deployment-postdeploy-steps">

<merge>

<title>Post-deployment steps</title>

</merge>

<module resourceref="_deployment-efiboot-record" renderas="section">

<merge>

<abstract>

<para/>

</abstract>

</merge>

</module>

<module resourceref="_deployment-reencryption" renderas="section">

<merge>

<abstract>

<para/>

</abstract>

</merge>

</module>

<module resourceref="_deployment-adding-users" renderas="section"/>

<module resourceref="_deployment-registering-system" renderas="section"/>

</module>

<module resourceref="_legal"/>

<module resourceref="_gfdl">

<output renderas="appendix"/>

</module>

</structure>

</assembly>