Step 12: Build Cluster Node Images
====================================

The ``build_image_x86_64.yml`` and ``build_image_aarch64.yml`` playbooks are used to build diskless images for ``x86_64`` and ``aarch64`` cluster nodes, respectively. 
Each image is created based on the functional groups defined in the mapping file. 

.. caution:: Limited validation has been performed on aarch64 platform.

**Prerequisites**: 

   * Ensure the OIM has internet access.
   * Ensure that the mapping file contains nodes with the functional groups required for your environment. For more information on functional groups, see :doc:`composable_roles`.
   * Make sure the ``local_repo.yml`` is executed with software packages matching the target architecture. If the build is for ``x86_64``, include software defined with ``x86_64``. If the build is for ``aarch64``, include software with ``aarch64``.
     If the build needs to support both architectures, ensure ``local_repo.yml`` is executed with ``software_config.json`` that include both ``x86_64`` and ``aarch64``.
   * Ensure that OIMs running RHEL have an active subscription or are configured to access local repositories.
   * Note the compatibility between cluster OS and OIM OS below:

        +---------------------+--------------------+------------------+
        |                     |                    |                  |
        | OIM OS              | Cluster  Node OS   | Compatibility    |
        +=====================+====================+==================+
        |                     |                    |                  |
        | RHEL                | RHEL               | Yes              |
        +---------------------+--------------------+------------------+
   
Build Images for x86_64 Cluster Nodes
----------------------------------------

To build images for the nodes present in each functional group, do the following.

1. Navigate to the image build directory::

       cd /omnia/build_image_x86_64

2. To build the image, run the following playbook::

       ansible-playbook build_image_x86_64.yml

3. To verify that images are created for each functional group defined in the mapping file, run the following command on OIM::

       s3cmd ls -Hr s3://boot-images

   The images created for each functional group are listed in the boot-images directory.


Build Images for aarch64 Cluster Nodes
------------------------------------------

To build images for the nodes present in each functional group, do the following.

1. Prepare the aarch64 cluster nodes by following the steps provided in :doc:`../AdvancedConfigurations/build_arm_ochami_image`.

2. Navigate to the image build directory::

       cd /omnia/build_image_aarch64

3. To build the image, run the appropriate playbook based on the node architecture::

       ansible-playbook build_image_aarch64.yml -i inventory

   **Sample aarch64 inventory**::

       [admin_aarch64]
       10.0.0.1

4. To verify that images are created for each functional group defined in the mapping file, run the following command on the OIM::

       s3cmd ls -Hr s3://boot-images

   The images created for each functional group are listed in the boot-images directory.