diff --git a/docs/source/guides/admin-guides/references/man1/rcons.1.rst b/docs/source/guides/admin-guides/references/man1/rcons.1.rst index e8f4ad2d7..27852f4ea 100644 --- a/docs/source/guides/admin-guides/references/man1/rcons.1.rst +++ b/docs/source/guides/admin-guides/references/man1/rcons.1.rst @@ -37,6 +37,10 @@ If \ *conserver-host*\ is specified, the conserver daemon on that host will be To exit the console session, enter: 'ctrl-e c .' (3 characters: ctrl-e, 'c' and '.'). +For confluent backed consoles, an extended outage of connectivity to the endpoint will result in an automated retry +of a randomized interval between 2 to 4 minutes. You can either close and reopen the console to force a quicker +reconnect, or enter 'ctrl-e o a' (3 characters: ctrl-e, 'o' and 'a') to request an immediate reconnect attempt. + *************** \ **Options**\ diff --git a/docs/source/guides/admin-guides/references/man1/reventlog.1.rst b/docs/source/guides/admin-guides/references/man1/reventlog.1.rst index 108ccbe9d..e997cdcd3 100644 --- a/docs/source/guides/admin-guides/references/man1/reventlog.1.rst +++ b/docs/source/guides/admin-guides/references/man1/reventlog.1.rst @@ -38,7 +38,10 @@ OpenPOWER OpenBMC specific : \ **reventlog**\ can display any number of remote hardware event log entries or clear them for a range of nodes. Hardware event -logs are stored on each servers service processor. +logs are stored on each servers service processor. Note that some sensor types +are not currently implemented, resulting in 'No Mappings Found' messages. If these +are observed, it is suggested to look at confluent's equivalent 'nodeeventlog' facility, +which supports a broader set of sensor types. *************** diff --git a/docs/source/guides/admin-guides/references/man3/noderange.3.rst b/docs/source/guides/admin-guides/references/man3/noderange.3.rst index 7c72ab9d2..3bd71a1d3 100644 --- a/docs/source/guides/admin-guides/references/man3/noderange.3.rst +++ b/docs/source/guides/admin-guides/references/man3/noderange.3.rst @@ -11,7 +11,7 @@ Name **** -\ **noderange**\ - syntax for compactly expressing a list of node names +\ **noderange**\ - syntax for compactly expressing a list of node names in \ **xCAT**\ **************** diff --git a/docs/source/guides/admin-guides/references/man5/networks.5.rst b/docs/source/guides/admin-guides/references/man5/networks.5.rst index c71afb5f2..1c05e565f 100644 --- a/docs/source/guides/admin-guides/references/man5/networks.5.rst +++ b/docs/source/guides/admin-guides/references/man5/networks.5.rst @@ -68,7 +68,7 @@ networks Attributes: \ **dhcpserver**\ - The DHCP server that is servicing this network. Required to be explicitly set for pooled service node operation. + The DHCP server that is servicing this network. Required to be explicitly set for pooled service node operation. This field should not be set except for service node operation. Also, is not a valid field value for this field. diff --git a/docs/source/guides/admin-guides/references/man8/makedhcp.8.rst b/docs/source/guides/admin-guides/references/man8/makedhcp.8.rst index 79f2b2ef0..d6c57a06b 100644 --- a/docs/source/guides/admin-guides/references/man8/makedhcp.8.rst +++ b/docs/source/guides/admin-guides/references/man8/makedhcp.8.rst @@ -40,7 +40,8 @@ DESCRIPTION The \ **makedhcp**\ command creates and updates the DHCP configuration on the management node and service nodes. -The \ **makedhcp**\ command is supported for both Linux and AIX clusters. +The \ **makedhcp**\ command is supported for both Linux and AIX clusters. Note that it will intentionally not +generate UEFI configuration if the OS indicated in nodetype.os is not UEFI supported, even if the OS being booted is shell. On Linux, the DHCP implementation is selected by the ``site.dhcpbackend`` attribute. The ``auto`` setting keeps ISC DHCP on platforms where it is still available and uses Kea DHCP on platforms such as EL10 and Ubuntu 24.04. For legacy ISC DHCP deployments that need a non-default OMAPI/TSIG key, use diff --git a/docs/source/guides/admin-guides/references/man8/nodeset.8.rst b/docs/source/guides/admin-guides/references/man8/nodeset.8.rst index 97ebf1649..f9a4e9340 100644 --- a/docs/source/guides/admin-guides/references/man8/nodeset.8.rst +++ b/docs/source/guides/admin-guides/references/man8/nodeset.8.rst @@ -38,7 +38,9 @@ nodes or groups. It tells xCAT what you want to happen the next time the nodes are booted up. See noderange(3)|noderange.3. \ **nodeset**\ accomplishes this by changing the network boot files. Each xCAT node always boots from the network and downloads a boot file with instructions on what action to -take next. +take next. Should the nodetype.os indicates an OS that does not support UEFI +boot, then the dhcp definition will not include UEFI boot directives, even +if doing \ **nodeset shell**\ . \ **nodeset**\ will manipulate the boot configuration files of xnba, grub2, petitboot, yaboot and pxelinux.0. diff --git a/perl-xCAT/xCAT/Schema.pm b/perl-xCAT/xCAT/Schema.pm index 8f3c9d6e4..b3358d642 100644 --- a/perl-xCAT/xCAT/Schema.pm +++ b/perl-xCAT/xCAT/Schema.pm @@ -566,7 +566,7 @@ passed as argument rather than by table value', mask => 'The network mask.', mgtifname => 'The interface name of the management/service node facing this network. !remote! indicates a non-local network on a specific nic for relay DHCP.', gateway => 'The network gateway. It can be set to an ip address or the keyword , the keyword indicates the cluster-facing ip address configured on this management node or service node. Leaving this field blank means that there is no gateway for this network.', - dhcpserver => 'The DHCP server that is servicing this network. Required to be explicitly set for pooled service node operation.', + dhcpserver => 'The DHCP server that is servicing this network. Required to be explicitly set for pooled service node operation. This field should not be set except for service node operation. Also, is not a valid field value for this field.', tftpserver => 'The TFTP server that is servicing this network. If not set, the DHCP server is assumed.', nameservers => 'A comma delimited list of DNS servers that each node in this network should use. This value will end up in the nameserver settings of the /etc/resolv.conf on each node in this network. If this attribute value is set to the IP address of an xCAT node, make sure DNS is running on it. In a hierarchical cluster, you can also set this attribute to "" to mean the DNS server for each node in this network should be the node that is managing it (either its service node or the management node). Used in creating the DHCP network definition, and DNS configuration.', ntpservers => 'The ntp servers for this network. Used in creating the DHCP network definition. Assumed to be the DHCP server if not set.', diff --git a/xCAT-client/pods/man1/rcons.1.pod b/xCAT-client/pods/man1/rcons.1.pod index 8219b0684..8a875421d 100644 --- a/xCAT-client/pods/man1/rcons.1.pod +++ b/xCAT-client/pods/man1/rcons.1.pod @@ -18,6 +18,10 @@ If I is specified, the conserver daemon on that host will be con To exit the console session, enter: 'ctrl-e c .' (3 characters: ctrl-e, 'c' and '.'). +For confluent backed consoles, an extended outage of connectivity to the endpoint will result in an automated retry +of a randomized interval between 2 to 4 minutes. You can either close and reopen the console to force a quicker +reconnect, or enter 'ctrl-e o a' (3 characters: ctrl-e, 'o' and 'a') to request an immediate reconnect attempt. + =head1 B =over 5 diff --git a/xCAT-client/pods/man1/reventlog.1.pod b/xCAT-client/pods/man1/reventlog.1.pod index 406f62bb5..6f0255552 100644 --- a/xCAT-client/pods/man1/reventlog.1.pod +++ b/xCAT-client/pods/man1/reventlog.1.pod @@ -17,7 +17,10 @@ B I [B{I|B}] B can display any number of remote hardware event log entries or clear them for a range of nodes. Hardware event -logs are stored on each servers service processor. +logs are stored on each servers service processor. Note that some sensor types +are not currently implemented, resulting in 'No Mappings Found' messages. If these +are observed, it is suggested to look at confluent's equivalent 'nodeeventlog' facility, +which supports a broader set of sensor types. =head1 B diff --git a/xCAT-client/pods/man3/noderange.3.pod b/xCAT-client/pods/man3/noderange.3.pod index 213272159..f4f0d4112 100644 --- a/xCAT-client/pods/man3/noderange.3.pod +++ b/xCAT-client/pods/man3/noderange.3.pod @@ -1,6 +1,6 @@ =head1 Name -B - syntax for compactly expressing a list of node names +B - syntax for compactly expressing a list of node names in B =head1 B diff --git a/xCAT-client/pods/man8/makedhcp.8.pod b/xCAT-client/pods/man8/makedhcp.8.pod index 1fe9b85a8..ae16ada53 100644 --- a/xCAT-client/pods/man8/makedhcp.8.pod +++ b/xCAT-client/pods/man8/makedhcp.8.pod @@ -21,7 +21,8 @@ B B<[-h|--help]> =head1 DESCRIPTION The B command creates and updates the DHCP configuration on the management node and service nodes. -The B command is supported for both Linux and AIX clusters. +The B command is supported for both Linux and AIX clusters. Note that it will intentionally not +generate UEFI configuration if the OS indicated in nodetype.os is not UEFI supported, even if the OS being booted is shell. On Linux, the DHCP implementation is selected by the C attribute. The C setting keeps ISC DHCP on platforms where it is still available and uses Kea DHCP on platforms such as EL10 and Ubuntu 24.04. diff --git a/xCAT-client/pods/man8/nodeset.8.pod b/xCAT-client/pods/man8/nodeset.8.pod index 354cf92b7..2080c260e 100644 --- a/xCAT-client/pods/man8/nodeset.8.pod +++ b/xCAT-client/pods/man8/nodeset.8.pod @@ -19,7 +19,9 @@ nodes or groups. It tells xCAT what you want to happen the next time the nodes are booted up. See L. B accomplishes this by changing the network boot files. Each xCAT node always boots from the network and downloads a boot file with instructions on what action to -take next. +take next. Should the nodetype.os indicates an OS that does not support UEFI +boot, then the dhcp definition will not include UEFI boot directives, even +if doing B. B will manipulate the boot configuration files of xnba, grub2, petitboot, yaboot and pxelinux.0.