Skip to content

DOCTEAM-2086: post merge-feedback#746

Open
Amrita42 wants to merge 1 commit into
mainfrom
docteam-2086-janafdbk
Open

DOCTEAM-2086: post merge-feedback#746
Amrita42 wants to merge 1 commit into
mainfrom
docteam-2086-janafdbk

Conversation

@Amrita42

Copy link
Copy Markdown
Contributor

PR creator: Description

Describe the overall goals of this pull request.

PR creator: Are there any relevant issues/feature requests?

  • bsc#...
  • jsc#...

PR reviewer: Checklist for editorial review

Apart from the usual checks, please double-check also the following:

@Amrita42 Amrita42 self-assigned this Jul 23, 2026
@Amrita42
Amrita42 requested a review from dariavladykina July 23, 2026 14:22
@Amrita42

Amrita42 commented Jul 23, 2026

Copy link
Copy Markdown
Contributor Author

@dariavladykina please review the entire DC-SLES-ISCSI article. I have tried to implement some of the gem(geo/metadata) suggestions thanks

@dariavladykina dariavladykina left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi Amrita, please see some sugestions for the parts of htis PR. Please let me see the entire article again once this is merged. Thank you!

Comment thread articles/iscsi.asm.xml
<abstract>
<variablelist>
<varlistentry>
<term>WHAT?</term>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We plan to use the updated abstract from now on, which does not have the What? Why? etc. structure anymore. So we can replace this with sth like: iSCSI (Internet Small Computer Systems Interface) is a networking protocol that transmits SCSI commands over IP networks, allowing a system to access remote storage as locally attached block drives. By using existing Ethernet infrastructure rather than costly dedicated hardware, it enables cost-effective storage consolidation while delivering high-performance, low-latency block access with flexible formatting options for virtualized environments and enterprise databases.

I like the Requirements here, so we can keep them as is.

Comment thread articles/iscsi.asm.xml
</listitem>
<listitem>
<para>
<emphasis>Storage fundamentals:</emphasis> Understanding the difference between file level storage (like a folder on Google Drive) and block level storage (like a raw, unformatted hard drive), as iSCSI is strictly block-level.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<emphasis>Storage fundamentals:</emphasis> Understanding the difference between file-level storage (like a folder on Google Drive) and block-level storage (like a raw, unformatted hard drive), as iSCSI is strictly block-level.

Comment thread concepts/intro-iscsi.xml
<title>What is iSCSI and how does it work?</title>
<para>In a physical iSCSI environment, the initiator is the server’s software that requests data, the LIO target is the physical storage appliance that hosts the data and the LUN (Logical Unit Number) represents the specific physical disk capacity assigned to the server.</para>
<itemizedlist>
<listitem><para><emphasis role="bold">The iSCSI Initiator:</emphasis>The initiator is the physical server that needs to consume the storage. It initiates the conversation with the target.</para>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<listitem><para><emphasis role="bold">The iSCSI Initiator:</emphasis>The initiator is the physical server that needs to consume the storage. It initiates the conversation with the target.</para>
<listitem><para><emphasis role="bold">The iSCSI Initiator:</emphasis> The initiator is the physical server that needs to consume the storage. It initiates the conversation with the target.</para>

Comment thread concepts/intro-iscsi.xml
<listitem><para><emphasis role="bold">Physical Ports:</emphasis> These are the dedicated connection points on the server used exclusively for storage traffic to ensure low latency and high throughput.</para></listitem>
</itemizedlist>
</listitem>
<listitem><para><emphasis role="bold">The iSCSI LIO Target:</emphasis>The target is the physical hardware device that houses the data. LIO (Linux-IO) is the standard, open-source storage enterprise-grade target for the Linux kernel.</para>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<listitem><para><emphasis role="bold">The iSCSI LIO Target:</emphasis> The target is the physical hardware device that houses the data. LIO (Linux-IO) is the standard, open source storage enterprise-grade target for the Linux kernel.</para>

Comment thread concepts/intro-iscsi.xml
</section>
<section xml:id="features-iscsi">
<title>Key characteristics of remote iSCSI storage</title>
<para>Following are some the common characteristics of iSCSI:</para>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<para>Following are some the common characteristics of iSCSI:</para>
< para>The following are some of the common characteristics of iSCSI:</para>

Comment thread concepts/intro-iscsi.xml
<listitem><para><emphasis role="bold">Block-Level Access:</emphasis> Unlike a network share where you see files, with iSCSI, your system sees raw sectors. This allows you to format the remote drive with any file system such as NTFS, ReFS, or ext4.</para></listitem>
<listitem><para><emphasis role="bold">Distance and Flexibility:</emphasis> The storage can be in a server rack across the room or in a data center across the city. Because iSCSI uses block-level storage, the system treats this network-attached storage exactly like a local hard drive.
When traversing these distances, security is maintained by enforcing CHAP for secure authentication between the system and the storage target, alongside IPsec to encrypt the data packets in transit.</para></listitem>
<listitem><para><emphasis role="bold">Low Latency Requirement:</emphasis> Because the OS thinks the drive is local, it expects fast responses. This is why remote iSCSI usually requires a high-speed network ( preferably 10Gbps or higher).</para></listitem>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<listitem><para><emphasis role="bold">Low Latency Requirement:</emphasis> Because the OS thinks the drive is local, it expects fast responses. This is why remote iSCSI usually requires a high-speed network (preferably 10Gbps or higher).</para></listitem>

<screen>&prompt.sudo; systemctl restart iscsid </screen>
</step>
<step>
<para>The following steps are optional as the Initiator name is set by default.</para>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<para>The following steps are optional as the Initiator name is set by default.</para>
<para>The following steps are optional, as the Initiator name is set by default.</para>

Comment thread concepts/intro-iscsi.xml
Linux iSCSI provides iSCSI initiator and iSCSI LIO (Linux-IO) target software for connecting Linux servers to central storage systems.
</para>
<section xml:id="what-is">
<title>What is iSCSI and how does it work?</title>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So that it's not repetitive of the chapter title:

Suggested change
<title>What is iSCSI and how does it work?</title>
<title>iSCSI architecture and components</title>

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants