Skip to content

Commit

Permalink
Intermediate back-up commit
Browse files Browse the repository at this point in the history
  • Loading branch information
sounix000 committed Jan 29, 2025
1 parent 1a2c29c commit 7c72d4f
Show file tree
Hide file tree
Showing 6 changed files with 104 additions and 64 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;sles4sapa"
PROFCONDITION="sles;sles4sapa"
PROFOS="sles;sles4sap"
PROFCONDITION="16.0"
#STRUCTID="STRUCTURE-ID"
PROFARCH="x86-64"

Expand Down
43 changes: 22 additions & 21 deletions articles/sle-agama-installation-x86-64.asm.xml
Original file line number Diff line number Diff line change
Expand Up @@ -24,22 +24,22 @@
<description>Glue example</description>
</resource-->
<resource xml:id="_sle-agama-installation-x86-64-more-info" href="../glues/sle-agama-installation-x86-64-more-info.xml">
<description>More information on &sles; and &sles4sapa; installation</description>
<description>More information on &agama;</description>
</resource>
<!-- resource xml:id="_glue-whats-next" href="../glues/glue-whats-next.xml">
<description>Glue what's next</description>
</resource-->
</resources>
<!-- Concept files -->
<!-- resources>
<resource xml:id="_concept-example" href="../concepts/concept.xml">
<description>Concept example</description>
<resources>
<resource xml:id="_agama-introduction" href="../concepts/agama-introduction.xml">
<description>Introduction to &agama;</description>
</resource>
</resources-->
</resources>
<!-- Tasks -->
<resources>
<resource xml:id="_sle-agama-manual-installation-x86-64" href="../tasks/sle-agama-manual-installation-x86-64.xml">
<description>Manual installation of &sles; or &sles4sapa; using &agama; on &x86-64; machines</description>
<description>Manual installation of &sles; or &sles4sap; using &agama; on &x86-64; machines</description>
</resource>
</resources>
<!-- References -->
Expand All @@ -61,7 +61,7 @@
<structure renderas="article" xml:id="sle-agama-installation-x86-64" xml:lang="en">
<merge>
<title>Installing &sle; using &agama;</title>
<!-- subtitle>Manual procedure for &sles; or &sles4sapa; on &x86-64; machines</subtitle-->
<!-- subtitle>Manual procedure for &sles; or &sles4sap; on &x86-64; machines</subtitle-->
<!-- Create revision history to enable versioning: adjust the placeholder revhistory ID,
for each entry add the date of when the updated article will be published,
list most recent date/entry at the top -->
Expand All @@ -84,7 +84,7 @@
<meta name="productname" its:translate="no"><productname version="16.0">&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 &sles4sapa; using &agama; on &x86-64; machines</meta>
<meta name="description" its:translate="yes">How to install &sles; or &sles4sap; using &agama; on &x86-64; machines</meta>
<meta name="social-descr" its:translate="yes">Installing &sles; using &agama;</meta>
<!-- suitable categories has to be identical with the category selected in the docserv config -->
<meta name="category" its:translate="no"><phrase>Systems Management</phrase>
Expand All @@ -104,7 +104,7 @@
<!--
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>
<dm:product os="sles4sapa" condition="16.0">SUSE Linux Enterprise Server for SAP Applications 16.0</dm:product>
-->
<dm:assignee>[email protected]</dm:assignee>
<!-- replace with your BUGZILLA e-mail address, otherwise this does not work-->
Expand All @@ -117,16 +117,17 @@
<term>WHAT?</term>
<listitem>
<para>
This article describes how to install &sles; or &sles4sapa; using &agama; on
&x86-64; machines.
This article describes how to install &sles; or &sles4sap; using &agama; on
&x86-64; machines. The information presented here applies to installation of the
products on both bare metal and virtual machines.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>WHY?</term>
<listitem>
<para>
Read this article to understand the process of installing &sles; or &sles4sapa;
Read this article to understand the process of installing &sles; or &sles4sap;
using &agama; on &x86-64; machines.
</para>
</listitem>
Expand All @@ -143,7 +144,7 @@
<term>GOAL</term>
<listitem>
<para>
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.
</para>
</listitem>
</varlistentry>
Expand All @@ -160,14 +161,14 @@
<listitem>
<para>
An &agama;&dash;based ISO image file for supported versions of &sles; or
&sles4sapa;. You can download it from the &scc; and verify its checksum to
&sles4sap;. You can download it from the &scc; and verify its checksum to
ensure its integrity.
</para>
<note>
<title>Supported &sle; version</title>
<title>Available images for products</title>
<para>
Currently, the &agama;&dash;based installation images are available only for
&sles; 16.0 and &sles4sapa; 16.0.
The &agama;&dash;based installation images are available only for
&sles; 16.0 and &sles4sap; 16.0.
</para>
</note>
</listitem>
Expand All @@ -189,11 +190,11 @@
<!-- pull in a topic as is -->
<!-- module resourceref="_glue-example" renderas="section"/-->
<!-- pull in a topic and switch the title -->
<!-- module resourceref="_concept-example" renderas="section">
<merge>
<module resourceref="_agama-introduction" renderas="section">
<!-- merge>
<title>You are a very special concept now!</title>
</merge>
</module-->
</merge-->
</module>
<module resourceref="_sle-agama-manual-installation-x86-64" renderas="section"/>
<!-- module resourceref="_reference-example" renderas="section"/-->
<module resourceref="_sle-agama-installation-x86-64-more-info" renderas="section"/>
Expand Down
4 changes: 2 additions & 2 deletions common/product-entities.ent
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,9 @@

