adjust the s390x parts of the install guide

Bug #1575236 reported by Frank Heimes
10
This bug affects 1 person
Affects Status Importance Assigned to Milestone
Ubuntu on IBM z Systems
Fix Released
Medium
Frank Heimes
installation-guide (Ubuntu)
Fix Released
Undecided
Unassigned
Bionic
Fix Released
Undecided
Unassigned

Bug Description

IBM and also some early adopter customers complaint about the official Ubuntu 16.04 installation guide for s390x (IBM System z):
https://help.ubuntu.com/16.04/installation-guide/
mentioning that:
- it contains partly outdated information and links
- that there is not enough s390x / IBM z Systems focus
- that the naming is not correct
- that it includes information that is not relevant to s390x

Due to these complaints and because of the urgency I created an adjusted and revised version of the install guide with special s390x focus and transformed it (for convenience reasons) to a wiki.
It is located here: https://wiki.ubuntu.com/S390X/InstallationGuide

SRU Request:
============

[Impact]

 * Updated the desired changes of the inst. guide regarding naming conventions etc.

 * and s390x specific details

 * Because 18.04.1 is the main upgrade target it's important to have it in place with 16.04.1

 * The changes on the doc not only updated the outdated content ...

 * ... but also added new functions and technology (like FCP) that was added to the platform since the last update

[Test Case]

 * Open the updated doc - as either html, PS, PDF or txt ...

 * and compare the modified and new content with the current functionality the platform provides

[Regression Potential]

 * The regression potential is low because most changes are platform (s390x) specific

 * However, since it's written in docbook with several conditional statements changes on one platform may cause an impact to other, too.

 * For verification reasons I created the guide after my changes not only for s390x, but also for other platforms...

 * ... and even found two issues that I fixed (nested use of xml elements, that cause issues while creating PDF, even if HTML creation still worked fine ...)

 * No impact is expected on an Ubuntu installation itself - since it's documentation only.

Related branches

Frank Heimes (fheimes)
Changed in installation-guide (Ubuntu):
status: New → In Progress
description: updated
Changed in installation-guide (Ubuntu):
assignee: nobody → Dimitri John Ledkov (xnox)
Changed in installation-guide (Ubuntu):
assignee: Dimitri John Ledkov 🌈 (xnox) → nobody
summary: - adjust the s390x parts of the 16.04 install guide
+ adjust the s390x parts of the install guide
Frank Heimes (fheimes)
description: updated
Changed in ubuntu-z-systems:
status: New → In Progress
importance: Undecided → Medium
assignee: nobody → Frank Heimes (frank-heimes)
Revision history for this message
Łukasz Zemczak (sil2100) wrote : Please test proposed package

Hello Frank, or anyone else affected,

Accepted installation-guide into bionic-proposed. The package will build now and be available at https://launchpad.net/ubuntu/+source/installation-guide/20160121ubuntu4.1 in a few hours, and then in the -proposed repository.

Please help us by testing this new package. See https://wiki.ubuntu.com/Testing/EnableProposed for documentation on how to enable and use -proposed.Your feedback will aid us getting this update out to other Ubuntu users.

If this package fixes the bug for you, please add a comment to this bug, mentioning the version of the package you tested and change the tag from verification-needed-bionic to verification-done-bionic. If it does not fix the bug for you, please add a comment stating that, and change the tag to verification-failed-bionic. In either case, without details of your testing we will not be able to proceed.

Further information regarding the verification process can be found at https://wiki.ubuntu.com/QATeam/PerformingSRUVerification . Thank you in advance!

Changed in installation-guide (Ubuntu Bionic):
status: New → Fix Committed
tags: added: verification-needed verification-needed-bionic
Frank Heimes (fheimes)
Changed in installation-guide (Ubuntu):
status: In Progress → Fix Committed
Changed in ubuntu-z-systems:
status: In Progress → Fix Committed
Revision history for this message
Frank Heimes (fheimes) wrote :

Found some minor issues in the representation of special ASCII characters in the PDF version and some lines that were to long and run into the border.
Fixed that with revision 550.
Content-wise everything is fine.
Changing tags accordingly.

tags: added: verification-done verification-done-bionic
removed: verification-needed verification-needed-bionic
Revision history for this message
Łukasz Zemczak (sil2100) wrote :

Hello Frank, or anyone else affected,

Accepted installation-guide into bionic-proposed. The package will build now and be available at https://launchpad.net/ubuntu/+source/installation-guide/20160121ubuntu4.2 in a few hours, and then in the -proposed repository.

Please help us by testing this new package. See https://wiki.ubuntu.com/Testing/EnableProposed for documentation on how to enable and use -proposed.Your feedback will aid us getting this update out to other Ubuntu users.

If this package fixes the bug for you, please add a comment to this bug, mentioning the version of the package you tested and change the tag from verification-needed-bionic to verification-done-bionic. If it does not fix the bug for you, please add a comment stating that, and change the tag to verification-failed-bionic. In either case, without details of your testing we will not be able to proceed.

Further information regarding the verification process can be found at https://wiki.ubuntu.com/QATeam/PerformingSRUVerification . Thank you in advance!

tags: added: verification-needed verification-needed-bionic
removed: verification-done verification-done-bionic
Revision history for this message
Frank Heimes (fheimes) wrote :

Installed the amd64 and s390x verision of the package and had a look at the txt, html and pdf formats (checked the s390x versions on s390x and amd64).
Latest modifications are in - looks fine now.
Changing to verification done.

tags: added: verification-done verification-done-bionic
removed: verification-needed verification-needed-bionic
Revision history for this message
Launchpad Janitor (janitor) wrote :

This bug was fixed in the package installation-guide - 20160121ubuntu4.2

---------------
installation-guide (20160121ubuntu4.2) bionic; urgency=medium

  * Fixed some appearance issues and long lines - mainly visible in the PDFs
    (LP: #1575236)

installation-guide (20160121ubuntu4.1) bionic; urgency=medium

  * More adjustments to the s390x portion of the installation guide, updated
    references to IBM documentation. (LP: #1575236)
  * Clear up use of zfcp configuration in preseed. (LP: #1564788)
  * Add a validation-only build mode.

 -- Frank Heimes <email address hidden> Fri, 06 Jul 2018 12:08:50 -0400

Changed in installation-guide (Ubuntu Bionic):
status: Fix Committed → Fix Released
Revision history for this message
Łukasz Zemczak (sil2100) wrote : Update Released

The verification of the Stable Release Update for installation-guide has completed successfully and the package has now been released to -updates. Subsequently, the Ubuntu Stable Release Updates Team is being unsubscribed and will not receive messages about this bug report. In the event that you encounter a regression using the package from -updates please report a new bug using ubuntu-bug and tag the bug report regression-update so we can easily find any regressions.

Frank Heimes (fheimes)
Changed in installation-guide (Ubuntu):
status: Fix Committed → Fix Released
Changed in ubuntu-z-systems:
status: Fix Committed → Fix Released
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.