2
0
mirror of https://github.com/xcat2/xcat-core.git synced 2026-11-21 01:42:15 +00:00
Commit Graph

117 Commits

Author SHA1 Message Date
Daniel Hilst d74285f4a2 fix(xcat-core): an EL 8 or EL 9 IPv6-only node installs with a DHCPv6 address that holds no reservation
An IPv6-only EL 8 or EL 9 node presents a different DHCPv6 DUID at each boot
stage: the UEFI firmware, then iPXE, then anaconda. makedhcp reserves the
first two, so the installer takes an address from the dynamic range and every
step that reads the reserved address or its PTR record fails.

xCAT::SvrUtils::uses_static_ipv6_boot accepted the rh family only at major 10,
so Template.pm rendered "dhcp --noipv4 --ipv6=dhcp" for EL 8 and EL 9. The
floor is now 8, by operator decision of 2026-11-05.

pre.rhels8 was IPv4 only in two places. The install monitor opened an AF_INET
socket, so the node reported no status. The install server was cut out of its
URL at the first colon, which splits an IPv6 literal. Both forms come from
pre.rhels10. pre.openeuler includes pre.rhels8 whole, so this also fixes the
reported openEuler defect.

ipv6_pre_rhels8.bats and the EL 8 and EL 9 cases of template_ipv6_rendering.t
capture it. With AF_UNSPEC back to AF_INET the three IPv6 monitor cases fail
and the IPv4 one passes. Without the bracket branch the three IPv6 URL cases
fail and the four IPv4 ones pass. With the floor back at 10 the EL 8 and EL 9
rendering cases fail and the EL 10 ones pass.

Signed-off-by: Daniel Hilst <392820+dhilst@users.noreply.github.com>
2026-11-05 16:31:41 -03:00
Daniel Hilst b82597dec2 docs(xcat-core): the IPv6 and iPXE pages name grub2 as a workaround that cannot work
No package installs an x86_64 grub2 image. grub2-xcat ships powerpc-ieee1275, riscv64-efi and
aarch64-efi, and copycds publishes a grub2 image for riscv64 alone, so an x86_64 node set to
netboot=grub2 asks TFTP for a file that is not there.

The iPXE page told the reader to use netboot=grub2 on the Lenovo UEFI firmware that hangs on
iPXE v2.0.0. That page now records the limit with no x86_64 workaround.

The IPv6 page required Secure Boot off for every node. That is a grub2 constraint: ipxe-xcat
installs a Microsoft-signed shim, so an x86_64 node with netboot=ipxe boots with Secure Boot on.

The same page said nodeset writes the address on the kernel command line. That holds on EL 10,
on openEuler, on an Ubuntu diskless node and on SLES and openSUSE, each through a different
parameter, and not on EL 8, EL 9 or an Ubuntu diskful node. A table names the parameter and the
routine per family, and says that a family which keeps DHCPv6 needs the dynamic range.

Signed-off-by: Daniel Hilst <392820+dhilst@users.noreply.github.com>
2026-11-05 09:52:01 -03:00
Daniel Hilst b195fea1a7 fix(yaboot): a dual-stack node is linked to a boot configuration name no firmware asks for
yaboot links its configuration file to one name for each address of the node in
the mac table. The name is sprintf("%02x%02x%02x%02x", split(/\./, $ip)), and an
IPv6 address has no four octets: sprintf reads the first field as a number and
fills the rest with zeroes, so 2001:db8:156::10 gives 7d1000000. A dual-stack
node got one correct link and one link to a name no firmware requests, with no
warning. getipaddr returns the IPv6 address first on such a node, so this is
reachable without an IPv6-only network.

yaboot_config_name returns a name only for an address with four octets in range,
and the loop passes over anything else. A node that produced no name at all is
reported with what to use instead, rather than reporting success.

The error for a node with no facing address and no service node interpolated
$myname, which is declared in the branch above it and not in that one. The file
has no "use strict", so the message read ": " and the name of the management node
was lost. It now determines the name where it uses it.

This commit no longer routes the facing address by family. yaboot is reachable
only at osarch=ppc64 with RHEL earlier than 7 or SLES earlier than 11.4, and the
support matrix carries no ppc64 column, so there is no supported configuration
whose yaboot node could be IPv6-only. petitboot keeps that work, because
nodediscover selects it for PowerNV and noderes.5 documents it for bare-metal
ppc64le.

yaboot_config_name.t covers the guard. Removing it fails the four name checks and
leaves the two IPv4 checks passing, which tells the defect apart from a test that
dies.

