From d2976d946bebe61c3b440e376516c52465e56a84 Mon Sep 17 00:00:00 2001 From: hodgesto Date: Mon, 3 Jul 2017 09:51:08 -0700 Subject: [PATCH 1/8] Added volumes.rst --- source/openpower/volumes.rst | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 source/openpower/volumes.rst diff --git a/source/openpower/volumes.rst b/source/openpower/volumes.rst new file mode 100644 index 0000000..0c97712 --- /dev/null +++ b/source/openpower/volumes.rst @@ -0,0 +1,23 @@ +Packages Required for Different OS Families +=========================================== + +Each Operating System interacts with the volumes attached to it in various ways. +The most common ways to interact with volumes are through packaged programs such +as ``fdisk``, ``mount``/``umount``, and other LVM commands. Alongside these packages, +there are other packages that are necessary to view and allow the system to properly +interact with the volumes that the user is attempting to manipulate. + +One of the most crucial packages for proper POWER volume management is ``ppc64-diag``. + +The following is a table showing which images on openpower-controller.osuosl.org have +this package pre-installed: + +.. csv-table:: + :header: "OS", "``ppc64-diag``" + :widths: 12, 4 + + "Debian", "[ ]" + "CentOS", "[x]" + "Fedora", "[ ]" + "Ubuntu", "[ ]" + "OpenSUSE", "[ ]" From 49007364196956184c8d3eb4aaaed6136b342ea9 Mon Sep 17 00:00:00 2001 From: Tobias Hodges Date: Mon, 3 Jul 2017 09:59:53 -0700 Subject: [PATCH 2/8] Edited table to contain "yes" or "no" --- source/openpower/volumes.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/source/openpower/volumes.rst b/source/openpower/volumes.rst index 0c97712..33e65ca 100644 --- a/source/openpower/volumes.rst +++ b/source/openpower/volumes.rst @@ -16,8 +16,8 @@ this package pre-installed: :header: "OS", "``ppc64-diag``" :widths: 12, 4 - "Debian", "[ ]" - "CentOS", "[x]" - "Fedora", "[ ]" - "Ubuntu", "[ ]" - "OpenSUSE", "[ ]" + "Debian", "no" + "CentOS", "yes" + "Fedora", "no" + "Ubuntu", "no" + "OpenSUSE", "no" From bedb224bc54f2fbbf8cf57d7b8a870b0ff220a10 Mon Sep 17 00:00:00 2001 From: Tobias Hodges Date: Fri, 7 Jul 2017 14:10:15 -0700 Subject: [PATCH 3/8] Add Fedora to table of pre-installed images. --- source/openpower/volumes.rst | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/source/openpower/volumes.rst b/source/openpower/volumes.rst index 33e65ca..9d66185 100644 --- a/source/openpower/volumes.rst +++ b/source/openpower/volumes.rst @@ -7,17 +7,27 @@ as ``fdisk``, ``mount``/``umount``, and other LVM commands. Alongside these pack there are other packages that are necessary to view and allow the system to properly interact with the volumes that the user is attempting to manipulate. +Volumes on ppc64 +---------------- + One of the most crucial packages for proper POWER volume management is ``ppc64-diag``. The following is a table showing which images on openpower-controller.osuosl.org have this package pre-installed: + .. csv-table:: :header: "OS", "``ppc64-diag``" :widths: 12, 4 "Debian", "no" "CentOS", "yes" - "Fedora", "no" + "Fedora", "yes" "Ubuntu", "no" - "OpenSUSE", "no" + "OpenSUSE", "no + +For some distributions, ``ppc64-diag`` is not available in the stable repository. In example: +for Debian, ``ppc64-diag`` only exists in the *"stretch"* packages, and for OpenSUSE, +``ppc64-diag`` is only available in the *"Tumbleweed"* packages. So if you are running an +older version of Debian or OpenSUSE such as *"jessie"* or *"Leap"*, you will need to install +``ppc64-diag`` from another, potentially unstable distribution. From 9e9e4cbfe85b2f5516a82949e4d9bac621dbeb67 Mon Sep 17 00:00:00 2001 From: Tobias Hodges Date: Fri, 7 Jul 2017 14:21:00 -0700 Subject: [PATCH 4/8] Add back table and add code tag for ppc64 --- source/openpower/volumes.rst | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/source/openpower/volumes.rst b/source/openpower/volumes.rst index 9d66185..fc23b34 100644 --- a/source/openpower/volumes.rst +++ b/source/openpower/volumes.rst @@ -7,27 +7,26 @@ as ``fdisk``, ``mount``/``umount``, and other LVM commands. Alongside these pack there are other packages that are necessary to view and allow the system to properly interact with the volumes that the user is attempting to manipulate. -Volumes on ppc64 ----------------- +Volumes on ``ppc64`` +-------------------- One of the most crucial packages for proper POWER volume management is ``ppc64-diag``. The following is a table showing which images on openpower-controller.osuosl.org have this package pre-installed: - -.. csv-table:: +.. csv-table:: Pre-Installed Images :header: "OS", "``ppc64-diag``" - :widths: 12, 4 + :widths: 12, 15 "Debian", "no" "CentOS", "yes" - "Fedora", "yes" "Ubuntu", "no" - "OpenSUSE", "no - + "Fedora", "yes" + "OpenSUSE", "no" + For some distributions, ``ppc64-diag`` is not available in the stable repository. In example: for Debian, ``ppc64-diag`` only exists in the *"stretch"* packages, and for OpenSUSE, ``ppc64-diag`` is only available in the *"Tumbleweed"* packages. So if you are running an older version of Debian or OpenSUSE such as *"jessie"* or *"Leap"*, you will need to install -``ppc64-diag`` from another, potentially unstable distribution. +``ppc64-diag`` from another, potentially unstable version. From 8e3c0b0cf9b1d2e9c3df22d25cd8aa08524a77d1 Mon Sep 17 00:00:00 2001 From: Tobias Hodges Date: Fri, 7 Jul 2017 14:23:52 -0700 Subject: [PATCH 5/8] Remove code tags from 'ppc64' --- source/openpower/volumes.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/openpower/volumes.rst b/source/openpower/volumes.rst index fc23b34..349ca55 100644 --- a/source/openpower/volumes.rst +++ b/source/openpower/volumes.rst @@ -7,7 +7,7 @@ as ``fdisk``, ``mount``/``umount``, and other LVM commands. Alongside these pack there are other packages that are necessary to view and allow the system to properly interact with the volumes that the user is attempting to manipulate. -Volumes on ``ppc64`` +Volumes on ppc64 -------------------- One of the most crucial packages for proper POWER volume management is ``ppc64-diag``. From 894b1b98920cc7ba924ed73fcfd2d3a316310fcf Mon Sep 17 00:00:00 2001 From: Tobias Hodges Date: Fri, 7 Jul 2017 14:24:18 -0700 Subject: [PATCH 6/8] Modify table name --- source/openpower/volumes.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/openpower/volumes.rst b/source/openpower/volumes.rst index 349ca55..d981631 100644 --- a/source/openpower/volumes.rst +++ b/source/openpower/volumes.rst @@ -15,7 +15,7 @@ One of the most crucial packages for proper POWER volume management is ``ppc64-d The following is a table showing which images on openpower-controller.osuosl.org have this package pre-installed: -.. csv-table:: Pre-Installed Images +.. csv-table:: ppc64-diag Pre-Installed Images :header: "OS", "``ppc64-diag``" :widths: 12, 15 From 038bb085a06cc92b1de54e0bbae303d450a13261 Mon Sep 17 00:00:00 2001 From: Tobias Hodges Date: Fri, 7 Jul 2017 14:27:53 -0700 Subject: [PATCH 7/8] Update title --- source/openpower/volumes.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/openpower/volumes.rst b/source/openpower/volumes.rst index d981631..577f53b 100644 --- a/source/openpower/volumes.rst +++ b/source/openpower/volumes.rst @@ -1,5 +1,5 @@ -Packages Required for Different OS Families -=========================================== +Interacting with Volumes on OpenPOWER +===================================== Each Operating System interacts with the volumes attached to it in various ways. The most common ways to interact with volumes are through packaged programs such @@ -15,7 +15,7 @@ One of the most crucial packages for proper POWER volume management is ``ppc64-d The following is a table showing which images on openpower-controller.osuosl.org have this package pre-installed: -.. csv-table:: ppc64-diag Pre-Installed Images +.. csv-table:: :header: "OS", "``ppc64-diag``" :widths: 12, 15 From 1cc1c84115232b28ce5ca8b886015c3f075689e9 Mon Sep 17 00:00:00 2001 From: Tobias Hodges Date: Tue, 18 Jul 2017 12:46:12 -0700 Subject: [PATCH 8/8] Update link to openpower-controller + syntax changes + wording changes --- source/openpower/volumes.rst | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/source/openpower/volumes.rst b/source/openpower/volumes.rst index 577f53b..2657404 100644 --- a/source/openpower/volumes.rst +++ b/source/openpower/volumes.rst @@ -7,13 +7,16 @@ as ``fdisk``, ``mount``/``umount``, and other LVM commands. Alongside these pack there are other packages that are necessary to view and allow the system to properly interact with the volumes that the user is attempting to manipulate. -Volumes on ppc64 --------------------- +Volumes on ppc64 and ppc64le +---------------------------- -One of the most crucial packages for proper POWER volume management is ``ppc64-diag``. +One of the most crucial packages for actually being able to use volumes on POWER platform is +``ppc64-diag``. -The following is a table showing which images on openpower-controller.osuosl.org have -this package pre-installed: +The following is a table showing which images on `OSL's OpenStack POWER cluster`__ have this +package pre-installed: + +.. __: https://openpower-controller.osuosl.org .. csv-table:: :header: "OS", "``ppc64-diag``" @@ -25,7 +28,7 @@ this package pre-installed: "Fedora", "yes" "OpenSUSE", "no" -For some distributions, ``ppc64-diag`` is not available in the stable repository. In example: +For some distributions, ``ppc64-diag`` is not available in the stable repository. For example: for Debian, ``ppc64-diag`` only exists in the *"stretch"* packages, and for OpenSUSE, ``ppc64-diag`` is only available in the *"Tumbleweed"* packages. So if you are running an older version of Debian or OpenSUSE such as *"jessie"* or *"Leap"*, you will need to install