<!-- Use "&generic;" for everything not ALP and SLE Micro -->

<!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='sles4sapa'>&sles4sapa;</phrase></phrase>">
<!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='sles4sapa'>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</phrase><phrase os='sles4sap'>16.0</phrase></phrase>">

<!-- PROJECT REPOSITORY URL -->
<!ENTITY repo-url "https://github.com/SUSE/doc-modular">
Expand Down
62 changes: 62 additions & 0 deletions concepts/agama-introduction.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- This file originates from the project https://github.com/openSUSE/doc-kit -->
<!-- This file can be edited downstream. -->
<!DOCTYPE topic
[
<!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 -->
<!-- metadata is dealt with on the assembly level -->
<topic xml:id="agama-introduction"
role="concept" xml:lang="en"
xmlns="http://docbook.org/ns/docbook" version="5.2"
xmlns:its="http://www.w3.org/2005/11/its"
xmlns:xi="http://www.w3.org/2001/XInclude"
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 -->
<!--add author's email address-->
<meta name="[email protected]" content="" its:translate="no"/>
<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.
</para>
</abstract>
</info>
<section xml:id="concept-example-what-is">
<title>What is foo bar?</title>
<para>
A paragraph of text, answering the question above and explaining the
aim/function of foo bar.
</para>
</section>
<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.
</para>
<figure xml:id="fig-one">
<title>A figure</title>
<mediaobject>
<imageobject role="html">
<imagedata fileref="example.png"/>
</imageobject>
<imageobject role="fo">
<imagedata fileref="example.png" width="85%"/>
</imageobject>
</mediaobject>
</figure>
</section>
<section xml:id="concept-example-benefits">
<title>Benefits of foo bar</title>
<para>
A paragraph of text, pointing out the benefits of foo bar.
</para>
</section>
</topic>
21 changes: 0 additions & 21 deletions glues/sle-agama-installation-x86-64-more-info.xml
Original file line number Diff line number Diff line change
Expand Up @@ -31,26 +31,5 @@
Detailed information on the open-source &agama; project is available on its website:
<link xlink:href="https://agama-project.github.io"></link>.
</para>
</listitem>
<listitem>
<para>
Installation Quick Start for &sles; 15 SP6 using the conventional installer is available at
<link xlink:href="https://documentation.suse.com/sles/15-SP6/html/SLES-all/article-installation.html"></link>.
</para>
</listitem>
<listitem>
<para>
Deployment Guide containing detailed information on conventional methods of installing and
deploying &sles; 15 SP6 on &arm64; and &intel64; machines is available at
<link xlink:href="https://documentation.suse.com/sles/15-SP6/html/SLES-all/cha-x86.html"></link>.
</para>
</listitem>
<listitem>
<para>
Installation Quick Start for &sles4sapa; 15 SP6 using the conventional installer is
available at
<link xlink:href="https://documentation.suse.com/sles-sap/15-SP6/html/SLES-SAP-installation/index.html"></link>.
</para>
</listitem>
</itemizedlist>
</topic>
34 changes: 16 additions & 18 deletions tasks/sle-agama-manual-installation-x86-64.xml
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,8 @@
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 &sles4sapa; on &x86-64; machines.
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 @@ -68,10 +69,11 @@
<section xml:id="sle-agama-manual-installation-x86-64-procedure">
<title>Manually installing &sle; using &agama; on &x86-64; machines</title>
<para>
To manually install &sles; or &sles4sapa; using &agama; on &x86-64; machines, perform the
To manually install &sles; or &sles4sap; using &agama; on &x86-64; machines, perform the
following steps:
</para>
<procedure>
<title>Manual installation of &sle; using &agama; on &x86-64; machines</title>
<step>
<para>
Select a bootable media and start the installation process.
Expand Down Expand Up @@ -114,9 +116,8 @@
</para>
<note>
<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;.
In this example procedure, we select &sles; &productnumber; Beta. The manual
installation procedure for &sles; and &sles4sap; is same.
</para>
</note>
<informalfigure>
Expand Down Expand Up @@ -155,12 +156,6 @@
In the <guilabel>Registration</guilabel> page, enter the <guilabel>Registration
code</guilabel> and select <guilabel>Register</guilabel>.
</para>
<note>
<title>Register before installation</title>
<para>
You must register the product before you can proceed with installation.
</para>
</note>
<informalfigure>
<mediaobject>
<textobject role="description"><phrase>Registration</phrase>
Expand Down Expand Up @@ -283,6 +278,16 @@
</mediaobject>
</informalfigure>
</step>
</procedure>
</section>
<section xml:id="sle-agama-manual-installation-x86-64-summary">
<title>Summary</title>
<para>
After successful configuration checks, product registration, installation and reboot, verify
that you can log in and use your system.
</para>
<procedure>
<title>System verification after installation</title>
<step>
<para>
Log in to the system as root.
Expand Down Expand Up @@ -319,13 +324,6 @@
</step>
</procedure>
</section>
<section xml:id="sle-agama-manual-installation-x86-64-summary">
<title>Summary</title>
<para>
After successful configuration checks, product registration, installation and reboot, verify
that you can log in and use your system.
</para>
</section>
<!-- section xml:id="task-example-troubleshooting">
<title>Troubleshooting</title>
<para>
Expand Down

0 comments on commit 7c72d4f

Please sign in to comment.