Update man pages for aarch64

xcat2 · Jul 12, 2024 · 857e290 · 857e290
1 parent 0d2c970
commit 857e290
Show file tree

Hide file tree

Showing 9 changed files with 20 additions and 13 deletions.
diff --git a/docs/source/guides/admin-guides/basic_concepts/xcat_object/node.rst b/docs/source/guides/admin-guides/basic_concepts/xcat_object/node.rst
@@ -13,7 +13,7 @@ Key Attributes
     The operating system deployed on this node. Valid values: AIX, rhels*, rhelc*, rhas*, centos*, SL*, fedora*, sles* (where * is the version #)
 
 * arch:
-    The hardware architecture of this node. Valid values: x86_64, ppc64, x86, ia64.
+    The hardware architecture of this node. Valid values: x86_64, ppc64, x86, ia64, aarch64.
 
 * groups:
     Usually, there are a set of nodes with some attributes in common, xCAT admin can define a node group containing these nodes, so that the management task can be issued against the group instead of individual nodes. A node can be a member of different groups, so the value of this attributes is a comma-delimited list of groups. At least one group is required to create a node. The new created group names should not be prefixed with "__" as this token has been preserved as the internal group name.
@@ -33,7 +33,7 @@ Key Attributes
               +--------------------------+----------------------+-----------------------------------+
               | Arch and Machine Type    |   OS                 |       valid netboot options       |
               +==========================+======================+===================================+
-              |       x86, x86_64        |   ALL                |       pxe, xnba                   |
+              |       x86, x86_64        |   ALL                |       pxe, xnba, grub2            |
               +--------------------------+----------------------+-----------------------------------+
               |         ppc64            | <=rhel6, <=sles11.3  |       yaboot                      |
               +--------------------------+----------------------+-----------------------------------+
@@ -42,6 +42,8 @@ Key Attributes
               |   ppc64le NonVirtualize  |    ALL               |       petitboot                   |
               +--------------------------+----------------------+-----------------------------------+
               |   ppc64le PowerKVM Guest |    ALL               |       grub2,grub2-http,grub2-tftp |
+              +--------------------------+----------------------+-----------------------------------+
+              |        aarch64           |    >=el8             |       grub2                       |
               +-------------------------------------------------+-----------------------------------+
 
 * postscripts:

diff --git a/docs/source/guides/admin-guides/references/man1/genimage.1.rst b/docs/source/guides/admin-guides/references/man1/genimage.1.rst
@@ -49,7 +49,9 @@ Besides prompting for some parameter values, the \ **genimage**\  command takes
 
 If \ **-**\ **-onlyinitrd**\  is specified, genimage only regenerates the initrd for a stateless image to be used for a diskless install.
 
-The \ **genimage**\  command must be run on a system that is the same architecture and same distro with same major release version as the nodes it will be used on.  If the management node is not the same architecture or same distro level, copy the contents of
+The \ **genimage**\  command must be run on a system that is the same architecture and same distro with same major release version as the nodes it will be used on.
+For different architectures, \ **genimage**\  will try to use QEMU emulation if qemu-user-static is installed and configured via systemd-binfmt.
+If this does not work or the management node is not the same distro level, copy the contents of
 /opt/xcat/share/xcat/netboot/<os> to a system that is the proper architecture, and mount /install from
 the management node to that system. Then change directory to /opt/xcat/share/xcat/netboot/<os> and run ./genimage.
 
@@ -70,7 +72,7 @@ OPTIONS
 
 \ **-a**\  \ *arch*\ 
 
- The hardware architecture of this node: ppc64le, x86_64, ppc64, x86, ia64, etc.  If omitted, the current hardware architecture will be used.
+ The hardware architecture of this node: ppc64le, x86_64, ppc64, x86, ia64, aarch64 etc.  If omitted, the current hardware architecture will be used.
 
 
 

diff --git a/docs/source/guides/admin-guides/references/man5/noderes.5.rst b/docs/source/guides/admin-guides/references/man5/noderes.5.rst
@@ -56,11 +56,12 @@ noderes Attributes:
  .. code-block:: perl
  
                          Arch                    OS                           valid netboot options
-                         x86, x86_64             ALL                          pxe, xnba
+                         x86, x86_64             ALL                          pxe, xnba, grub2
                          ppc64                   <=rhel6, <=sles11.3          yaboot
                          ppc64                   >=rhels7, >=sles11.4         grub2,grub2-http,grub2-tftp
                          ppc64le NonVirtualize   ALL                          petitboot
                          ppc64le PowerKVM Guest  ALL                          grub2,grub2-http,grub2-tftp
+                         aarch64                 >=el8                        grub2
  
  
 

diff --git a/docs/source/guides/admin-guides/references/man5/nodetype.5.rst b/docs/source/guides/admin-guides/references/man5/nodetype.5.rst
@@ -50,7 +50,7 @@ nodetype Attributes:
 
 \ **arch**\ 
 
- The hardware architecture of this node.  Valid values: x86_64, ppc64, x86, ia64.
+ The hardware architecture of this node.  Valid values: x86_64, ppc64, x86, ia64, aarch64.
 
 
 

diff --git a/docs/source/guides/admin-guides/references/man5/osimage.5.rst b/docs/source/guides/admin-guides/references/man5/osimage.5.rst
@@ -110,7 +110,7 @@ osimage Attributes:
 
 \ **osarch**\ 
 
- The hardware architecture of this node.  Valid values: x86_64, ppc64, x86, ia64.
+ The hardware architecture of this node. For netboot/statelite images, QEMU emulation for non-native architectures is used if qemu-user-static is installed and configured via systemd-binfmt.  Valid values: x86_64, ppc64, x86, ia64, aarch64.
 
 
 

diff --git a/docs/source/guides/admin-guides/references/man7/group.7.rst b/docs/source/guides/admin-guides/references/man7/group.7.rst
@@ -47,7 +47,7 @@ group Attributes:
 
 \ **arch**\  (nodetype.arch)
 
- The hardware architecture of this node.  Valid values: x86_64, ppc64, x86, ia64.
+ The hardware architecture of this node.  Valid values: x86_64, ppc64, x86, ia64, aarch64.
 
 
 
@@ -591,11 +591,12 @@ group Attributes:
  .. code-block:: perl
  
                          Arch                    OS                           valid netboot options
-                         x86, x86_64             ALL                          pxe, xnba
+                         x86, x86_64             ALL                          pxe, xnba, grub2
                          ppc64                   <=rhel6, <=sles11.3          yaboot
                          ppc64                   >=rhels7, >=sles11.4         grub2,grub2-http,grub2-tftp
                          ppc64le NonVirtualize   ALL                          petitboot
                          ppc64le PowerKVM Guest  ALL                          grub2,grub2-http,grub2-tftp
+                         aarch64                 >=el8                        grub2
  
  
 

diff --git a/docs/source/guides/admin-guides/references/man7/node.7.rst b/docs/source/guides/admin-guides/references/man7/node.7.rst
@@ -59,7 +59,7 @@ node Attributes:
 
 \ **arch**\  (nodetype.arch)
 
- The hardware architecture of this node.  Valid values: x86_64, ppc64, x86, ia64.
+ The hardware architecture of this node.  Valid values: x86_64, ppc64, x86, ia64, aarch64.
 
 
 
@@ -591,11 +591,12 @@ node Attributes:
  .. code-block:: perl
  
                          Arch                    OS                           valid netboot options
-                         x86, x86_64             ALL                          pxe, xnba
+                         x86, x86_64             ALL                          pxe, xnba, grub2
                          ppc64                   <=rhel6, <=sles11.3          yaboot
                          ppc64                   >=rhels7, >=sles11.4         grub2,grub2-http,grub2-tftp
                          ppc64le NonVirtualize   ALL                          petitboot
                          ppc64le PowerKVM Guest  ALL                          grub2,grub2-http,grub2-tftp
+                         aarch64                 >=el8                        grub2
  
  
 

diff --git a/docs/source/guides/admin-guides/references/man7/osimage.7.rst b/docs/source/guides/admin-guides/references/man7/osimage.7.rst
@@ -225,7 +225,7 @@ osimage Attributes:
 
 \ **osarch**\  (osimage.osarch)
 
- The hardware architecture of this node.  Valid values: x86_64, ppc64, x86, ia64.
+ The hardware architecture of this node. For netboot/statelite images, QEMU emulation for non-native architectures is used if qemu-user-static is installed and configured via systemd-binfmt.  Valid values: x86_64, ppc64, x86, ia64, aarch64.
 
 
 

diff --git a/xCAT-client/pods/man1/genimage.1.pod b/xCAT-client/pods/man1/genimage.1.pod
@@ -50,7 +50,7 @@ I<imagename> specifies the name of an os image definition to be used. The specif
 
 =item B<-a> I<arch>
 
-The hardware architecture of this node: ppc64le, x86_64, ppc64, x86, ia64, etc.  If omitted, the current hardware architecture will be used.
+The hardware architecture of this node: ppc64le, x86_64, ppc64, x86, ia64, aarch64 etc.  If omitted, the current hardware architecture will be used.
 
 =item B<-o> I<osver>
Original file line number	Diff line number	Diff line change
Expand Up		@@ -50,7 +50,7 @@ nodetype Attributes:

		\ arch\

		The hardware architecture of this node. Valid values: x86_64, ppc64, x86, ia64.
		The hardware architecture of this node. Valid values: x86_64, ppc64, x86, ia64, aarch64.



Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -110,7 +110,7 @@ osimage Attributes:

		\ osarch\

		The hardware architecture of this node. Valid values: x86_64, ppc64, x86, ia64.
		The hardware architecture of this node. For netboot/statelite images, QEMU emulation for non-native architectures is used if qemu-user-static is installed and configured via systemd-binfmt. Valid values: x86_64, ppc64, x86, ia64, aarch64.



Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -225,7 +225,7 @@ osimage Attributes:

		\ osarch\ (osimage.osarch)

		The hardware architecture of this node. Valid values: x86_64, ppc64, x86, ia64.
		The hardware architecture of this node. For netboot/statelite images, QEMU emulation for non-native architectures is used if qemu-user-static is installed and configured via systemd-binfmt. Valid values: x86_64, ppc64, x86, ia64, aarch64.



Expand Down