Signed-off-by: Daniel Hilst <392820+dhilst@users.noreply.github.com>
2026-10-31 09:07:37 -03:00
Daniel Hilst e1a36fd5b5 docs(networks): IPv6 provisioning has no admin documentation
The IPv6 provisioning support has no page in the admin guide, so two
requirements that a cluster cannot work without are only visible in the code.
Only netboot=grub2, grub2-http and grub2-tftp get a bootfile-url in a DHCPv6
reservation, and the grub2 image under /tftpboot/boot/grub2 is not signed, so
firmware that enforces Secure Boot downloads it and refuses to start it.

The page states both requirements, how xCAT predicts the DHCPv6 client
identifier from vpd.uuid, what the configdhcpv6duid postscript does, and the
static address that nodeset puts on the kernel command line.

Signed-off-by: Daniel Hilst <392820+dhilst@users.noreply.github.com>
2026-10-28 02:11:09 -03:00
Obihörnchen 7b4e9cef5a Merge pull request #6876 from krono/patch-1
[doc only] Add vlan to networks documentation
2024-02-19 19:10:34 +01:00
Mark Gurevich 55867269ec Doc update for Service Node upgrading 2022-05-26 11:31:30 -04:00
besawn 60af1ce6c0 Spelling fixes in advanced/networks docs 2022-02-10 08:19:58 -05:00
Tobias Pape 657a1b6122 Add vlan to networks documentation
Apparently the doc was contributed some time ago and is live (https://xcat-docs.readthedocs.io/en/stable/advanced/networks/vlan/index.html) but not referenced in the toc for networking (https://xcat-docs.readthedocs.io/en/stable/advanced/networks/index.html)
2020-11-12 16:10:07 +01:00
cxhong 478164108a uncomment the getadapter.rst in the conf.py 2020-07-31 16:28:48 -04:00
cxhong cdd22810b5 Add getadapter to xCAT Doc 2020-07-31 12:27:42 -04:00
cxhong bd7ff51f6c Remove confignics for xCAT doc 2020-06-04 10:00:56 -04:00
Wai Yee Wong 15e1ba454c Remove the space between with and out to get without. 2020-02-26 15:42:24 -05:00
cxhong 9c30f71088 Add multiple kernel support to mlnxofed_ib_install script, remove v2 version 2019-05-10 12:15:25 -04:00
Victor Hu 8280915486 Some updates and refactoring to a section of the switch-based switch discovery doc 2018-11-20 11:42:16 -05:00
Obihörnchen dfe968db2f [Docu] IB switch configuration: fix passwd entry
The entry in the passwd table has to use the key `switch`, otherwise the sshusername and password is not detected.

See `man switches` page:
```
       sshusername
                 The remote login user name. It can be for ssh or telnet. If it is for telnet,
                 set protocol to "telnet". If the sshusername is blank, the username, password
                 and protocol will be retrieved from the passwd table with "switch" as the key.

       sshpassword
                 The remote login password. It can be for ssh or telnet. If it is for telnet, set
                 protocol to "telnet". If the sshusername is blank, the username, password and
                 protocol will be retrieved from the passwd table with "switch" as the key.
```
See `man passwd` page:
```
       key
              The type of component this user/pw is for. Valid values: blade (management module), 
              ipmi (BMC), system (nodes), omapi (DHCP), hmc, ivm, cec, frame, switch.
```
2018-09-26 14:48:09 +02:00
Mark Gurevich 830ae48994 Clarify doc for REST API over http 2018-09-05 16:09:02 -04:00
cxhong 5b7b407793 update onie doc to add rspconfig sshcfg command (#5539) 2018-08-21 14:23:56 +08:00
GONG Jie 03e7ecc0e7 Remove trailing spaces in file docs/source/advanced/networks/vlan/vlan.rst 2017-12-31 23:59:59 +00:00
GONG Jie ecf01c5303 Remove trailing spaces in file docs/source/advanced/networks/switchdiscover/switch_based_switch_discovery.rst 2017-12-31 23:59:59 +00:00
GONG Jie 9819c2d367 Remove trailing spaces in file docs/source/advanced/networks/switchdiscover/index.rst 2017-12-31 23:59:59 +00:00
GONG Jie 0ffb90e2e2 Remove trailing spaces in file docs/source/advanced/networks/onie_switches/os_cumulus/ztp.rst 2017-12-31 23:59:59 +00:00
GONG Jie 4a33008080 Remove trailing spaces in file docs/source/advanced/networks/onie_switches/os_cumulus/upgrade.rst 2017-12-31 23:59:59 +00:00
GONG Jie 80b3b7ed87 Remove trailing spaces in file docs/source/advanced/networks/onie_switches/os_cumulus/prepare.rst 2017-12-31 23:59:59 +00:00
GONG Jie 2a4158842a Remove trailing spaces in file docs/source/advanced/networks/onie_switches/os_cumulus/manage.rst 2017-12-31 23:59:59 +00:00
GONG Jie ad762f3bb3 Remove trailing spaces in file docs/source/advanced/networks/onie_switches/os_cumulus/install.rst 2017-12-31 23:59:59 +00:00
GONG Jie 27910a4cad Remove trailing spaces in file docs/source/advanced/networks/onie_switches/index.rst 2017-12-31 23:59:59 +00:00
GONG Jie 196fd2c8be Remove trailing spaces in file docs/source/advanced/networks/infiniband/ufm_configuration.rst 2017-12-31 23:59:59 +00:00
GONG Jie 1b13317eb7 Remove trailing spaces in file docs/source/advanced/networks/infiniband/switch_configuration.rst 2017-12-31 23:59:59 +00:00
GONG Jie 4cbb30609c Remove trailing spaces in file docs/source/advanced/networks/infiniband/network_configuration.rst 2017-12-31 23:59:59 +00:00
GONG Jie bbb51fa7a8 Remove trailing spaces in file docs/source/advanced/networks/infiniband/mlnxofed_ib_verified_scenario_matrix.rst 2017-12-31 23:59:59 +00:00
GONG Jie 0b51f619f0 Remove trailing spaces in file docs/source/advanced/networks/infiniband/mlnxofed_ib_known_issue.rst 2017-12-31 23:59:59 +00:00
GONG Jie 717fa816fc Remove trailing spaces in file docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v2_preparation.rst 2017-12-31 23:59:59 +00:00
GONG Jie 52b3ad689b Remove trailing spaces in file docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v2_diskless.rst 2017-12-31 23:59:59 +00:00
GONG Jie 2084197ceb Remove trailing spaces in file docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v2_diskful.rst 2017-12-31 23:59:59 +00:00
GONG Jie 61f390bc12 Remove trailing spaces in file docs/source/advanced/networks/infiniband/mlnxofed_ib_install_v2.rst 2017-12-31 23:59:59 +00:00
GONG Jie 2a07b50d23 Remove trailing spaces in file docs/source/advanced/networks/infiniband/mlnxofed_configuration.rst 2017-12-31 23:59:59 +00:00
GONG Jie 3448e7cace Remove trailing spaces in file docs/source/advanced/networks/infiniband/firmware_updates.rst 2017-12-31 23:59:59 +00:00
GONG Jie 954b3a471a Remove trailing spaces in file docs/source/advanced/networks/getadapter.rst 2017-12-31 23:59:59 +00:00
GONG Jie bb53d5a91b Remove trailing spaces in file docs/source/advanced/networks/ethernet_switches/ethernet_switches.rst 2017-12-31 23:59:59 +00:00
Victor Hu 9d7354c03c Add Admonitions tags for the Network advanced sections 2018-05-09 14:22:35 -04:00
Victor Hu 15493a4d0b remove ipv6 section as there's no content in it 2018-05-09 14:21:30 -04:00
cxhong d480f8760a Add Copycds/nodeset/syncfiles support to onie switches support (#5173) 2018-05-08 13:44:25 +08:00
Victor Hu 63376fd071 Update mlnxofed_ib_install_v2_diskful.rst
Update the diskful doc to reflect --force option to avoid installer prompting.
2018-04-26 16:13:53 -04:00
hu-weihua deeb77ebd1 Add the mlnxofedinstall default parameters xcat recommended into mlnx diskless installation document 2018-04-15 23:13:12 -04:00
cxhong 4038056879 Add more print statement for config switches scripts (#4872)
* Add more print statement for config switches scripts

* modified from reviews

* more modify from review
2018-03-06 11:25:38 +08:00
Victor Hu c5bf988887 Refine the Cumulus Linux Section of the Doc (#4249)
* No content in the switches subdirectory in docs, remove

* Change the Network topic to Networking

* Refine and reformat the Cumulus Linux documentation
2017-11-16 03:56:29 -06:00
cxhong f295689c22 Merge pull request #4005 from mattaezell/ztp_improvements
Improvements to Cumulus ZTP
2017-10-02 13:39:29 -04:00
Matt Ezell a9b23dfa1d Improvements to Cumulus ZTP
- Use the full path to cl-license
- Allow configinterface to download files
- Run enablesnmp in mypostscript so we have the correct community string
2017-09-25 16:04:09 -04:00
immarvin d8d40f184c add cumulus upgrade doc 2017-09-25 09:38:37 -04:00
chenglch bc6ddccbd0 Modify the document and nics schema based on review comments. 2017-07-21 16:19:24 +08:00