SLE installation on x86_64 with Agama installer #417

sounix000 · 2025-01-23T11:51:33Z

Description

Modular documentation for SLE installation on x86_64 with Agama installer

Are there any relevant issues/feature requests?

jsc#https://jira.suse.com/browse/DOCTEAM-1675

Is this (based on) existing content?

No, it's new content written from scratch.

lvicoun

Hi Souvik, thank you very much for handling this on such a short-term! I added some information.

lvicoun · 2025-01-24T08:12:48Z

glues/sle-agama-installation-x86-64-more-info.xml

+        <link xlink:href="https://agama-project.github.io"></link>.
+      </para>
+    </listitem>
+    <listitem>


I'm not sure that a reference to SLE15 SP6 is relevant to the user. I think e.g. cockpit guide should be here, we will have it soon online.

lvicoun · 2025-01-24T08:14:17Z

tasks/sle-agama-manual-installation-x86-64.xml

+      </para>
+    </abstract>
+  </info>
+  <section xml:id="sle-agama-manual-installation-x86-64-introduction">


I'd move the info regarding Agama to a separate topic, as I'm sure that it will be used also for the automatic installation.

lvicoun · 2025-01-24T08:15:11Z

tasks/sle-agama-manual-installation-x86-64.xml

+        </para>
+        <note>
+          <para>
+            In this example procedure, we select &sles; 16.0 Beta. The manual installation


Suggested change

In this example procedure, we select &sles; 16.0 Beta. The manual installation

In this example procedure, we select &sles; &productnumber; Beta. The manual installation

lvicoun · 2025-01-24T08:20:47Z

tasks/sle-agama-manual-installation-x86-64.xml

+          <para>
+            In this example procedure, we select &sles; 16.0 Beta. The manual installation
+            procedure for &sles; and &sles4sapa; is same. However, the storage requirement for
+            &sles4sapa; is slightly more than vanilla &sles;.


Not sure everyone will know what is vanilla SLES. Anyways, please state the HW REQ for SAP in the beginning as here it does not convey information if they are higher or lower.

lvicoun · 2025-01-24T08:22:14Z

tasks/sle-agama-manual-installation-x86-64.xml

+          In the <guilabel>Registration</guilabel> page, enter the <guilabel>Registration
+          code</guilabel> and select <guilabel>Register</guilabel>.
+        </para>
+        <note>


I think we can skip the note. The step is not marked as optional and Agama itself states it is mandatory to register. (At least for this type of installation, offline installation that does not require registration should follow soon).

lvicoun · 2025-01-24T08:25:18Z

tasks/sle-agama-manual-installation-x86-64.xml

+      <step>
+        <para>
+          After successful registration, the <guilabel>Overview</guilabel> page reappears. Ensure
+          that the configurations for <guilabel>Localization</guilabel>,


I'd add here to create a non-root user as it is mandatory to access Cockpit for example. Sure you can add a user later, but here we have the option so let's use it :) keep in mind that later here the full partitioning power will appear and you will have to elaborate the settings anyways.

lvicoun · 2025-01-24T08:26:24Z

tasks/sle-agama-manual-installation-x86-64.xml

+          </mediaobject>
+        </informalfigure>
+      </step>
+      <step>


I'd move the step to the Summary as there you mention the verification.

taroth21

@sounix000 : Thanks a lot, looks good - just a few nitpicks from my side (and some things that @lvicoun already has covered). There is one issue we need to clarify with the portal squad I think (mentioned in one of my comments).

taroth21 · 2025-01-24T17:47:37Z

DC-SLE-agama-installation-x86-64

+
+## Profiling
+PROFOS="sles;sles4sapa"
+PROFCONDITION="sles;sles4sapa"


Suggested change

PROFCONDITION="sles;sles4sapa"

PROFCONDITION="16.0"

taroth21 · 2025-01-24T17:50:39Z

articles/sle-agama-installation-x86-64.asm.xml

+          <dm:product>
+            <!--Bugzilla product string-->
+          </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="sles" condition="16.1">SUSE Linux Enterprise Server 16.1</dm:product>
+            -->


Suggested change

<dm:product>



</dm:product>



<dm:product>

<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>

The above profiling for Bugzilla would only work if we indeed use profiling within the source code (and create two different DC file with one PROFOS each) - we need to doublecheck with @lvicoun and the portal squad (my understanding is that we need a profiled version of the article for each product, because otherwise we might not be able to file the same article for two different products in the portal.)

taroth21 · 2025-01-24T17:57:46Z

articles/sle-agama-installation-x86-64.asm.xml

