Skip to content

Commit

Permalink
Incorporated comments from Tanja and Jana H
Browse files Browse the repository at this point in the history
  • Loading branch information
sounix000 committed Jan 29, 2025
1 parent 334a1ba commit c640406
Show file tree
Hide file tree
Showing 8 changed files with 106 additions and 53 deletions.
4 changes: 2 additions & 2 deletions DC-SLE-agama-installation-x86-64
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@ SRC_DIR="articles"
IMG_SRC_DIR="images"

## Profiling
PROFOS="sles;sles4sap"
PROFCONDITION="16.0"
PROFOS="sles"
PROFCONDITION="16.0 Beta"
#STRUCTID="STRUCTURE-ID"
PROFARCH="x86-64"

Expand Down
29 changes: 19 additions & 10 deletions articles/sle-agama-installation-x86-64.asm.xml
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@
<!-- Concept files -->
<resources>
<resource xml:id="_agama-introduction" href="../concepts/agama-introduction.xml">
<description>Introduction to &agama;</description>
<description>Introduction to &agama;</description>
</resource>
</resources>
<!-- Tasks -->
Expand Down Expand Up @@ -78,10 +78,10 @@
<!-- TODO: provide a listing of possible and validatable meta entry values. Maybe in our geekodoc repo? -->
<!-- add author's e-mail -->
<meta name="[email protected]" content="" its:translate="no"/>
<meta name="architecture"><phrase>&intel64;</phrase><phrase>&arm64;</phrase>
<meta name="architecture"><phrase>&x86-64;</phrase>
</meta>
<!-- enter one or more product names and version -->
<meta name="productname" its:translate="no"><productname version="16.0">&productname;</productname>
<meta name="productname" its:translate="no"><productname version="16.0 Beta">&productname;</productname>
</meta>
<meta name="title" its:translate="yes">Installing &sles; using &agama;</meta>
<meta name="description" its:translate="yes">How to install &sles; or &sles4sap; using &agama; on &x86-64; machines</meta>
Expand All @@ -103,8 +103,9 @@
</dm:product>
<!--
if the assembly applies to multiple products/productversions, use profiling:
<dm:product os="sles" condition="16.0">SUSE Linux Enterprise Server 16.0</dm:product>
<dm:product os="sles4sapa" condition="16.0">SUSE Linux Enterprise Server for SAP Applications 16.0</dm:product>
<dm:product os="sles" condition="16.0 Beta">SUSE Linux Enterprise Server 16.0 Beta</dm:product>
<dm:product os="sles4sap" condition="16.0 Beta">SUSE Linux Enterprise Server for SAP
Applications 16.0 Beta</dm:product>
-->
<dm:assignee>[email protected]</dm:assignee>
<!-- replace with your BUGZILLA e-mail address, otherwise this does not work-->
Expand Down Expand Up @@ -155,8 +156,16 @@
<listitem>
<para>
An &x86-64; system &ndash; either bare metal or a virtual machine with a
minimum of 1&nbsp;CPU, 2&nbsp;GB memory and 16&nbsp;GB storage.
minimum of 1&nbsp;CPU, 2&nbsp;GB memory and 20&nbsp;GB storage (which includes
storage for Btrfs snapshots and swap space).
</para>
<tip>
<title>Provision for more than minimum requirements</title>
<para>
&suse; recommends allocating resources based on the system's anticipated
usage and workload, which should be higher than the minimum recommendations.
</para>
</tip>
</listitem>
<listitem>
<para>
Expand All @@ -167,8 +176,8 @@
<note>
<title>Available images for products</title>
<para>
The &agama;&dash;based installation images are available only for
&sles; 16.0 and &sles4sap; 16.0.
The &agama;&dash;based installation images are available only for &sles;
&productnumber; and &sles4sap; &productnumber;.
</para>
</note>
</listitem>
Expand All @@ -192,8 +201,8 @@
<!-- pull in a topic and switch the title -->
<module resourceref="_agama-introduction" renderas="section">
<!-- merge>
<title>You are a very special concept now!</title>
</merge-->
<title>You are a very special concept now!</title>
</merge-->
</module>
<module resourceref="_sle-agama-manual-installation-x86-64" renderas="section"/>
<!-- module resourceref="_reference-example" renderas="section"/-->
Expand Down
2 changes: 1 addition & 1 deletion common/product-entities.ent
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@

