Chapter 7. Deploying a RHEL for Edge image in a non-network-based environment

Procedure

1. Navigate to the directory where you have downloaded the RHEL for Edge Container OSTree commit.

2. Load the RHEL for Edge Container OSTree commit into Podman.

   $ sudo podman load -i UUID-container.tar

   Copy to Clipboard Toggle word wrap

   The command output provides the image ID, for example: @8e0d51f061ff1a51d157804362bc875b649b27f2ae1e66566a15e7e6530cec63

3. Tag the new RHEL for Edge Container image, using the image ID generated by the previous step.

   $ sudo podman tag image-ID localhost/edge-container

   Copy to Clipboard Toggle word wrap

   The podman tag command assigns an additional name to the local image.

4. Run the container named edge-container.

   $ sudo podman run -d --name=edge-container -p 8080:8080 localhost/edge-container

   Copy to Clipboard Toggle word wrap

   The podman run -d --name=edge-container command assigns a name to your container-based on the localhost/edge-container image.

5. List containers:

   $ sudo podman ps -a
   CONTAINER ID  IMAGE                               	COMMAND	CREATED    	STATUS                	PORTS   NAMES
   2988198c4c4b  …./localhost/edge-container   /bin/bash  3 seconds ago  Up 2 seconds ago      	edge-container

   Copy to Clipboard Toggle word wrap

Procedure

1. Begin to create the RHEL for Edge Installer image.

   # composer-cli compose start-ostree --ref rhel/8/x86_64/edge --url URL-OSTree-repository blueprint-name image-type

   Copy to Clipboard Toggle word wrap

   Where,

   • ref is the same value that customer used to build OSTree repository
   • URL-OSTree-repository is the URL to the OSTree repository of the commit to embed in the image. For example, http://10.0.2.2:8080/repo/. See Creating a RHEL for Edge Container image for non-network-based deployments.
   • blueprint-name is the RHEL for Edge Installer blueprint name.

   • image-type is edge-installer.

     A confirmation that the composer process has been added to the queue appears. It also shows a Universally Unique Identifier (UUID) number for the image created. Use the UUID number to track your build. Also keep the UUID number handy for further tasks.

2. Check the image compose status.

   # composer-cli compose status

   Copy to Clipboard Toggle word wrap

   The command output displays the status in the following format:

   <UUID> RUNNING date blueprint-name blueprint-version image-type

   Copy to Clipboard Toggle word wrap
   Note

   The image creation process takes a few minutes to complete.

   To interrupt the image creation process, run:

   # composer-cli compose cancel <UUID>

   Copy to Clipboard Toggle word wrap

   To delete an existing image, run:

   # composer-cli compose delete <UUID>

   Copy to Clipboard Toggle word wrap

   RHEL image builder pulls the commit that is being served by the running container during the image build.

   After the image build is complete, you can download the resulting ISO image.

3. Download the image. See Downloading a RHEL for Edge image.

   After the image is ready, you can use it for non-network deployments. See Installing the RHEL for Edge image for non-network-based deployments.

Procedure

1. Create a qcow VM disk file to install the (.iso) image. That is an image of a hard disk drive for the virtual machine (VM). For example:

   $ qemu-img create -f qcow2 diskfile.qcow2 20G

   Copy to Clipboard Toggle word wrap

2. Use the virt-install command to boot the VM using the disk as a drive and the installer ISO image as a CD-ROM. For example:

   $ virt-install \
   --boot uefi \
   --name VM_NAME
   --memory 2048 \
   --vcpus 2 \
   --disk path=diskfile.qcow2
   --cdrom /var/lib/libvirt/images/UUID-installer.iso \
   --os-variant rhel9.0

   Copy to Clipboard Toggle word wrap

   This command instructs virt-install to:

   • Instructs the VM to use UEFI to boot, instead of the BIOS.
   • Mount the installation ISO.

   • Use the hard disk drive image created in the first step.

     It gives you an Anaconda Installer. The RHEL Installer starts, loads the Kickstart file from the ISO and executes the commands, including the command to install the RHEL for Edge image commit. Once the installation is complete, the RHEL installer prompts for login details.

     Note

     Anaconda is preconfigured to use the Container commit during the installation. However, you need to set up system configurations, such as disk partition, timezone, between others.

3. Connect to Anaconda GUI with virt-viewer to setup the system configuration:

   $ virt-viewer --connect qemu:///system --wait VM_NAME

   Copy to Clipboard Toggle word wrap
4. Reboot the system to finish the installation.
5. On the login screen, specify your user account credentials and click Enter.

Verification

1. Verify whether the RHEL for Edge image is successfully installed.

   $  rpm-ostree status

   Copy to Clipboard Toggle word wrap