+            <term>WHAT?</term>
+            <listitem>
+              <para>
+                This article describes how to install &sles; or &sles4sapa; using &agama; on


Maybe you could mention here that the article applies both to bare metal and VM installation?

taroth21 · 2025-01-24T17:58:42Z

articles/sle-agama-installation-x86-64.asm.xml

+            <term>GOAL</term>
+            <listitem>
+              <para>
+                Understand how to install &sles; or &sles4sapa; using &agama; on &x86-64; machines.


Please use the full productname entity (see suggestion) for SLES for SAP (everywhere), this one is for the abbreviated product name

taroth21 · 2025-01-24T17:59:49Z

articles/sle-agama-installation-x86-64.asm.xml

+            <term>GOAL</term>
+            <listitem>
+              <para>
+                Understand how to install &sles; or &sles4sapa; using &agama; on &x86-64; machines.


Suggested change

Understand how to install &sles; or &sles4sapa; using &agama; on &x86-64; machines.

Understand how to install &sles; or &sles4sap; using &agama; on &x86-64; machines.

taroth21 · 2025-01-24T18:03:54Z

articles/sle-agama-installation-x86-64.asm.xml

+                    ensure its integrity.
+                  </para>
+                  <note>
+                    <title>Supported &sle; version</title>


Suggested change

<title>Supported &sle; version</title>

<title>Available images for products</title>

I wouldn't mention 'supported' here, it's rather: which products are available for installation with Agama right now

taroth21 · 2025-01-24T18:09:34Z

tasks/sle-agama-manual-installation-x86-64.xml

+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:trans="http://docbook.org/ns/transclusion">
+  <info>
+    <title>Installing &sle; using &agama; on &x86-64; machines</title>


Do we need using &agama; here? if that is going to be the only way to install, I would remove it

taroth21 · 2025-01-24T18:10:42Z

tasks/sle-agama-manual-installation-x86-64.xml

+    </para>
+    </section-->
+  <section xml:id="sle-agama-manual-installation-x86-64-procedure">
+    <title>Manually installing &sle; using &agama; on &x86-64; machines</title>


same here: do we need using &agama;? if not, please remove

sounix000 force-pushed the ssarkar/DOCTEAM-1675-SLE-Agama-installation-x86_64 branch from e0ed4a1 to a44dad7 Compare January 23, 2025 11:55

sounix000 marked this pull request as ready for review January 23, 2025 22:11

sounix000 added 2 commits January 24, 2025 03:42

SLE installation on x86_64 with Agama installer

1c1660c

Draft content

0d827d5

sounix000 force-pushed the ssarkar/DOCTEAM-1675-SLE-Agama-installation-x86_64 branch from 42dff01 to 0d827d5 Compare January 23, 2025 22:12

sounix000 requested review from dariavladykina and taroth21 January 23, 2025 22:13

lvicoun reviewed Jan 24, 2025

View reviewed changes

taroth21 requested changes Jan 24, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

SLE installation on x86_64 with Agama installer #417

SLE installation on x86_64 with Agama installer #417

sounix000 commented Jan 23, 2025

lvicoun left a comment

lvicoun Jan 24, 2025

lvicoun Jan 24, 2025

lvicoun Jan 24, 2025

lvicoun Jan 24, 2025

lvicoun Jan 24, 2025 •

edited

Loading

lvicoun Jan 24, 2025

lvicoun Jan 24, 2025

taroth21 left a comment

taroth21 Jan 24, 2025

taroth21 Jan 24, 2025

taroth21 Jan 24, 2025

taroth21 Jan 24, 2025

taroth21 Jan 24, 2025

taroth21 Jan 24, 2025

taroth21 Jan 24, 2025

taroth21 Jan 24, 2025

taroth21 Jan 24, 2025

taroth21 Jan 24, 2025

	In this example procedure, we select &sles; 16.0 Beta. The manual installation
	In this example procedure, we select &sles; &productnumber; Beta. The manual installation

	Understand how to install &sles; or &sles4sapa; using &agama; on &x86-64; machines.
	Understand how to install &sles; or &sles4sap; using &agama; on &x86-64; machines.

	<title>Supported &sle; version</title>
	<title>Available images for products</title>

SLE installation on x86_64 with Agama installer #417

Are you sure you want to change the base?

SLE installation on x86_64 with Agama installer #417

Conversation

sounix000 commented Jan 23, 2025

Description

Are there any relevant issues/feature requests?

Is this (based on) existing content?

lvicoun left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

lvicoun Jan 24, 2025 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

taroth21 left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

lvicoun Jan 24, 2025 •

edited

Loading