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

Procedure

1. Extract the downloaded image .tar file:

   # tar xvf <UUID>-commit.tar

   Copy to Clipboard Toggle word wrap

2. Go to the directory where you have extracted the .tar file.

   It has a compose.json file and an OSTree directory. The compose.json file has the commit number and the OSTree directory has the RPM packages.

3. Open the compose.json file and note the commit ID number. You need this number handy when you proceed to set up a web server.

   If you have the jq JSON processor installed, you can also retrieve the commit ID by using the jq tool:

   # jq '.["ostree-commit"]' < compose.json

   Copy to Clipboard Toggle word wrap

4. List the RPM packages in the commit.

   # rpm-ostree db list rhel/8/x86_64/edge --repo=repo

   Copy to Clipboard Toggle word wrap

5. Use a Kickstart file to run the RHEL installer. Optionally, you can use any existing file or can create one by using the Kickstart Generator tool.

   In the Kickstart file, ensure that you include the details about how to provision the file system, create a user, and how to fetch and deploy the RHEL for Edge image. The RHEL installer uses this information during the installation process.

   The following is a Kickstart file example:

   lang en_US.UTF-8
   keyboard us
   timezone Etc/UTC --isUtc
   text
   zerombr
   clearpart --all --initlabel
   autopart
   reboot
   user --name=core --group=wheel
   sshkey --username=core "ssh-rsa AAAA3Nza…​."
   rootpw --lock
   network --bootproto=dhcp
   
   ostreesetup --nogpg --osname=rhel --remote=edge --url=https://mirror.example.com/repo/ --ref=rhel/8/x86_64/edge

   Copy to Clipboard Toggle word wrap

   The OStree-based installation uses the ostreesetup command to set up the configuration. It fetches the OSTree commit, by using the following flags:

   • --nogpg - Disable GNU Privacy Guard (GPG) key verification.
   • --osname - Management root for the operating system installation.
   • --remote - Management root for the operating system installation
   • --url - URL of the repository to install from.
   • --ref - Name of the branch from the repository that the installation uses.

   • --url=http://mirror.example.com/repo/ - is the address of the host system where you extracted the edge commit and served it over nginx. You can use the address to reach the host system from the guest computer.

     For example, if you extract the commit image in the /var/www/html directory and serve the commit over nginx on a computer whose hostname is www.example.com, the value of the --url parameter is http://www.example.com/repo.

     Note

     Use the http protocol to start a service to serve the commit, because https is not enabled on the Apache HTTP Server.

Procedure

1. Install the HTTPd server package:

   $ dnf install httpd

   Copy to Clipboard Toggle word wrap

2. Copy the extracted RHEL for Edge image content to the web server document root:

   # cp kickstart.ks /var/www/html/
   # cp -r repo /var/www/html/
   # cp <uuid_commit>.tar /var/www/html/

   Copy to Clipboard Toggle word wrap

3. Start and enable the HTTPd service:

   # systemctl enable --now httpd
   # systemctl status httpd.service

   Copy to Clipboard Toggle word wrap

4. Configure the firewall to enable HTTP traffic:

   # firewall-cmd --permanent --add-service=http
   # firewall-cmd --reload

   Copy to Clipboard Toggle word wrap

   The server is now set up and ready to start the RHEL Installer by using the commit.tar repository and the Kickstart file.

   The files are accessible at the following locations:

Procedure

1. Create a Kickstart file. The following is an example in which the ostreesetup directive instructs the Anaconda Installer to fetch and deploy the commit. Additionally, it creates a user and a password.

   lang en_US.UTF-8
   keyboard us
   timezone UTC
   zerombr
   clearpart --all --initlabel
   autopart --type=plain --fstype=xfs --nohome
   reboot
   text
   network --bootproto=dhcp
   user --name=core --groups=wheel --password=edge
   services --enabled=ostree-remount
   ostreesetup --nogpg --url=http://edge_device_ip:port/repo/ --osname=rhel --remote=edge --ref=rhel/9/x86_64/edge

   Copy to Clipboard Toggle word wrap