<!ENTITY productname "<phrase xmlns='http://docbook.org/ns/docbook'><phrase os='suseai'>&suseai;</phrase><phrase os='alp-dolomite'>ALP Dolomite</phrase><phrase os='slmicro'>&slm;</phrase><phrase os='slemicro'>&slem;</phrase><phrase os='sles'>&sles;</phrase><phrase os='sles4sap'>&sles4sap;</phrase></phrase>">
<!ENTITY productnameshort "<phrase xmlns='http://docbook.org/ns/docbook'><phrase os='suseai'>&suseaia;</phrase><phrase os='alp-dolomite'>Dolomite</phrase><phrase os='slmicro'>&slm;</phrase><phrase os='slemicro'>&slema;</phrase><phrase os='sles'>&slsa;</phrase><phrase os='sles4sapa'>&sles4sapa;</phrase></phrase>">
<!ENTITY productnumber "<phrase xmlns='http://docbook.org/ns/docbook'><phrase os='suseai'>1.0</phrase><phrase os='alp-dolomite'>1.0</phrase><phrase os='slemicro_5.4'>5.4</phrase><phrase os='slmicro_5.5'>5.5</phrase><phrase os='slmicro'>6.1</phrase><phrase os='sles'>16.0</phrase><phrase os='sles4sap'>16.0</phrase></phrase>">
<!ENTITY productnumber "<phrase xmlns='http://docbook.org/ns/docbook'><phrase os='suseai'>1.0</phrase><phrase os='alp-dolomite'>1.0</phrase><phrase os='slemicro_5.4'>5.4</phrase><phrase os='slmicro_5.5'>5.5</phrase><phrase os='slmicro'>6.1</phrase><phrase os='sles'>16.0 Beta</phrase><phrase os='sles4sap'>16.0 Beta</phrase></phrase>">

