adjust the s390x parts of the install guide
| 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:/
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:/
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
- Ubuntu Core Development Team: Pending requested
-
Diff: 2313 lines (+1213/-234)27 files modifiedbuild/entities/common.ent (+2/-0)
build/templates/docstruct.ent (+5/-3)
doc/cheatsheet.xml (+8/-0)
en/appendix/chroot-install.xml (+226/-41)
en/appendix/files.xml (+35/-19)
en/appendix/preseed.xml (+373/-45)
en/boot-installer/intro-firmware.xml (+2/-1)
en/boot-installer/trouble.xml (+4/-2)
en/hardware/disk-storage.xml (+36/-0)
en/hardware/hardware-supported.xml (+4/-3)
en/howto/installation-howto.xml (+78/-20)
en/install-methods/usb-setup/x86.xml (+4/-2)
en/partitioning/device-names.xml (+35/-17)
en/partitioning/partition-programs.xml (+4/-4)
en/partitioning/schemes.xml (+1/-1)
en/partitioning/sizing.xml (+3/-3)
en/post-install/rescue.xml (+329/-50)
en/preparing/non-debian-partitioning.xml (+6/-5)
en/using-d-i/modules/localechooser.xml (+4/-2)
en/using-d-i/modules/mdcfg.xml (+4/-2)
en/using-d-i/modules/netcfg.xml (+5/-2)
en/using-d-i/modules/network-console.xml (+4/-2)
en/using-d-i/modules/partman-crypto.xml (+9/-3)
en/using-d-i/modules/partman.xml (+7/-5)
en/using-d-i/modules/pkgsel.xml (+5/-2)
en/using-d-i/modules/s390/dasd.xml (+7/-0)
en/using-d-i/modules/s390/fcp.xml (+13/-0)
| 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 |
| description: | updated |
| Changed in ubuntu-z-systems: | |
| status: | New → In Progress |
| importance: | Undecided → Medium |
| assignee: | nobody → Frank Heimes (frank-heimes) |
| Łukasz Zemczak (sil2100) wrote Please test proposed package | #1 |
| Changed in installation-guide (Ubuntu Bionic): | |
| status: | New → Fix Committed |
| tags: | added: verification-needed verification-needed-bionic |
| Changed in installation-guide (Ubuntu): | |
| status: | In Progress → Fix Committed |
| Changed in ubuntu-z-systems: | |
| status: | In Progress → Fix Committed |
| Frank Heimes (fheimes) wrote | #2 |
| tags: |
added: verification-done verification-done-bionic removed: verification-needed verification-needed-bionic |
| Łukasz Zemczak (sil2100) wrote | #3 |
| tags: |
added: verification-needed verification-needed-bionic removed: verification-done verification-done-bionic |
| Frank Heimes (fheimes) wrote | #4 |
| tags: |
added: verification-done verification-done-bionic removed: verification-needed verification-needed-bionic |
| Launchpad Janitor (janitor) wrote | #5 |
| Changed in installation-guide (Ubuntu Bionic): | |
| status: | Fix Committed → Fix Released |
| Łukasz Zemczak (sil2100) wrote Update Released | #6 |
| Changed in installation-guide (Ubuntu): | |
| status: | Fix Committed → Fix Released |
| Changed in ubuntu-z-systems: | |
| status: | Fix Committed → Fix Released |
Hello Frank, or anyone else affected,
Accepted installation-guide into bionic-proposed. The package will build now and be available at https:/
Please help us by testing this new package. See https:/
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-
Further information regarding the verification process can be found at https:/