2. Run the RHEL Anaconda Installer by using the libvirt virt-install utility to create a virtual machine (VM) with a RHEL operating system. Use the .qcow2 disk image as the target disk in the attended installation:

   virt-install \
   --name rhel-edge-test-1 \
   --memory 2048 \
   --vcpus 2 \
   --disk path=prepared_disk_image.qcow2,format=qcow2,size=8 \
   --os-variant rhel8 \
   --cdrom /home/username/Downloads/rhel-8-x86_64-boot.iso

   Copy to Clipboard Toggle word wrap

3. On the installation screen:

   Figure 6.1. Red Hat Enterprise Linux boot menu

   

   View larger image

   

   1. Press the e key to add an additional kernel parameter:

      inst.ks=http://web-server_device_ip:port/kickstart.ks

      Copy to Clipboard Toggle word wrap

      The kernel parameter specifies that you want to install RHEL by using the Kickstart file and not the RHEL image contained in the RHEL Installer.

   2. After adding the kernel parameters, press Ctrl+X to boot the RHEL installation by using the Kickstart file.

      The RHEL Installer starts, fetches the Kickstart file from the server (HTTP) endpoint and executes the commands, including the command to install the RHEL for Edge image commit from the HTTP endpoint. After the installation completes, the RHEL Installer prompts you for login details.

Verification

1. On the Login screen, enter your user account credentials and click Enter.

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

   $ rpm-ostree status

   Copy to Clipboard Toggle word wrap

   The command output provides the image commit ID and shows that the installation is successful.

   Following is a sample output:

   State: idle
   Deployments:
   * ostree://edge:rhel/8/x86_64/edge
   		  Timestamp: 2020-09-18T20:06:54Z
   			Commit: 836e637095554e0b634a0a48ea05c75280519dd6576a392635e6fa7d4d5e96

   Copy to Clipboard Toggle word wrap

Procedure

1. Run a RHEL for Edge Container image to start a web server. The server fetches the commit in the RHEL for Edge Container image and becomes available and running.

2. Run the RHEL Anaconda Installer, passing the customized .qcow2 disk image, by using libvirt virt-install:

   virt-install \
   --name rhel-edge-test-1 \
   --memory 2048 \
   --vcpus 2 \
   --disk path=prepared_disk_image.qcow2,format=qcow2,size=8 \
   --os-variant rhel8 \
   --cdrom /home/username/Downloads/rhel-8-x86_64-boot.iso

   Copy to Clipboard Toggle word wrap

3. On the installation screen:

   Figure 6.2. Red Hat Enterprise Linux boot menu

   

   View larger image

   

   1. Press the TAB key and add the Kickstart kernel argument:

      inst.ks=http://web-server_device_ip:port/kickstart.ks

      Copy to Clipboard Toggle word wrap

      The kernel parameter specifies that you want to install RHEL by using the Kickstart file and not the RHEL image contained in the RHEL Installer.

   2. After adding the kernel parameters, press Ctrl+X to boot the RHEL installation by using the Kickstart file.

      The RHEL Installer starts, fetches the Kickstart file from the server (HTTP) endpoint, and executes the commands, including the command to install the RHEL for Edge image commit from the HTTP endpoint. After the installation completes, the RHEL Installer prompts you for login details.

Verification

1. On the Login screen, enter your user account credentials and click Enter.

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

   $ rpm-ostree status

   Copy to Clipboard Toggle word wrap

   The command output provides the image commit ID and shows that the installation is successful.

   The following is a sample output:

   State: idle
   Deployments:
   * ostree://edge:rhel/8/x86_64/edge
   		  Timestamp: 2020-09-18T20:06:54Z
   			Commit: 836e637095554e0b634a0a48ea05c75280519dd6576a392635e6fa7d4d5e96

   Copy to Clipboard Toggle word wrap