<!-- PROJECT REPOSITORY URL -->
<!ENTITY repo-url "https://github.com/SUSE/doc-modular">
Expand Down
28 changes: 17 additions & 11 deletions concepts/agama-introduction.xml
Original file line number Diff line number Diff line change
Expand Up @@ -18,28 +18,34 @@
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:trans="http://docbook.org/ns/transclusion">
<info>
<title>Introduction to &agama;</title><!-- can be changed via merge in the assembly -->
<title>Introduction to &agama;</title>
<!-- can be changed via merge in the assembly -->
<!--add author's email address-->
<meta name="[email protected]" content="" its:translate="no"/>
<abstract><!-- can be changed via merge in the assembly -->
<abstract>
<!-- can be changed via merge in the assembly -->
<para>
This section provides a short overview of &agama;. In combination with &cockpit; and &ansible;, it
will replace &yast; in the upcoming releases of the &sle; family of products.
This section provides a short overview of &agama;, which is the default installer for the
&sle; &productnumber; family of products.
</para>
</abstract>
</info>
<section xml:id="concept-example-what-is">
<title>What is foo bar?</title>
<title>What is &agama;?</title>
<para>
A paragraph of text, answering the question above and explaining the
aim/function of foo bar.
&agama; is a flexible and powerful open source installer developed by &suse;. You can use it
to perform manual or automated installation of supported &sle; versions on a variety of
machine architectures. The &agama;&dash;based installation method provides an intuitive
interface for <emphasis>ready&dash;to&dash;use</emphasis> images for different use cases and
workloads. In combination with &cockpit; and &ansible;, it replaces &yast; in the upcoming
releases of the &sle; family of products.
</para>
</section>
<section xml:id="concept-example-how-it-works">
<!-- section xml:id="concept-example-how-it-works">
<title>How does foo bar work?</title>
<para>
A paragraph of text, answering the question above and explaining the
mechanism behind foo bar.
A paragraph of text, answering the question above and explaining the mechanism behind foo
bar.
</para>
<figure xml:id="fig-one">
<title>A figure</title>
Expand All @@ -58,5 +64,5 @@
<para>
A paragraph of text, pointing out the benefits of foo bar.
</para>
</section>
</section-->
</topic>
1 change: 1 addition & 0 deletions glues/sle-agama-installation-x86-64-more-info.xml
Original file line number Diff line number Diff line change
Expand Up @@ -31,5 +31,6 @@
Detailed information on the open-source &agama; project is available on its website:
<link xlink:href="https://agama-project.github.io"></link>.
</para>
</listitem>
</itemizedlist>
</topic>
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
95 changes: 66 additions & 29 deletions tasks/sle-agama-manual-installation-x86-64.xml
Original file line number Diff line number Diff line change
Expand Up @@ -34,13 +34,9 @@
<section xml:id="sle-agama-manual-installation-x86-64-introduction">
<title>Introduction</title>
<para>
&agama; is a flexible and powerful open source installer developed by &suse;. You can use it
to perform manual or automated installation of supported &sle; versions on a variety of
machine architectures. The &agama;&dash;based installation method provides an intuitive
interface for <emphasis>ready&dash;to&dash;use</emphasis> images for different use cases and
workloads. The following sections describe the &agama;&dash;based manual installation
procedure for &sles; or &sles4sap; on &x86-64; machines. The information applies to
installation on both bare metal and virtual machines.
The following sections describe the &agama;&dash;based manual installation procedure for
&sles; or &sles4sap; on &x86-64; machines. The information applies to installation on both
bare metal and virtual machines.
</para>
</section>
<!-- section xml:id="task-example-requirements">
Expand Down Expand Up @@ -116,8 +112,8 @@
</para>
<note>
<para>
In this example procedure, we select &sles; &productnumber; Beta. The manual
installation procedure for &sles; and &sles4sap; is same.
In this example procedure, we select &sles; &productnumber;. However, the procedure for
&sles; and &sles4sap; is same.
</para>
</note>
<informalfigure>
Expand All @@ -135,8 +131,67 @@
</step>
<step>
<para>
In the <guilabel>Overview</guilabel> page, check the detected configurations and select
<guilabel>Register it now</guilabel>.
In the <guilabel>Setup root user authentication</guilabel> window, provide a secure
<guilabel>Password for root user</guilabel> and select <guilabel>Accept</guilabel>.
</para>
<informalfigure>
<mediaobject>
<textobject role="description"><phrase>Setup root user authentication</phrase>
</textobject>
<imageobject role="fo">
<imagedata fileref="agama-installation-sles-x86-64-setup-root-password.png" width="100%"/>
</imageobject>
<imageobject role="html">
<imagedata fileref="agama-installation-sles-x86-64-setup-root-password.png" width="100%"/>
</imageobject>
</mediaobject>
</informalfigure>
</step>
<step>
<para>
As a best practice, create a non-root user.
</para>
<substeps>
<step>
<para>
Using the menu on the top left, select <guimenu>Users</guimenu>&gt;<guilabel>Define a new user</guilabel>.
</para>
<informalfigure>
<mediaobject>
<textobject role="description"><phrase>Define a new user</phrase>
</textobject>
<imageobject role="fo">
<imagedata fileref="agama-installation-sles-x86-64-define-new-user.png" width="100%"/>
</imageobject>
<imageobject role="html">
<imagedata fileref="agama-installation-sles-x86-64-define-new-user.png" width="100%"/>
</imageobject>
</mediaobject>
</informalfigure>
</step>
<step>
<para>
Provide the information about the
non-root user, and select <guilabel>Accept</guilabel>.
</para>
<informalfigure>
<mediaobject>
<textobject role="description"><phrase>Non-root user credentials</phrase>
</textobject>
<imageobject role="fo">
<imagedata fileref="agama-installation-sles-x86-64-non-root-user-credentials.png" width="100%"/>
</imageobject>
<imageobject role="html">
<imagedata fileref="agama-installation-sles-x86-64-non-root-user-credentials.png" width="100%"/>
</imageobject>
</mediaobject>
</informalfigure>
</step>
</substeps>
</step>
<step>
<para>
Using the menu on the top left, select <guilabel>Overview</guilabel>&gt;<guilabel>Register it now</guilabel>.
</para>
<informalfigure>
<mediaobject>
Expand Down Expand Up @@ -207,24 +262,6 @@
</mediaobject>
</informalfigure>
</step>
<step>
<para>
In the <guilabel>Setup root user authentication</guilabel> window, provide a secure
<guilabel>Password for root user</guilabel> and select <guilabel>Accept</guilabel>.
</para>
<informalfigure>
<mediaobject>
<textobject role="description"><phrase>Setup root user authentication</phrase>
</textobject>
<imageobject role="fo">
<imagedata fileref="agama-installation-sles-x86-64-setup-root-password.png" width="100%"/>
</imageobject>
<imageobject role="html">
<imagedata fileref="agama-installation-sles-x86-64-setup-root-password.png" width="100%"/>
</imageobject>
</mediaobject>
</informalfigure>
</step>
<step>
<para>
Wait for the system installation to complete. It takes around 30 minutes to complete the
Expand Down

0 comments on commit c640406

Please sign in to comment.